qrcp Claudio d'Angelis

Use this command to install qrcp:

winget install --id=claudiodangelis.qrcp -e

qrcp is a command-line tool designed to transfer files over Wi-Fi between devices by scanning a QR code directly from the terminal. It simplifies file sharing without requiring additional apps or leaving the command line.

Key Features:

Transfer files instantly by generating and scanning a QR code.
Send multiple files or folders, automatically creating a zip archive for transfers.
Secure file transfers using HTTPS with customizable TLS certificates.
Configure network interfaces, ports, and output directories via command-line flags or a YAML configuration file.
Receive files directly from mobile devices through an upload page served by qrcp.

Audience & Benefit: Ideal for developers, IT professionals, and anyone needing seamless file transfers between devices. qrcp provides a fast, secure, and terminal-centric solution for sharing files without leaving the command line. It supports both sending and receiving files while maintaining flexibility through configurable settings.

README

$ qrcp

Transfer files over Wi-Fi from your computer to a mobile device by scanning a QR code without leaving the terminal.

You can support development by donating with .

Join the Telegram channel qrcp_dev or the @qrcp_dev Twitter account for news about the development.

How does it work?

Screenshot

qrcp binds a web server to the address of your Wi-Fi network interface on a random port and creates a handler for it. The default handler serves the content and exits the program when the transfer is complete. When used to receive files, qrcp serves an upload page and handles the transfer.

The tool prints a QR code that encodes the text:

http://{address}:{port}/{random_path}

Most QR apps can detect URLs in decoded text and act accordingly (i.e., open the decoded URL with the default browser), so when the QR code is scanned, the content will begin downloading by the mobile browser.

Demo

Send files to mobile:

screenshot

Receive files from mobile:

Screenshot

Installation

Using Go (Latest Development Version)

Requires Go 1.18 or later:

go install github.com/claudiodangelis/qrcp@latest

Prebuilt Binaries

Download the latest release for your platform from the Releases page.

Platform	Instructions
Linux	Extract the `.tar.gz` archive, move the binary to , and set permissions.

Platform	Package Manager	Command
Linux	ArchLinux (AUR)	`yay -S qrcp-bin` or `yay -S qrcp`
Linux	Debian/Ubuntu	`sudo dpkg -i qrcp__linux_x86_64.deb`
Linux	CentOS/Fedora	`sudo rpm -i qrcp__linux_x86_64.rpm`
Windows	WinGet	`winget install --id=claudiodangelis.qrcp -e`
Windows	Scoop	`scoop install qrcp`
Windows	Chocolatey	`choco install qrcp`
macOS	Homebrew	`brew install qrcp`

Action	Command Example
Send a file	`qrcp MyDocument.pdf`
Send multiple files	`qrcp MyDocument.pdf IMG0001.jpg`
Send a folder	`qrcp Documents/`
Zip before transferring	`qrcp --zip LongVideo.avi`

Action	Command Example
Receive to current directory	`qrcp receive`
Receive to a specific directory	`qrcp receive --output=/tmp/dir`

Key	Type	Description
`interface`	String	Network interface to bind the web server to. Use `any` to bind to `0.0.0.0`.
`bind`	String	Address to bind the web server to. Overrides `interface`.
`port`	Integer	Port to use. Defaults to a random port.
`path`	String	Path to use in the URL. Defaults to a random string.
`output`	String	Default directory to receive files. Defaults to the current working directory.
`fqdn`	String	Fully qualified domain name to use in the URL instead of the IP address.
`keep-alive`	Bool	Keep the server alive after transferring files. Defaults to `false`.
`secure`	Bool	Use HTTPS instead of HTTP. Defaults to `false`.
`tls-cert`	String	Path to the TLS certificate. Used only when `secure: true`.
`tls-key`	String	Path to the TLS key. Used only when `secure: true`.

Shell	Command Example
Bash	`source <(qrcp completion bash)`
Zsh	`qrcp completion zsh > "${fpath[1]}/_qrcp"`
Fish	`qrcp completion fish

qrcp Claudio d'Angelis

README

$ qrcp

How does it work?

Demo

Installation

Using Go (Latest Development Version)

Prebuilt Binaries

Package Managers

Confirm Installation

Usage

Send Files

Receive Files

Configuration

Configuration File

Configuration Options

Environment Variables

Advanced Usage

Network Interface

HTTPS

Shell Completion

Authors and Credits

Clones and Similar Projects

License

Project Name	Description
qr-fileshare	A similar idea executed in NodeJS with a React interface.
instant-file-transfer (Uncredited)	Node.js project similar to this.
qr-filetransfer	Python clone of this project.
qr-filetransfer	Another Node.js clone of this project.
qr-transfer-node	Another Node.js clone of this project.
QRDELIVER	Node.js project similar to this.
qrfile	Transfer files by scanning a QR code.
quick-transfer	Node.js clone of this project.
share-file-qr	Python re-implementation of this project.
share-files (Uncredited)	Yet another Node.js clone of this project.
ezshare	Another Node.js two-way file sharing tool supporting folders and multiple files.
local_file_share	"Share local file to other people, OR smartphone download files which is in PC."
qrcp	A desktop app clone of `qrcp`, written with C# and .NET Core, works for Windows.
swift_file	Rust project inspired by `qrcp`.
qrcp-android	Android app inspired by `qrcp`.