Transfer files from Air gapped machines using QR codes
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore First commit Mar 25, 2016
LICENSE Initial commit Mar 25, 2016 Update Mar 25, 2016 Implement a context manager for QrReceive. Oct 10, 2016


Transfer files from Air gapped machines using QR codes


QRXfer is one of those "I had to give it a try" ideas. The basic idea is that it is possible to play back QR code encoded data to a receiver that may be able to reconstruct the data and reproduce the file that was originally sent.

Think about an airgapped machine being able to generate the QR codes, you recording it with your phone, and playing it back to the receiver later.

Silly, I know.

I tested 2 main scenarios.
The first was starting the listener on my laptop with the webcam, and the emitter on another pc (so 2 screens facing each other, not connected in any way). This method was the least error prone as both the sender and receiver were standing still.

The second was recording the emitter with my phone, and then placing my phone in front of the webcam with the receiver running. This was obviously much more error prone with me not being able to hold the phone still ;)


I used a Kali Rolling virtual machine with my laptops builtin Webcam added to the VMs hardware to build and test this.
Installation on Kali is relatively simple. QRXfer uses OpenCV python bindings and Zbar python bindings for most of the magic.

  1. Install click with pip install click
  2. Install opencv with apt-get install python-opencv
  3. Install zbar with apt-get install python-zbar
  4. git clone or just grab a copy of the script.


# python --help

  --help  Show this message and exit.




The below asciicast shows how to send a file using
The command used in this case was python send -s 20 -i /tmp/test_file:



The below asciicast shows how to receive a file using
The command used in this case was python receive -d incoming: