Awesome Open Source
Awesome Open Source

✨Transfer files over WiFi between your computer and your smartphone from the terminal✨


You will find the most updated version of qr-filetransfer here. But if you want the most stable version, use pip to install it

Pip Install

Global Install

pip3 install qr-filetransfer[extras]

Local Install

pip3 install --user qr-filetransfer[extras]

If you run into problems during the install, try removing the optional [extras] at the end of the command.

Git Install

# clone the repo
$ git clone

# change the working directory to qr-filetransfer
$ cd qr-filetransfer

# install the requirements
$ pip3 install -r requirements.txt


usage: qr-filetransfer [-h] [--debug] [--receive] [--port PORT]
                       [--ip_addr {}] [--auth AUTH]

Transfer files over WiFi between your computer and your smartphone from the

positional arguments:
  file_path             path that you want to transfer or store the received

optional arguments:
  -h, --help            show this help message and exit
  --debug, -d           show the encoded url.
  --receive, -r         enable upload mode, received file will be stored at
                        given path.
  --port PORT, -p PORT  use a custom port
  --ip_addr {}
                        specify IP address
  --auth AUTH           add authentication, format: username:password
  --no-force-download   Allow browser to handle the file processing instead of
                        forcing it to download.

Note: Both devices needs to be connected to the same network


To exit the program, just press CTRL+C.

Transfer a single file

$ qr-filetransfer /path/to/file.txt

Transfer a full directory. Note: the directory gets zipped before being transferred

$ qr-filetransfer /path/to/directory/

Receive/upload a file from your phone to your computer

$ qr-filetransfer -r /path/to/receive/file/to/


Inspired by the Go project qr-filetransfer


MIT License

Copyright © 2019 Siddharth Dushantha

Active contributer - Yu-Chen Lin

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (50,867
linux (2,333
macos (1,658
terminal (687
mobile (469
command-line-tool (279
wifi (186
qrcode (134
file-sharing (69
smartphone (29
transfer (28

Find Open Source By Browsing 7,000 Topics Across 59 Categories