seagrass

A minimal, low-resource work-breaks + late-night-reminder app that lives in the system tray. Written in C++ with Dear ImGui (stock look) and a zserge/tray icon.

Features

• Work breaks — work → short break → … → long break, configurable (minutes and seconds).
• Late-night warnings — after a configurable hour, nudges you to consider stopping, every N minutes.
• System tray icon (GTK/appindicator on Linux).
• GUI settings panel — every toggle and value below is adjustable there.
• Break delivery: desktop notification or a fullscreen overlay window.
• Custom message pools — separate pools for work vs late-night, each a list separated by three newlines (\n\n\n); a random entry is shown each time.
• Fullscreen overlay is customizable (background color + messages).
• Pause breaks for a configurable length (hours / minutes / seconds).
• Idle render policy — sleeps instead of rendering when nothing changes (battery friendly).

Build

Dependencies are provided by the nix devShell:

nix develop        # enter the dev shell
make               # build -> ./seagrass
make run           # build + run

Without nix, install gcc, pkg-config, glfw3, glew, gtk3, libappindicator-gtk3 and run make.

Layout

The source is split into small modules, all coordinated through src/app.h and the shared App g state (src/state.cpp). ImGui/GLFW/GTK live on different threads and communicate only through the atomics in App.

• src/main.cpp — entry point: config, single-instance lock, thread spawn
• src/app.h — shared internal interface (cross-module declarations)
• src/seagrass.h — Settings + App shared-state types
• src/state.cpp — the process-wide App g + small pure helpers
• src/config.cpp — XDG config persistence (~/.config/seagrass/config)
• src/notify.cpp — libnotify queue (emitted on the main GTK thread)
• src/timer.cpp — the pomodoro / late-night timer engine
• src/ui.cpp — ImGui settings panel + fullscreen break overlay
• src/tray.cpp — tray icon/menu + main-thread GTK loop (incl. freeze watchdog)
• src/window.cpp — the GLFW/ImGui window loop (worker thread)
• third_party/imgui/ — vendored Dear ImGui (pinned)
• third_party/tray/ — vendored zserge/tray (pinned)
• icon.png — placeholder tray icon ("SG" monogram). Drop the real logo here (same filename, PNG) when you've designed it; the app loads it from cwd.
• Makefile, flake.nix

Roadmap (later)

• Cross-platform tray/notification backends (macOS / Windows)