ACTIVITY(1)

💖 ACTIVITY(1) — the glow-up manual 💖

okay bestie, so this is the manual page for Activity, aka Activity Watcher 0.4.0, and it lives in the User Commands section of your man pages. pull up a chair, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

Activity — literally the manual page for Activity Watcher 0.4.0. that's the whole vibe. it's the watcher. it watches. 🫶

---

✨ SYNOPSIS ✨

aw-awatcher [OPTIONS]

yeah that's it, that's the whole summoning spell. run aw-awatcher with whatever options your heart desires. 💅

---

✨ DESCRIPTION ✨

X11 and Wayland active window and idle watcher for ActivityWatch server

no cap. it keeps an eye on your active window and whether you've gone idle, on both X11 and Wayland, and it feeds all that tea to your ActivityWatch server. main character surveillance energy, but make it consensual. 👑

---

✨ OPTIONS ✨

here's the whole menu, bestie. every single one, no skips. 🎀

• -c, --config <FILE> — point it at a custom config file. your config, your rules, your era. ✨
• --port <PORT> — custom server port. the default is 5600, and yes that number is doing numbers. 🔥
• --host <HOST> — custom server host. the default is 127.0.0.1, i.e. the classic little localhost moment. 🏠
• --api-key <APIKEY> — API key for the server. it also reads the environment variable AW_API_KEY=, so you can keep your secrets in your env instead of your command line, iykyk. 🔐
• --idle-timeout <SECONDS> — how long you can be a total statue before it counts you as idle. default is 180 seconds. that's three whole minutes of nothing, go take a nap fr. 😴
• --poll-time-idle <SECONDS> — the period between sending heartbeats to the server for idle activity. default is 5. 💓
• --poll-time-window <SECONDS> — the period between sending heartbeats to the server for window activity. default is 1. one second! it's eager. 👀
• --no-server — don't send data to the ActivityWatch server. do not pass go, do not collect telemetry. 🙈
• -v... — verbosity level, and the way it stacks is so cute: -v for warnings, -vv for info, -vvv for debug, -vvvv for trace. the more v's, the more it yaps. 🗣️
• -h, --help — print help. your little emergency exit when you forget everything. 🆘
• -V, --version — print version. hi, what's your sign, what's your build. ⭐

lowkey a warning but mostly a heads up: those -v flags are stackable, so -vv and -vvv are not the same as -v twice-in-a-row-just-because. count your v's carefully bestie. 💀

---

🌈 SEE ALSO 🌈

The full documentation for Activity is maintained as a Texinfo manual. if the info and Activity programs are properly installed at your site, the command

info Activity

should give you access to the complete manual. so if you want the full lore, not just the group chat recap, that's where you go. 📚✨

---

and that's the page!! iconic, honestly. this was Activity Watcher 0.4.0, dated August 2026 — so like, future-dated slay. 🦋 go watch some windows, bestie. 💜