JLTCTRIGGER(1)

📦 version 0.7.0, in nixos 26.05, nixpkgs unstable

💅 JLTCTRIGGER — like, the whole manual, bestie 💅

okay so first things first: this is a User Command page for jltctrigger, and it's lowkey one of those tiny tools that just does its job and slays while doing it. 🎀

✨ NAME ✨

jltctrigger — a JACK app to trigger actions on given LTC. that's it, that's the whole vibe. no cap. 🦋

🌸 SYNOPSIS 🌸

jltctrigger [ OPTIONS ] <cfg-file> ...

like, you give it options (optional, obviously) and then one or more config files, and it goes. periodt. 💅

💖 DESCRIPTION 💖

jltctrigger — JACK app to trigger actions on given LTC. fr fr, that's the description, we're keeping it exactly like that because that's literally what it does and honestly? iconic. 👑

✨ OPTIONS ✨

  • -c, --connect <port> — auto-connect to the given jack-port. it just... connects itself. main character energy 🫶
  • -f, --fps <num>[/den] — set the expected [initial] framerate. the default is 25/1, iykyk.
  • -F, --detectfps — autodetect the framerate from the LTC. let the tool figure it out for you, no thoughts head empty 🌈
  • -h, --help — display this help and exit. classic. 💜
  • -p, --print — output decoded LTC (live). watching it in real time, obsessed 😭
  • -v, --verbose — be verbose. like, tell me everything, bestie. 💀
  • -V, --version — print version information and exit. quick lil flex 🎀

🎀 the config file situation 🎀

Actions are defined in a config file, one per line, and the format goes literally like this:

Timecode <Space> Command
bestie, mind the <Space> — that's a real space character sitting between the timecode and the command, she's doing her job 💅

Multiple config files can be given. 👯‍♀️

The fps parameter is used when parsing the config file, ... The fps option is also used properly track the first LTC frame, and 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. 🌸

lowkey important: that decoder needs a couple samples before it's locked on, so if you already know the fps, just tell it and skip the awkward small talk phase. 🦋

😭 REPORTING BUGS 😭

Report bugs to Robin Gareus <robin@gareus.org> 📧

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

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

and that's the page!! 🌟 this was jltctrigger version 0.7.0, dated February 2019, in the User Commands section — written by Robin Gareus, presented to you by me, your resident Unix bestie. mwah. 🎀💖✨🦋

📦 where this page comes from