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

Nix

nix run github:Farhan291/hyprwatch
# or
nix profile install github:Farhan291/hyprwatch

---

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
• Phone screen time (CSV import from your phone's Digital Wellbeing export)
• 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
• Navigation rail for Desktop / Phone mode switching
• 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
• Phone stats dashboard (Digital Wellbeing CSV)

---

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.