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!