blastQR: send files completely offline over QR codes. Up to 1.4 MB/s
https://codeberg.org/blast/blastqr
Hello! I’ve been working on blastQR for a couple of years now and I thought this community might find it useful. Feel free to try it and ask me anything!
blastQR is a fully open-source file transfer app and protocol that works completely offline. You can even use it in airplane mode. Data is transferred through sequences of QR codes displayed on a sender device and scanned by a receiver device’s camera. It uses RaptorQ codes so the receiver can recover the file from any sufficiently large subset of frames.
Note that although I have made use of AI as a coding assistant I do not consider this to be a vibe-coded app and I do plan to continue improving it and supporting it in the future.
See video of blastQR in action: https://github.com/user-attachments/assets/038a2567-70c8-47c8-b165-dea858d1aef3
Here are some of the key features:
- Works fully offline: No internet, Wi-Fi, Bluetooth or servers. Your data stays offline.
- One-to-many distribution: Share the same file with multiple devices simultaneously using a single blastQR broadcast.
- Cross-platform: Android, iOS, macOS, Linux and Windows, plus a command-line tool that can send from a terminal, even over SSH.
- Password encryption: You can optionally encrypt files with an auto-generated password or a custom one.
- Media compression: The app supports lossy image compression and video transcoding for quicker transfers.
- Multiple codes on screen: Shows multiple QR codes at once for higher speed. With 8 codes at 60 fps, transfers peak at around 1.4 MB/s.
- Send multiple files in one go: They’re zipped into one transfer and unpacked into separate files on the receiver.
- Sound feedback: The receiver plays a short tone when it has the whole file, and the sender stops automatically when it hears it.
- Start scanning at any point: No need to catch every code, just keep the camera on the screen until it’s done. Blurry or missed codes don’t matter.
- Regular QR scanner: You can also scan normal QR codes and save them.
- Open protocol that other apps can implement
- Built-in file manager
I’m trying to build a small community around the project so it can be improved and maintained and so it can reach more people in the future.
Downloads for all platforms can be found here: https://codeberg.org/blast/blastqr/releases/latest
Comments
Apparently codeberg is anti AI now. Good luck. I’m moving elsewhere.
https://xkcd.com/949/
So a fun use case you may not have considered is back country GPX sharing. A plugin for Osmand (a very popular FOSS mapping app for back country use) would be neat. Sharing when airplane mode between devices is always needed.
That is a fenomenal idea! I hadn’t thought about it and these are the exact kind of situations it could solve well. I’ll definitely add it to the roadmap. Thank you
A very interesting take on a new malware distribution method.
Is this the future version of holding two phones together to transmit files via infrared?
Coming full circle!
Can you elaborate more on how AI was used?
For context, I’m a software developer with around 15 years of experience. Most of it writing Android and iOS apps in Java, Kotlin, Swift and lately Dart (Flutter) + Rust which is what this project is written in.
Although I did start the project from scratch I have lately been using Claude Code as a coding assistant. I write code myself but I also let it write or refactor parts of it. The CLI tool is the part that Claude has mostly written from scratch because it’s not something I had experience in writing before. That being said I also review all the code that Claude writes.
Thanks for asking! there’s also some disclosure about this in the readme file
Thanks for being honest and open about it
This seems like the perfect opportunity to learn something new in my opinion, CLIs aren’t difficult to make. And you may want to consider moving to GitHub because of Codeberg’s ToS.
I totally agree and I’m very open to welcome anyone who wants to rewrite that part or I might go for it myself in the future. The reason I went for it is that I really wanted to be able to use the CLI tool right away and the AI produced a good result so I left it in the project for now.
About Codeberg I did read their blog post and I didn’t think my project falls into any of the cases they mention:
spoiler
Projects that are created by LLM “agents” in autonomous ways Projects written and maintained with heavy use of LLMs Projects where the amount of resources (e.g. storage, CI/CD) is significantly larger than what the involved amount of people could have created by hand Projects heavily tied to the LLM ecosystem, e.g. LLM-written tools to ease LLM usage Users sending LLM contributions in violation of project’s custom policies
If they ever consider it infringing their ToS I could move it to GitHub where there’s already a mirror of the repo.
I wonder if this can be arranged with two bidirectional telescopes (or maybe two telescope and 2 projectors on walls:how many qr-codes you can stuff on a square meter to be seen in long distance?) for some sort of wifi; not for a good ping but some sort of cheap/quick wireless connectivity
Visible light communication over free air is something that has been studied for decades but usually it’s 1D (i.e. tranmit a single signal instead of a 2D QR code) because cameras are slow. You can theoretically get absurdly high data rates, potentially TbPS. I actually did that for my engineering capstone project🙂
this paper (by us military 🤮) actually talks about something very similar: https://www.sciencedirect.com/science/article/abs/pii/S0030401826004906
that sounds like a really fun experiment! the protocol would need some tweaking to be able to continuously stream data. other than that it would probably work fine if the image is clear enough!
I’VE BEEN THINKING OF THIS SO LONG.
I’m so happy somebody finally did it.
Does this mean an IP cam pointing to a monitor can compromise an air gap? I guess it always could, just at 1.4mbps now
I believe IP cameras usually can’t reach fidelity and frame rate needed for 1.4 mb/s
And yes, programs like this existed, so it always could
I’ve been enjoying this
https://github.com/sz3/libcimbar
This is a great idea! I’ll be using this to transfer files between my work computer and my phone, which today is very cumbersome due to the enterprise firewall. What I do today is upload a file to an email draft and open the draft on the phone. Maybe instead of pure files there could be a clipboard mode as well? I’ll create a Gentoo package for the CLI.
Thank you! That is actually a very good use case and it should work well for it. Let me know if you run into any problems. The clipboard mode idea sounds interesting too. How do you imagine it would work?
In the cli you can already do something like this to send the clipboard contents:
wl-paste | blastqrthe command might be something different for your system though. wl-paste is the wayland version
This seems like re-inventing the IR Blasters we had on our laptops and phones in 2005 (think some game handhelds also)
Wasn’t that like 500 B/s? That’s ok for pressing play or stop, but 1.4 MB/s is actually useful for lots of stuff.
Since you advertise it for Obtainium, would you mind adding the key for verification with AppVerifier? I didn’t find it in the readme and release.
Thank you for the suggestion!
dev.blastapps.blastqr 60:E3:A6:C0:63:1D:C3:A0:0C:78:E4:C9:E4:89:B3:03:4F:A9:7D:49:D0:B9:3E:CF:56:B2:33:A8:C3:DD:F6:83it’s been added to the readme as well.
Dope, thank you very much!
Two more questions: Is there a way to set 8 codes for sending in the flatpak version, or is that limited to 6? Any idea why a pixel 8 pro on graphene wouldn’t allow 120/240 fps receiving? Highest I’ve been able to choose and test is 60fps. was thinking that it may be the resolution cap, but an iPhone comparison ran at 240fps with the same res (I think).
The app is limited to 6 right now but I’ll work on increasing it! The CLI tool does allows up to 12. Make sure you use Ghostty or Kitty for high frame rates if you do decide to try it.
A lot of phones cap the camera preview at 30fps actually so 60fps is quite good already. From the devices I tested only the iPhone let me select 60,120,240. You can see some benchmarks here: https://codeberg.org/blast/blastqr#real-world-benchmarks I don’t think you are missing out on performance if you can scan at 60fps. I recall at 120 the cpu was starting to be the bottleneck but I’ll have to do some more testing to confirm.
Yeah, thanks for the input. i did realise that the iPhone too performs best at 60FPS actually(anecdotally).
This is truly a cool project. thanks for your work!
Thank you very much! just made an update and the desktop version can show up to 15 codes now.
Isn’t app verifier a dead project?
I started working on something like this years ago, but I didn’t have the coding skills to pull it off. This is really awesome.
Super cool! I could totally see this being an integral plot point in a show or movie. Crowds of people suddenly aiming their phones at the screens in Times Square to get the latest elicit data dump or some such 😎
Thanks for all the hard work, I can’t wait to play around with it!
*illicit
Word. Never been great at spelling —or even good 😌
Reminds of removedat, odd but apparently used in india because their goverment is lowkey evil again?
Bit chat got Scunthorped
An interesting name _removed_at is /j
Luigi Mangione did everything for society correctly (its bit chat fyi not a swear in the name)
Whats the advantage over bluetooth, local ftp serverr/hotspot and other wifi sharing methods?
The advantage is it doesn’t need any of those
Yeah this is kind of obvious. I am still wondering in which scenario this becomes relevant that there is no blutooth available or some other wifi hotspot connection.
or is this some hypothetical prepper scenario? you are in a war trench and dont want to activate wifi or bluetooth so the enemy can spot you?😂
Dont take me wrong, this is a serious question. If somebody invest time to develop an app, there is probably a found reason behind it. But I have not fully understood the use case of it.
Is that an advantage?
It works fully offline without any mechanical or physical contact. Niche, but cool nonetheless.
same with wifi or bluetooth
What if you only have a camera?
The software is for linux, android, macos, ios… which of the following systems have just a camera?
then it also needs to be released for sony, nikon dslrs…
edit: ahh just screen makes sense
Or a screen.
Doesn’t require pairing or authentication, just any video medium. Think signage: at concerts, billboards, tv or other video feeds. Can transmit data over long distances, doesn’t require any energy. It’s a low barrier method to broadcast data.
Dude, i just tried it with my 2 phones. Awesome.
What was your testing environment?
First thing I thought about is how well smartphone can handle it. After fps mismatch that you contributed on, there is also cameras matrix’ resolution, probable obstacles and image distortion.
After that, I’m interested in how able a smartphone to scan a max res QR like in the OP gif. Or eight of them. 25 times a second, with a CPU overhead of error correction algorhitm. I know modern phones are beasts, but basic apps I used struggled with QRs that vere too busy, and even if not, they still took a second before popping up a link.
Btw, do you use standard QR by specs, or a custom 2d encoding method? I don’t see rectangular orientation marks on your images, so it’s something new. Since you are not sticking to QRs, have you thought of using colors, since your usecase is capturing color displays?
You bring up great points!
Here are some benchmarks including videos (Note that these are best case conditions but should be achievable): https://codeberg.org/blast/blastqr#real-world-benchmarks
Most of the testing I did with my now 7 years old Galaxy S10e. It only scans at 30FPS but it can handle 6 codes at once which is a pretty decent 420 kB/s. During testing on the iPhone 17 which can scan at 60 or 120fps I think the CPU did not become the bottleneck until around 8 codes at more than 90fps. That is something I still need to test and document more thoroughly though.
I do use standard QR codes. By default Version 40 which can store almost 3 KB. It is configurable in the app’s settings.
Regarding color, libcimbar (https://github.com/sz3/libcimbar) is a project that does exactly that although the speeds are not quite as high yet. Additionally, one of the cpu optimizations in blastQR (and qr scanners in general) is to drop color so that each frame that gets copied in memory is smaller. It makes a difference when you’re processing at high fps.
That’s a very clever idea - good job! I am aware of Luby Transform and Raptor codes but not RaptorQ codes - that’ll make for some interesting reading later.
I particularly like the idea of visual filesharing with no network transmission that could be intercepted - although a determined nation-state actor would just compromise hardware & OSes instead. For ultra-private comms there’s also Van Eck phreaking to consider, but we’re going a bit too deep down the rabbit hole here!
Very cool project. If you’re going to patent it or publish a paper on the subject, don’t wait too long.
Magic Wormhole comes to mind.
P2P or back to the paleolytic Finger Protocol
Write in your command line
finger zerush@happynetbox.comwhy its faster than my actual upload speed
A couple of months ago I searched for a tool like this, there are a few but all with some flaws: the most polished one did not cycle the codes, the most usable one failed to initiate file download from web UI they had. Have you researched existing implementations?
Also, maybe an app is better for stability, but have you thought about having a web UI, too, so that one can use it to receive or send the file (the page itself would be pretty lightweight, considering it doesn’t send or receive the data itself)? Such a UI could also be served from localhost
Yes, over the years I’ve tried many solutions. The latest popular one being Decimen and others mentioned in the readme.
Since it seems you are interested in the field I’d be very happy if you tried it and told me how it compares to the rest. blastQR is still a work in progress so any feedback would be very helpful!
A web UI is also possible. I’m not working on it right now but it’s something the project should support in the future.
Dammit you beat me to it especially if you make it nfc capable too. Wink wink hint hint
Snow Crash here we come!
J/k, cool idea.
Have you considered an RGB mode?
They’ve answered that here now, fyi https://lemmy.dbzer0.com/comment/29305229
Sign in to comment. Sign in