Skip to content

linksocks/linktransfer

Repository files navigation

GitHub Stars GitHub Actions Workflow Status Go Version Go Reference Go Report Card Docker Pulls License

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 simple 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.

Deploy to Cloudflare

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.

About

Linktransfer is a small CLI for sending files, folders, or text from one machine to another with a short code.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors