A tool watching and navigating Jiu Jitsu instructionals.
- Scene detection
- Scene title recognition (OCR)
- Download scene info (title & timestamps) from BJJ Fanatics
- Load / Save instructional information in org-mode format
- Generate m3u playlist
- Playback
- Customization
- Timestamps
- OCR preprocessing
Jiu Jitsu instructionals can exceed 10 hours in duration that are usually spread from 5 to 8 video files on avarage and may contains hundrends of scenes/topics. For the obvious reasons, they cannot be watched in one go. Instead it's preferable to watch them in chunks and ideally itersperse training sessions between viewings.
So, getting back to a particular topic, is not trivial. It should be!
This tool splits instructionals into pieces and makes it easier for you to find what you are looking for.
A couple of months ago I started writing a series of blog posts called Hackers Guide to Jiu Jitsu
that discussed about tools, scripts and tips for getting the most out of
instructionals. While shell scripts work, they lack visualization and are hard to tune. A graphical user interface solves both problems.
If you are interested in the posts that I've written so far:
-
- Hackers guide to Jiu Jitsu: intro wordpress version github version
-
- Hackers guide to Jiu Jitsu: ffmpeg wordpress version github version
-
- Hackers guide to Jiu Jitsu: mplayer wordpress version github version
-
- Hackers guide to Jiu Jitsu: markdown wiki wordpress version github version
-
- Hackers guide to Jiu Jitsu: flowcharts wordpress version github version
There are multiple ways to run the application. Due to the large number of dependencies which is a bit tricky to get right, it's recommended to run hg2jj
as a docker container.
Still, you can build it locally and run it as a desktop applicatin.
The easiest way to run hg2jj
is using docker. A helper script has been provided to run the container with all required parameters.
./scripts/run-in-docker.sh
- docker
No ready binaries are provided. To build it locally you are going to need rust
version 1.61
or higher and also supporting software and libraries.
- ffmpeg
- mpv
- opencv
- tesseract
cargo build --release
./target/release/hg2jj
The application needs to run from it's folder, in order to load the required assets.