- TypeScript 75.7%
- C++ 11.5%
- CSS 9.5%
- Shell 1.6%
- Python 0.8%
- Other 0.8%
Alex
1ec58eaa9d
Drop the centered max-width shell that left huge side gutters. Switch to viewport-width grids, side-by-side heatmap and app list on wide panels, and a 1600×900 default window so 16:9 breakpoints actually fire. Co-authored-by: Cursor <cursoragent@cursor.com> |
||
|---|---|---|
| assets | ||
| LLM | ||
| scripts | ||
| src | ||
| .claude | ||
| .gitignore | ||
| AUTOCOLOR_GUIDE.txt | ||
| CLAUDE.md | ||
| CMakeLists.txt | ||
| GEMINI.md | ||
| install.sh | ||
| LICENSE | ||
| PKGBUILD | ||
| README.md | ||
| TODO.md | ||
hyprwatcher
"Big Brother, but you asked for it."
A time-tracking suite for the Hyprland window manager. You're already glued to your screens — at least now you can feel guilty about it in a visually coherent way.
Three components, one purpose: record what you're doing all day.
| Component | What it is |
|---|---|
hyprwatchd |
C++20 daemon. Listens to Hyprland IPC events, logs every focus change to ~/.config/hyprwatch/data/ in JSON. Never stops watching. |
hyprwatch |
ncurses TUI. For when you refuse to leave the terminal. |
hyprwatcher |
Electron + React + Material 3 GUI. Charts, heatmaps, app icons, notes. The main thing. |
Quick Install (Arch Linux)
curl -fsSL https://code.milfs.party/alex/hyprwatcher/raw/branch/master/install.sh | bash
This fetches the PKGBUILD, runs
makepkg -si, and enables the daemon. Read it first if you don't blindly pipe internet scripts into bash (you shouldn't, but it's clean, I promise).
Manual Install
Arch Linux (via PKGBUILD)
git clone https://code.milfs.party/alex/hyprwatcher.git
cd hyprwatcher
makepkg -si
systemctl --user enable --now hyprwatchd
hyprwatcher # launch GUI
From Source
Requirements: cmake >= 3.16, gcc/clang (C++20), ncurses, nlohmann-json, node >= 20, npm
git clone https://code.milfs.party/alex/hyprwatcher.git
cd hyprwatcher
# Daemon + TUI
cmake -B build -S . -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
sudo cmake --install build --prefix /usr
# Enable user service
systemctl --user daemon-reload
systemctl --user enable --now hyprwatchd
# GUI (dev mode)
cd src/gui && npm install --legacy-peer-deps && npm run dev
What It Tracks
- Every window focus change (app class + title + timestamps)
- Per-app session duration, persisted to JSON files at
~/.config/hyprwatch/data/HH-DD-MM-YYYY.json - Hourly breakdown, daily/weekly/monthly aggregates
- Active vs inactive time balance
The daemon writes JSON logs even when the GUI isn't running. No data loss on restart.
Architecture
Hyprland ──socket2──► hyprwatchd ──unix sock──► hyprwatch (TUI)
│ ──unix sock──► hyprwatcher (GUI)
└──────────────────────────────────► ~/.config/hyprwatch/data/*.json
The daemon is the source of truth. The GUI reads live data via IPC and historical data from both SQLite and the JSON session logs.
GUI Features
- Material 3 Expressive design via m3e — dynamic color palette pulled from your Hyprland Material theme
- Activity heatmap, stacked area chart, active/inactive donut
- Per-app rename, custom icons (auto-fetched from Flathub/iTunes), blacklist, notes
- Radial clock editor for manual time adjustments
Why Not Just Use [insert popular time tracker here]
Because it doesn't know what kitty is. This one does.
License
MIT — see LICENSE.
Original project by Farhan291. This fork by alex.