xloem / qrstream

Split data across multiple QR codes on Android
53 stars 12 forks source link

NOTE: this application is no longer being actively developed. If you'd like to take it over, open an issue and I can give you access to this repo. A newer app with some more features that I didn't get quite published or polished, and is written in python instead of java, is https://github.com/xloem/TXQRApp

A simple Android application to transfer large blocks of data via successive QR codes. Sends the data in raw subsequent chunks using no additional protocol, to make it easy to improvise solutions and verify integrity.

License: Public Domain

Existing work: txqr -- https://github.com/divan/txqr https://github.com/ThePlasmaRailgun/TXQR-Android tagdrop -- https://github.com/mofosyne/tagdrop "Watch it & Got it" -- https://code.google.com/p/watchitgotit/ qrcodetransfer / "Jumping the Gap" -- https://github.com/VolumeLabs/qrcodetransfer file2qr-qr2file -- https://github.com/eandriol/file2qr-qr2file

== Using QRStream with the Linux terminal ==

Use zbarcam development sources to read from a webcam:

$ zbarcam --raw | iconv -f UTF-8 -t ISO-8859-1 |
while true; do
    dd bs=[blocksize+1] count=1 status=none | head -c -1
done > outputfile

where [blocksize+1] is one more than the block size QRStream is using, shown below the barcode. The extra byte needs to be read because zbarcam places a linebreak after every code. Ctrl-C to finish.

zbarcam v0.10 will not handle binary data correctly -- it terminates each code when it hits a nul character. This issue is resolved in the development sources.

Some webcams will require LD_PRELOAD=/usr/lib/libv4l/v4l2convert.so in the environment to work with zbarcam.

Use qrencode -8 to produce codes:

$ split inputfile -b 367 'Code #' -a 4 --numeric-suffixes=1 --filter='
    clear
    echo $FILE
    qrencode -8 -m 2 -t utf8
    read </dev/tty'

Increase the block size from 367 to enlarge the codes. Optimal values are in android/app/src/main/java/com/github/xloem/qrstream/QRCodeMetric.java . Press enter to advance the code. Ctrl-C to abort.

Use zint --binary with for example feh to show codes:

$ split inputfile -b 367 'Code #' -a 4 --numeric-suffixes=1 --filter='
    zint --binary -b 58 --border=2 -o "$FILE".png -i -'
$ feh -dZF --force-aliasing 'Code #'*.png
$ rm 'Code #'*.png

Increase the block size from 367 to enlarge the codes. Space or mousebutton to advance. Arrow keys to navigate. 'Q' to quit.

Although zint supports aztec codes, there is some bug with binary data when using them. The data becomes corrupt.