uair(1)

💅 uair(1) — General Commands Manual 💅

---

✨ NAME ✨

uair — an extensible pomodoro timer 🍓

🌈 SYPNOSIS 🌈

uair [options..]

💅 OPTIONS 💅

• -c, --config — points uair at a specific config file 🎀
• -s, --socket — tells it which socket file to use 🦋
• -l, --log — sets where logs go — use - for stdout, which is the default, bestie 👑
• -q, --quiet — runs uair with absolutely zero stdout noise 🙈
• -v, --version — shows the version number and dips ✨
• --help — shows this help message and bounces 💅

🌸 DESCRIPTION 🌸

okay so uair is a minimal pomodoro timer for UNIX-like operating systems, and it's literally iconic. unlike other timers, uair simply prints the remaining time to standard output. other than making the code more maintainable (slay), this design allows uair to be very extensible — it can be used in various status bars and even command-line and graphical user interfaces. periodt. 💖

🎀 CONFIGURATION 🎀

configuration is done in TOML, bestie. if a config file is not specified by the -c flag, it is sourced according to the XDG Base Directory Specification — i.e. it looks for the config file in the following order until it successfully finds one: ✨

• $XDG_CONFIG_HOME/uair/uair.toml
• $HOME/.config/uair/uair.toml
• ~/.config/uair/uair.toml

pro tip: the order matters — it stops at the first file it finds! 💅

for information on the config file format, see uair(5) 🫶

🌈 SEE ALSO 🌈

uair(5) uairctl(1) — that's the whole crew, iykyk 👑🔥

---

💖 sign-off: uair(1) · 1980-01-01 🌸