toggle(1)

toggle(1) 💖

okay so this is the General Commands Manual page for toggle(1), and she's here to toggle recording state. main character energy, no cap 💅

✨ NAME ✨

toggle — toggle recording state. that's the whole assignment, and she ate 💅

🌸 SYNOPSIS 🌸

toggle [--type] [--clipboard] [--paste] [--file] [--model] [--profile]
[--auto-submit] [--no-auto-submit] [--shift-enter-newlines]
[--no-shift-enter-newlines] [--no-osd] [--smart-auto-submit]
[--no-smart-auto-submit] [-h|--help]

🦋 DESCRIPTION 🦋

Toggle recording state. yes bestie, that's literally the plot: toggle toggles recording state. iconic behavior, honestly ✨

🎀 OPTIONS 🎀

okay here's every single flag, no skipping, no summarizing — we're listing all of them because the details are the moment 🫶

• --type — Override output mode to simulate keyboard typing. she's giving keyboard-typing realness for this one ⌨️✨
• --clipboard — Override output mode to clipboard only. transcription goes straight to the clipboard, that's the drop 🎀
• --paste — Override output mode to paste (clipboard + Ctrl+V). clipboard first, then Ctrl+V — the classic combo 💅
• --file [<FILE>] — Write transcription to a file. Use --file alone to use file_path from config, or --file=path.txt for explicit path. two paths, one flag, pick your fighter 🦋
• --model <MODEL> — Use a specific model for this transcription (e.g., large-v3-turbo).

highkey important lore: Any engine's model works, not just the configured engine's: the daemon loads it alongside the default model and keeps it loaded for the next override (unless on_demand_loading is set). Names are the ones voxtype info models shows; an unknown or undownloaded model fails immediately. so cute, so strict 💀

• --profile <NAME> — Use a named profile for post-processing (e.g., --profile slack). Profiles are defined in config.toml under [profiles.name] — slay 🌈
• --auto-submit — Auto-submit (press Enter) after this transcription. she hits Enter for you, no extra steps 🔥
• --no-auto-submit — Disable auto-submit for this transcription (overrides config). config said what it said, but this flag says not today 🙈
• --shift-enter-newlines — Use Shift+Enter for newlines in this transcription. newline behavior, but make it Shift+Enter ✨
• --no-shift-enter-newlines — Disable Shift+Enter newlines for this transcription (overrides config). same overrides-config energy, different newline vibe 💅
• --no-osd — Suppress the on-screen display for this recording only.

Leaves osd.enabled in config.toml untouched. Intended for external tools that draw their own dictation UI and do not want voxtype's overlay on top of it. respectful, temporary, not permanent 🫶

• --smart-auto-submit — Enable smart auto-submit for this recording (say "submit" to press Enter). you literally say "submit" and she presses Enter, iykyk 👑
• --no-smart-auto-submit — Disable smart auto-submit for this recording (overrides config). config can want it; this recording says no thank you 💅
• -h, --help — Print help (see a summary with '-h'). the full help is the moment, and the -h summary is right there too 🫶

okay that's the page, bestie — toggle, manual page toggle(1), and the footer just names toggle(1) again with no source/version/date content in this one, so that's the cute sign-off 🌈💖