Skip to content

About

A life tracker guided by the Greek gods. Tasks, reminders, streaks and a journal, all local. Linux and Windows.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Greek God Life Tracker

A desktop app that sits in your system tray and reminds you to do the things you keep not doing. Every task you add belongs to a Greek god. When a task comes due, that god appears in the corner of your screen and tells you so. When you finish it, the god is pleased and you earn favour. When you miss it, the god waits for you to come back. Nobody gets scolded.

It runs on Linux and Windows, keeps everything on your own machine, and has no accounts, no sync and no tracking.

Sanctuary

Completing a task Calendar and journal The Pantheon The Mysteries

Who it's for

People who leave the washing up for three days. People who forget to eat properly, or to shower, or to text back, or to go outside. People with ADHD or depression or plain old executive dysfunction who find that ordinary to-do apps just become another list to feel bad about. People who like a bit of theatre in their day.

If you already have a system that works, this probably isn't for you. If you've bounced off five habit apps, it might be.

What it does

Tasks with a god attached. When you add a task you pick an area of life (home, body, mind, work, people, and so on) and then a god within it. Hygieia handles showers and teeth, Hestia handles tidying, Hermes handles replying to messages and leaving the house, Ares handles the one task you're dreading, Dionysus tells you when to stop working. There are 26 gods across 10 areas. If you use the quick-add box, the app guesses the god from the words you typed.

Reminders that don't nag. Each task can have any number of "heralds" (reminders before it's due) plus the moment itself. Reminders arrive as a small always-on-top popup showing the god, a line from them, and three buttons: Done, Later, Skip. It never takes focus from what you were doing. Enter completes, S snoozes, Escape dismisses.

Quiet hours, a per-hour cap on reminders, a Do Not Disturb toggle in the tray, and an automatic fallback to normal system notifications on desktops that can't do overlays. If your laptop was asleep through six reminders, you get one when it wakes, not six.

Recurring tasks and streaks. Daily, weekly on chosen days, monthly, yearly, or every N hours. Each recurring task grows a marble column, one drum per day done. Reaching 1, 3, 6 and 10 days banks a "freeze". Miss a day and a freeze covers it. Miss a day with no freeze and the column keeps half its height. It never drops to zero. There is no losing screen.

One click to complete. Completing a task is a single click or keypress, from the main window or the popup. After that the ritual plays: the task flies into the god's seal, the seal flares, and the god appears in their triumphant form with your favour breakdown. You can skip the ritual in settings if you'd rather.

The mystical side. Every task title is converted to Greek letters and summed (isopsephy, the Greek cousin of gematria); the digital root ties it to a Pythagorean number and its meaning. The day is divided into planetary hours the Hellenistic way, from sunrise to sunset, and tasks completed during a god's ruling hour earn extra favour. Each god has a sigil traced from their name across the magic square of their planet, the way Agrippa described. None of this is required to use the app, but it's there if you like it.

A calendar and a journal. The Ephemeris shows the month with everything due, recurring tasks projected forward, and a page of notes per day with a mood mark. It saves as you type and stays on your machine.

Display. Text size and interface scale sliders, a compact row mode, and switches for the background geometry and the Greek labels, all under Settings.

Help built in. The Oracle section explains every part of the app in plain words, and hovering anything shows a short tooltip (you can turn those off).

Frameworks as tools. The Temples section has working views for the Eisenhower matrix, ABCDE, MoSCoW, Pareto, Big Rocks, Pomodoro (with a forge that heats up as you work), Eat the Frog, the two-minute rule, time blocking laid over the planetary hours, biological prime time (log your energy, see when you peak), GTD lists, SMART goals and the Seinfeld chain. They're all views over the same tasks; tag a task with whichever ones you find useful.

Sound. Tones are tuned to A=432 and each kind of alert has its own Solfeggio frequency. Interface sounds (hover, click, open, close) are quiet lyre plucks and can be turned off separately from alerts.

Art. 130 portraits, five per god: calm, reminding, urgent, triumphant, and welcoming you back. Generated locally with a Krea 2 based model and hand-picked. The gold border is drawn by the app so every portrait matches.

Installing

Grab the latest build from the Releases page.

