Skip to content(if available)orjump to list(if available)

Show HN: I built a CLI to automate depth tracking on underwater videos

Show HN: I built a CLI to automate depth tracking on underwater videos

3 comments

·February 4, 2025

Hey HN,

I built depthviz, an open-source CLI tool that generates depth & time overlay videos from dive logs. It supports dive computers (Garmin, Suunto, Shearwater, Apnealizer) and manual input for freedivers who want to enhance their footage with real-time dive data.

Why I Built It:

Adding dive data to videos manually is tedious. depthviz automates this by reading dive logs (.fit, .csv, .xml) from various sources, generating an overlay video with real-time depth, allowing full customization (fonts, colors, depth smoothing, stroke width), and running on Windows, macOS, and Linux.

How It Works:

Export a dive log from a dive computer or create a manual CSV. Run a single command. Then import the overlay into CapCut, Premiere Pro, DaVinci Resolve, etc.

Looking for Feedback On:

README – Is it clear, engaging, and well-structured? (Most wanted!) / Installation & Usability – Is the setup intuitive enough? / or Anything you'd expect from a tool like this?

GitHub: https://github.com/noppanut15/depthviz

Would love to hear your thoughts!

codeisawesome

The README is indeed clear, engaging and well-structured! The Screencap gifs are pretty helpful to immediately understand the scope of the project.

jboirazian

Amazing! Readme looks quite well. Not a diving guy TBH , but im sure people into that will find it quite useful.

noppanut15

Thank you so much! :)