Robert Helling helling at
Fri Dec 4 13:23:30 PST 2020


yesterday, we merged the Subsurface downloader branch and I would like to hear peoples comments and suggestions for improvement.

So what is it?

Subsurface downloader is a command line version of Subsurface that can read a local git repository, download dives from a dive computer and add those to the repository. In addition, there is a web interface (in terms of a CGI script) to drive it.

What is the intended use?

The iOS-Version of Subsurface in particular can only talk to Bluetooth LE devices, in particular there is not much hope to ever directly speak to dive computers over USB. I don’t know what is the situation with Android, also there accessing USB dive computers might be difficult given some security settings. In this case, you could get a Raspberry Pi and install the Subsurface downloader. You could tether the RPi to your phone and via the web interface make the RPi download your dives from the dive computer and upload them to your Subsurface Cloud logbook. And then add additional data via Subsurface-mobile on your phone. This would even work in remote locations where your only internet connection is via your phone.

What is the current status?

Works for me(™). But it’s not end user ready, yet. In ./subsurface/packaging/headless/Setting-up-downloader you will find (hopefully complete and I did not miss any step) instructions starting from a RPi and an empty SD card to build Subsurface downloader (this takes quite a while) and set up the web interface. The web interface and error reporting are still minimal and (as the installation process) on mass market compatible, yet.

Please give it a try and let me know what you think. Any ideas for improvement welcome!

I am really happy, this is now in a somewhat presentable state after the idea for this has been dormant for several years. The essential step was Dirk laying the foundations and recognising that tethering to the phone is enough to make this work (while I had thought it would need to work as a wifi access point and I got lost in getting that to work).


PS: Of course, nothing is really Raspberry Pi dependent. Also works on my Mac and any Linux system. Above instructions are written relative to a Debian based system.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: Message signed with OpenPGP
URL: <>

More information about the subsurface mailing list