Platform File
Windows 10/11 GreekGodLifeTracker_x.y.z_x64-setup.exe (installer) or GreekGodLifeTracker_x.y.z_x64_en-US.msi
Debian / Ubuntu / Mint GreekGodLifeTracker_x.y.z_amd64.deb, then sudo apt install ./GreekGodLifeTracker_x.y.z_amd64.deb
Fedora / openSUSE GreekGodLifeTracker-x.y.z-1.x86_64.rpm
Arch / Manjaro / EndeavourOS greekgodlifetracker-bin-x.y.z-1-x86_64.pkg.tar.zst, then sudo pacman -U <file>

Linux needs webkit2gtk-4.1 and libayatana-appindicator; the deb and rpm declare them as dependencies and the Arch package pulls them in.

On first launch you're asked three things: roughly where you are (for sunrise and sunset; you can give wake and bed times instead), when you want the app to stay quiet, and whether to start with your system. That's it.

A note on Wayland

Overlay popups need to position themselves on screen, which Wayland doesn't allow. The app runs itself through Xwayland on Wayland sessions so the overlay works as intended. If you'd rather it didn't, set GDK_BACKEND=wayland and the app will use normal desktop notifications instead.

Where your data lives

One SQLite file, nothing else:

  • Linux: ~/.local/share/com.wyldveil.greekgodlifetracker/olympus.sqlite
  • Windows: %APPDATA%\com.wyldveil.greekgodlifetracker\olympus.sqlite

Back it up by copying it. Delete it to start fresh. The app never sends it anywhere.

Keyboard

Keys Where Does
Ctrl+Shift+Space anywhere on the system Open the app with the quick-add box focused
Ctrl+K main window Focus quick-add
Ctrl+N main window New task with the full form
Ctrl+Enter task form Save
Enter / S / Esc popup Complete / snooze / dismiss
any key after completing close the ritual screen

Building from source

You need Node 20 or newer, Rust (stable, via rustup) and, on Linux, the Tauri prerequisites (webkit2gtk-4.1, libayatana-appindicator, librsvg, patchelf).

git clone https://github.com/WyldVeil/GreekGodLifeTracker
cd GreekGodLifeTracker
npm install
npm run tauri dev       # run with hot reload
npm run tauri build     # produce installers in src-tauri/target/release/bundle/

Tests:

npx vitest run                 # isopsephy, planetary hours, magic squares, god registry
cd src-tauri && cargo test     # recurrence rules, streaks, quiet hours, database

The Arch package is built with makepkg from packaging/arch/PKGBUILD, which repackages the release tarball. Windows builds are produced by the GitHub Actions workflow in .github/workflows/release.yml on a Windows runner.

How it's put together

Tauri 2 with a Rust core and a React 19 / TypeScript front end. Tailwind 4 for styling, Framer Motion for animation, rusqlite for storage.

The Rust side owns everything that must keep working while you're not looking: the SQLite store, the recurrence engine (a subset of RRULE), the scheduler that ticks every fifteen seconds and notices when the clock jumps after sleep, the streak and favour rules, the tray, the global shortcut, and the popup window queue. The front end owns the god registry, the isopsephy and planetary-hour maths, the sigil generator, audio synthesis, and every screen.

More detail on the design decisions, the god-to-area table and the reminder collapse policy is in docs/DESIGN.md.

Regenerating the art

The portraits were made with a local ComfyUI and a Krea 2 based checkpoint at 1024 by 1024, 18 steps. The scripts in tools/artgen/ reproduce the run against any ComfyUI server:

npx vite-node tools/artgen/export-prompts.ts               # prompts from the god registry
COMFY_URL=http://127.0.0.1:8188 COMFY_WORKFLOW=tools/artgen/workflow_api.json \
  python3 tools/artgen/generate.py --candidates 2          # candidates into tools/artgen/out/
python3 tools/artgen/curate.py --sheet                     # contact sheets
python3 tools/artgen/curate.py                             # publish to public/assets/gods/

workflow_api.json is the ComfyUI API-format workflow used; swap in your own to use a different model. The prompts deliberately don't ask for a border, since the app draws one.

Contributing

Issues and pull requests are welcome. If you're adding a god, the registry is src/lib/gods.ts and the tests in src/lib/gods.test.ts will tell you what's missing. If you're changing reminder behaviour, src-tauri/src/scheduler.rs has the rules in comments at the top.

Two things this project won't accept: anything that shames the user for missing a task, and anything that phones home.

Licence

MIT. See LICENSE.

About

A life tracker guided by the Greek gods. Tasks, reminders, streaks and a journal, all local. Linux and Windows.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages