osd(1)

🎀 NAME 🎀

okay so hi bestie, welcome to osd(1) from the General Commands Manual — yes, the manual name is folded right in here, we're doing this cute. This lil utility is osd, and she's here to apply or list OSD recipe presets. Slay.

✨ SYNOPSIS ✨

osd [--recipe] [--list] [--dry-run] [-h|--help]

🌸 DESCRIPTION 🌸

Apply or list OSD recipe presets — that's the whole job, fr fr.

A recipe is a complete [osd] preset: layout, frame, and [[osd.visual.layers]] — it's giving full preset energy, not just a lil accessory. 👑

Applying one writes its keys into config.toml through the same editor as voxtype config set. The way that works: keys the recipe sets replace the existing ones (never duplicated), [osd] keys it doesn't set are kept, comments are preserved, and the result is validated before it is written. Every changed key is printed with its previous value. Validation before writing? Obsessed. 💅

Recipes are looked up in ~/.config/voxtype/osd-recipes, ~/.local/share/voxtype/osd-recipes, then /usr/share/voxtype/osd-recipes; a user copy shadows a shipped one. So yes, your personal copy wins — main character energy.

With no --recipe name, it lists the available recipes. Easy.

Examples, bestie — copy these exactly:

voxtype setup osd --list
voxtype setup osd --recipe showcase-bars --dry-run
voxtype setup osd --recipe showcase-bars
voxtype setup osd --recipe ./my-recipe.toml

💅 OPTIONS 💅

• --recipe [<NAME>] — Recipe name from --list, or a path to a recipe .toml file. Name or path, she's flexible.
• --list — List available recipes. Vibe check the menu first.
• --dry-run — Show what would change without writing config.toml. Preview era, no commitment.
• -h, --help — Print help (see a summary with '-h'). Helpful icon behavior.

💖 That's the tea, bestie — the footer gives us source/version osd and manual tag osd(1), with no date printed, so here's your cute sign-off: stay slay, validate before you write, and may your [osd] keys never duplicate. Periodt. Mwah! 💅✨