qr-filetransfer
Transfer files over WiFi between your computer and smartphone via QR codes from the terminal.
What is qr-filetransfer?
qr-filetransfer is a Python-based command-line utility that facilitates wireless file transfers between a computer and a smartphone using QR codes. It creates a local web server on the computer, generates a QR code with the server's URL, and allows the phone to connect via a web browser to download or upload files over the same WiFi network.
Developers and tech-savvy users who frequently need to transfer files between their computer and phone without relying on cloud services, USB cables, or email attachments.
It offers a fast, offline, and secure method for local file transfers with a simple terminal interface, eliminating dependency on external apps or internet connectivity while supporting both file and directory transfers.
Overview
Transfer files over WiFi between your computer and your smartphone from the terminal
Use Cases
Best For
- Quickly sending a configuration file from a development machine to a mobile device
- Transferring photos or videos from a phone to a computer without cables
- Sharing log files or debug data between devices on the same local network
- Distributing small build artifacts or documents during development
- Backing up mobile files to a computer without cloud storage
- Transferring directories (as zip files) between platforms seamlessly
Not Ideal For
- Transferring large files or batch operations where speed and automation are critical, as each transfer requires manual QR code scanning and relies on local network performance.
- Scenarios where devices are on different networks (e.g., computer on WiFi, phone on cellular data), since it mandates a shared local WiFi connection.
- Users who prefer graphical interfaces or need seamless integration into automated workflows, as it's command-line only and lacks scheduling or API support.
Pros & Cons
Pros
Generates a scannable QR code that links to a local web server, eliminating the need to manually type URLs or IP addresses, as shown in the usage examples and GIF demonstration.
Supports both sending files from computer to phone and receiving files from phone to computer using the --receive flag, enabling versatile transfer options without additional tools.
Automatically zips entire directories before transfer, simplifying the process of sending multiple files or folders, as noted in the usage instructions for directory paths.
Works on Linux, macOS, and Windows with pip installation, ensuring broad compatibility across different operating systems, as highlighted in the support badges and installation steps.
Cons
Requires both devices to be on the same WiFi network, which restricts use to local environments and prevents transfers over the internet or between disparate networks.
Each transfer necessitates generating and scanning a new QR code, making it inefficient for repeated or bulk file operations compared to automated syncing tools.
Installation can be problematic, as noted in the README with optional extras causing errors, and it relies on a Python environment that may require troubleshooting on some systems.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.