tomat-status(1)

🍅 NAME

okay so welcome to tomat-status(1), bestie — this page is literally about status, and status gets your current timer status. That's the whole name vibe: status — get current timer status ✨

✨ SYNOPSIS

status [-o|--output] [-f|--format] [-h|--help]

💖 DESCRIPTION

status displays the current timer status. You can customize the output format for different status bars (waybar, i3tomat-status-rs) or just plain text. And the text appearance? Customizable with format templates, bestie 💅.

🌸 OPTIONS

• -o, --output <OUTPUT> — sets the output format, with [default: waybar]. The possible values are:
  • waybar
  • i3tomat-status-rs
  • plain
• -f, --format <FORMAT> — customizes the text display using these placeholders:
  • {icon} — phase icon
  • {time} — remaining time (MM:SS)
  • {state} — play/pause symbol
  • {phase} — phase name
  • {session} — session progress
• -h, --help — prints help; the page says to see a summary with '-h' (iykyk).

🎀 EXTRA

🫶 OUTPUT FORMATS

• waybar — JSON output for waybar (default)
• i3tomat-status-rs — JSON output for i3tomat-status-rs
• plain — plain text output

🦋 FORMAT PLACEHOLDERS

• {icon} — phase icon (🍅 work, ☕ break, 🏖️ long break)
• {time} — remaining time (MM:SS)
• {state} — play/pause symbol (▶/⏸)
• {phase} — phase name (Work/Break/Long Break)
• {session} — session progress (e.g. 1/4)

🌈 EXAMPLES

tomat status
tomat status --output plain
tomat status --format "{time}"
tomat status --format "{phase}: {time} {state}"

---

and that's the full tomat-status(1) page, bestie — source: General Commands Manual; version/date: not listed on the original, so we're not inventing one. periodt 💅✨