TYDRA(1)

📦 version 1.0.3, in nixos 26.05, nixpkgs unstable

💅 TYDRA(1) — manual page, but make it cute 💅

okay so this is the manual page for tydra, aka TYDRA(1), and we're on Version 1.0.2 — periodt. ✨

🌸 NAME 🌸

tydra — Shortcut menu-based task runner, inspired by Emacs Hydra. 💖

🦋 SYNOPSIS 🦋

tydra [-e|--ignore-exit-status] [-p NAME|--page NAME] <ACTION_FILE>
tydra [-p NAME|--page NAME] --validate <ACTION_FILE>
tydra --help
tydra --version
tydra --generate-completions <SHELL>

🎀 DESCRIPTION 🎀

Tydra is a menu-based shortcut runner based on the Hydra system in Emacs. no cap, that's the whole vibe. 💅

It works by reading an “action file” that defines the full menu. Each menu has several pages, where one page at a time can be shown. Each page has one or more entries, each of which has a shortcut key, a command, and a label. literally the building blocks of your shortcut kingdom. 👑

With these building blocks you can build deeply nested menus with a diverse range of commands, all behind a very simple shortcut system. it's giving infinite menu energy. 🌈

Contrast having to remember long commands (in terminal), or long complicated shortcuts (in GUI), with a single command/shortcut and then having a menu overlaid with each entry a single keystroke away. like, why memorize the whole dictionary when you can just open the cute little menu? 🫶

Tydra makes it easier to add new things to your setup without having to come up with a globally unique shortcut, while still being possible to remember it even when it is not used often. highkey iconic behavior. ✨

Some possible use-cases:

  • Control your media player. 🎵
  • Change your screen brightness and volume without RSI. ☀️🔊
  • Bookmark programs with specific arguments, or websites. 🔖
  • Keep track of commonly used “recipes” and scripts. 🍓

✨ OPTIONS ✨

  • -h, --help — Prints quick reference of options. your little cheat sheet, bestie. 🧚
  • -e, --ignore-exit-status — Do not exit Tydra when a command fails. she stays slaying even when a command fumbles. 💀
  • --validate — Instead of running the menu, exit with exit status 0 if the provided menu file is valid. If it is not valid, all validation errors will be shown on stderr and the program will exit with a non-zero status code. vibe check for your menu file, fr fr. 🔍
  • --version — Show the version of the process and exit. just the version, then she's out. 👋
  • -p NAME, --page NAME — Start on the page with the provided NAME. Defaults to root if not specified. Note that --validate will take this into account too. so yes, the vibe check cares about your starting page. 🫶
  • --generate-completions SHELL — Generate a completion script for the given SHELL, print it to standard out, and exit. This will ignore any other options. You can find a list of supported shells in the --help output. autocomplete fairy godmother behavior. 🧚✨

🌟 SEE ALSO 🌟

  • tydra-actions(5) — Reference for the action file format, including examples. the lore drop you need for action files. 📖

👑 AUTHORS 👑

Magnus Bergmark <magnus.bergmark@gmail.com>. 💌

okay bye bestie 💖 — this is TYDRA(1), Version 1.0.2, dated March 2020. slay responsibly. 🌸
📦 where this page comes from