linktransfer

README

Linktransfer

Linktransfer is a CLI tool for sending files, folders, or text between two machines using a short code.

中文文档 / Chinese README

Features

1. Send and receive with a single command — no server setup required.
2. Nearly unlimited traffic with high speed.
3. Resumable transfers — interrupted uploads and downloads pick up where they left off.
4. Automatic NAT traversal on LAN — seamless local network transfers.
5. Self-hostable relay server via linksocks.js, deployable on Cloudflare.
6. Written in Go — lightweight, fast, and cross-platform.

Quick Start

Send a file

# Sender side: pick a file to send
lt send ./path/to/file

# The terminal prints a receive command, e.g.:
#   lt recv 2f4e8c1d4a9b7c10

# Receiver side: run the command printed above
lt recv 2f4e8c1d4a9b7c10

Send text

# Sender side
lt send --text "hello from linktransfer"

# Receiver side
lt recv <code>

Use a self-hosted server

# Sender side
lt send ./file --url ws://your-server:8765

# Receiver side
lt recv <code> --url ws://your-server:8765

Installation

Golang Version

go install github.com/linksocks/linktransfer/cmd/lt@latest

Or download pre-built binaries from releases page.

Docker

# Send a file
docker run --rm -i jackzzs/linktransfer send ./file

# Receive a file
docker run --rm -i jackzzs/linktransfer recv <code>

Self-Hosting the Server

By default, linktransfer connects to the public linksocks service at ws://l.zetx.tech. You can deploy your own relay server for full control over the transfer channel.

linksocks.js is a lightweight relay server that can be deployed on Cloudflare Worker.

Once deployed, point both sides to your server with --url:

lt send ./file --url ws://your-server:8765 --token your_secret_token
lt recv <code> --url ws://your-server:8765 --token your_secret_token

See the linksocks documentation for more options.

License

Linktransfer is open source under the MIT license.