timeglance

Config-driven time planning at a glance - one web UI controls two tools:

• Weekly - your routine sheet with activity layers. Print it or set it as a desktop wallpaper.
• Year - a wide year-at-a-glance planner, with layers fed by your own calendars, public holidays, and manually added events. Print it or set it as a desktop wallpaper.

Quick start (Docker)

docker compose run --rm timeglance timeglance-init   # first run: scaffold year/ + weekly/ config.yaml
docker compose up                                    # then open http://localhost:8753

Config, outputs and scheduler state are bind-mounted under ./year, ./weekly and ./state, so the UI edits files on your host. Outputs are written as your host user — the compose file defaults to 1000:1000 (the usual first Linux user), so it just works for most; if your uid differs, run UID=$(id -u) GID=$(id -g) docker compose up.

Wallpaper-setting needs a live Plasma session, so it works only with the local install (next section), not in Docker; the container UI auto-hides it.

Quick start (local)

Needs Python 3.13 and uv. WeasyPrint and CairoSVG load native libraries (Cairo, Pango, GDK-PixBuf) at runtime; most Linux desktops already have these, but on a minimal or server install add them first (Debian/Ubuntu):

sudo apt-get install libcairo2 libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf-2.0-0
uv sync
uv run timeglance-init     # scaffold year/ + weekly/ config.yaml from the templates
uv run timeglance          # the control panel at http://localhost:8753

Headless renders (each flag has a YAML equivalent):

uv run timeglance-year --theme light --layout vertical   # -> year/out/
uv run timeglance-weekly --format both                   # -> weekly/out/

Docs

• Motivation - why this exists, and how it fits a GTD/calendar setup
• The control panel - preview, config editor, scheduler & activity log
• Configuration - year & weekly YAML, calendar (.ics) sources
• Reference - every CLI flag and YAML key
• Wallpaper - KDE Plasma, per-screen native-resolution rendering
• Use as a library - import and render PNG/PDF/SVG from Python
• Contributing - setup, CI, releasing

Limitations

• Wallpaper-setting is host-only. The container can't reach a Plasma session, so inside Docker the feature self-hides and a scheduled "set wallpaper" renders the files but skips the set (logged as wallpaper skipped (no backend)). Run the server/CLI on the host to set wallpapers.
• Weekly blocks can't overlap in time. Two activities over the same slot on the same day render on top of each other, so only one reads clearly.