QR File Transfer¶
qrtransfer shares files, directories, or text snippets over your local network with a scannable QR code printed in the terminal. Scan it with your phone's camera and the download starts immediately — no cloud, no accounts, no uploads to a third party.
It also works in reverse: qrtransfer receive prints a QR code that opens a page
where your phone can upload files straight to your computer.
Quick start¶
pip install qrtransfer-lite
qrtransfer myphoto.jpg
Scan the printed QR code with your phone — the file downloads and the session ends
after the first download. Press Enter or Ctrl+C to stop early.
What it can do¶
- Send files, whole directories (auto-zipped), or text snippets.
- Receive files from your phone with drag-and-drop upload.
- Password protection (
?passed=or theX-Passwordheader) and link expiration. - Download counting, interface/port memory, and a transfer history.
- Optional self-signed TLS and IPv6 support.
Continue reading¶
| Page | Purpose |
|---|---|
| Getting Started | Your first transfers, end to end |
| Installation | pip, extras, and installing from source |
| Usage | Everyday examples for Linux/macOS, cmd, and PowerShell |
| CLI Reference | Every command, option, and exit code |
| Library API | Using qrtransfer as a Python library |
| Configuration | Config file, history, and TLS cache locations |
| Architecture | How the server, session, and auth flow work |
| Deployment | Long-running setups, Docker, and this docs site |
| FAQ | Common questions |
| Troubleshooting | Solving common problems |
| Development | Contributing, tests, and releases |
| Screenshots | Screenshots of the send/receive pages |
License¶
MIT — see the repository LICENSE.