WMWORK(1)

✨ wmwork(1) ✨ — keep track of time worked on projects 💖

okay bestie, welcome to wmwork — it's the manual page, it's section 1, it's Version VERSION, and it's literally about to become your new hyperfixation. no cap. 🫶

---

🌸 SYNOPSIS 🌸

wmwork [options]

that's it. that's the whole vibe. 💅

---

🦋 DESCRIPTION 🦋

so wmwork gives you a lil monitor on a 64x64 mini window that helps you keep track of your time. ⏰ tiny. adorable. functional. the whole idea is based on the program Worklog, written by Truxton King Fulton II. 🎀

and here's the tea: unlike Worklog, wmwork is a graphical application designed to work with the WindowMaker dock — but she's flexible, bestie, she'll work with other window managers as well. 👑

---

✨ OPTIONS ✨

• -d, --days — displays time in ddd.hh:mm instead of hhh:mm:ss. 🗓️ note that if one timer is at least 1000 hours large this will be the case anyway. no escape, queen.
• -f, --force — overwrite stale lock files. 🔓 use this if wmwork says that it's already running but it isn't. (she's lying to you, gaslight gatekeep girlboss)
• -h, --help — display a command line summary. 🙈
• -v, --version — display the version number. 🔢
• --display=id — set the display to use, e.g. --display=:0.0. 🖥️
• --geometry=pos — set the position of the dock app, e.g. --geometry=+10+10. 📍 note that the size (64x64) is hard-coded and cannot be changed. periodt. 💀

---

🎀 USAGE 🎀

when wmwork is started, the uppermost line shows the accumulated time spent on the project, identified by a three letter code in the third line. the second line shows the current time spent on the project and is initially zero. 🕐

the buttons, bestie, listen up:

• the button V starts the timer ▶️
• the button || pauses it ⏸️
• the button X stops the timer, saving the accumulated time in ~/.wmwork/worklog, adding the current session time to ~/.wmwork/worklog.XYZ and resetting the latter ⛔
• the buttons < and > switch between the projects found in the file ~/.wmwork/worklog 🔄 — but this can be done only if the timer is neither running nor paused. rules are rules. 🚫

---

🌈 FILES 🌈

• ~/.wmwork/worklog — contains the projects configuration and log summaries. 📓

each line has the form identifier:timestamp[:comment]. empty lines and lines beginning with a # are ignored. only the first three characters of the (case-insensitive) identifier are relevant. when wmwork is overwriting ~/.wmwork/worklog it cuts the identifiers down that way. ✂️

• ~/.wmwork/??? — contains human readable timestamps for the project XYZ, where XYZ is the truncated identifier from ~/.wmwork/worklog. 🧚

having multiple entries of the same identifier in ~/.wmwork/worklog is possible. they are counted independently, but will share the same project file. 👯‍♀️ (siblings, not twins, fr fr)

---

💀 BUGS 💀

please send any bugs to <BUG-REPORT-ADDRESS>. 📬 Debian users are encouraged to use the Debian Bug Tracking System <http://bugs.debian.org/wmwork>. 🐛

not me asking you to report bugs... but like, actually please do. she's trying her best. 😭

---

👑 AUTHOR 👑

wmwork was written by Martin A. Godisch <martin@godisch.de>. 💖 it is based on the program wmppp written by Martijn Pieterse and Antoine Nulle. thanks to the following people, who have contributed to wmwork:

Adam Lackorzynski <adam@os.inf.tu-dresden.de>
Gordon Fraser <gordon@freakzone.net>
Daniel Tschan <tschan@devzone.ch>
Alexey Dokuchaev <danfe@danfe.ru>
Josep Portella Florit <jpf@sdf.lonestar.org>
Ben Stern <ben.stern@gmail.com>

legends, every single one. 🫶✨

---

and that's the whole page, bestie!! this lil icon of a manual page is brought to you by The Debian Project, dated March 2024, sitting pretty at Version VERSION. go log your hours. slay. 💅🎀🦋