Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time

PyPI version


Deepblu API tools

A set of tools to get the most out of Deepblu.

Deepblu Backup Tool

Retrieves dive logs from Deepblu and exports them in Universal Dive Data Format (UDDF), which can be imported into other applications that support it, including Subsurface Divelog.

Diving Log, a commercial dive log application for Windows, based its Deepblu import tool on this project.

Deepblu logs imported into Subsurface


Make sure you have Python 3 and pip3 installed


pip3 install deepblu-tools


Usage: deepblu-backup [OPTIONS]

  -u, --user TEXT         Deepblu username or userid
  -p, --password TEXT     Deepblu password
  -m, --max-logs INTEGER  Maximum number of logs to parse
  -d, --with-drafts       Also pull draft logs. Requires valid
  -o, --outfile TEXT      Write results to this file
  -f, --infile TEXT       For debugging purposes: load data
                          from JSON file instead of API
  --help                  Show this message and exit.


  • run deepblu-backup -u userId to backup all your public logs without personal user information (or if you have no password, e.g. if you created your account using Facebook)
  • run deepblu_backup -u email -p password to backup all your private and public logs with personal user information
  • add --with-drafts to include drafts (you will need to use email and password)
  • add --max-logs MAX to limit the number of logs to the most recent number represented by MAX
  • add --outfile FILENAME to write the resulting UDDF file to FILENAME

Alternatively, you can use the Deepblu Backup Tool web service

in the above commands, make sure you replace email and password with the information associated with your deepblu account, and note that userId is not your username but the id as found in the URL when visiting your own profile at Deepblu.

Tracked data

  • Dive type: Freediving (apnea) or Scuba (open circuit)
  • Dive profile: Deepblu provides a waypoint with temperature and depth every 20 seconds
  • Date and time, visibility, average depth, maximum depth, minimum temperature, dive duration, air temperature
  • Media: url, captions and timestamps of video and images
  • Tank: volume, gas, pressure at start and end
  • Dive computer brand and model
  • Diver details
  • Buddies
  • Divespot: name, latitude and longitude
  • Divebase: name
  • Notes

Known issues

  • Not all data is currently being backed up (some equipment data isn't). I may add more items in the future.

Deepblu Autoliker - extra/

Logs you in with a set of accounts defined in LOGINS and automatically likes every post, beginning with the most recent one, until MAX_LIKES is reached or an earlier like is found.

Deepblu Autofollow - extra/autofollow.js

Console JS script to automatically add a series of Deepblu users in userIds to the following list of a logged-in account with token authToken.


Get the most out of Deepblu, export and backup your dive logs into UDDF format, automatically like posts, and copy another user's followers.







No packages published