JLTCDUMP(1)

📦 version 0.7.0, in nixos 26.05, nixpkgs unstable

💅 JLTCDUMP — yeah okay bestie, this is the jltcdump(1) page, buckle up 🎀

✨ NAME ✨

jltcdump — a JACK LTC decoder, fr fr. That's the whole vibe.

🌸 SYNOPSIS 🌸

jltcdump [ OPTIONS ] [ JACK-PORTS ]

🦋 DESCRIPTION 🦋

Okay so jltcdump is a JACK app, and what it does is parse linear time code. That's it, that's the plot. Lowkey iconic.

💖 OPTIONS 💖

  • -f, --fps <num>[/den] — sets the expected [initial] framerate (default 25/1). The brackets around "initial" are the manpage's, not mine, so don't come for me 🙈
  • -F, --detectfps — autodetects the framerate from the LTC itself. Let the timecode tell you who it is ✨
  • -H <alpha> — honestly? The manpage just shows <alpha> and nothing else. No description. That's all we got 💀
  • --highpass <alpha> — sets the R/S highpass filter coefficient (dflt 0.6)
  • -h, --help — displays this help and exits. Classic, we love a polite exit 🫶
  • -o, --output <path> — write to file(s) 📝
  • -s, --signals — start/stop the parser using SIGUSR1/SIGUSR2
  • -r, --runstop — parse the R/S signal on the 2nd channel
  • -R <float>, --rsthreshold <float> — R/S signal threshold (default 0.01)
  • -V, --version — print version information and exit 👑

🧚 the fine print (still inside OPTIONS, bestie) 🧚

If both -s and -o are given, then <path> is used as a prefix: the filename will be <path>YYMMDD-HHMMSS.tme.XXXXX.

If only -o is set, <path> is the filename. Simple as that.

In 'signal' mode, the application starts in the 'idle' state and won't record LTC until it receives SIGUSR1. So it's literally just sitting there, waiting for permission. Respect.

The fps option is only needed to properly track the first LTC frame, and for timecode discontinuity notification. The LTC-decoder detects and tracks the speed, but it takes a few samples to establish initial synchronization. Setting fps to the expected fps speeds up the initial sync process. The default is 25/1.

So yeah — you can skip -f and let it figure itself out, but it's gonna need a few samples to lock on. Giving it the fps upfront is giving main character efficiency 🦋

😭 REPORTING BUGS 😭

Report bugs to Robin Gareus <robin@gareus.org> — be nice, be specific, include the deets 💌

Website and manual: <https://github.com/x42/ltc-tools>

Copyright © GPL 2006,2012 Robin Gareus <robin@gareus.org>

okay that's the whole page, you ate that 🍓 stay hydrated, go decode some timecode, and remember: jltcdump version 0.7.0, February 2019 — written down here with love, periodt 💜

📦 where this page comes from