mirror of https://github.com/kuhyx/wake-alarm.git synced 2026-11-10 19:27:02 +01:00

Go to file

Krzysztof kuhy Rudnicki 64c25e67e9 Some checks are pending pre-commit / pre-commit (push) Waiting to run Details Tests / test (3.10) (push) Waiting to run Details Tests / test (3.11) (push) Waiting to run Details Tests / test (3.12) (push) Waiting to run Details phone_app: replace the stock Flutter launcher icon Adopt the shared icon family (python_pkg/app_icons in testsAndMisc): a charcoal #1B1D21 field carrying an orange clock glyph, orange being this app's own theme seedColor. The clock is deliberately drawn without bell "ears" - at launcher size they read as noise rather than as an alarm clock. Adds the adaptive-icon layers the project never had, including an Android 13 monochrome layer. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>		2026-07-19 16:59:38 +02:00
.github/workflows	Extract wake_alarm from testsAndMisc as a standalone repo	2026-06-22 12:31:40 +02:00
phone_app	phone_app: replace the stock Flutter launcher icon	2026-07-19 16:59:38 +02:00
scripts	Add CI-mirror pre-push gate + requirements-sync check	2026-07-11 17:51:16 +02:00
wake_alarm	Replace sleep-and-hope audio waits with per-cycle presence checks	2026-07-11 18:51:03 +02:00
.gitignore	Add CI-mirror pre-push gate + requirements-sync check	2026-07-11 17:51:16 +02:00
.pre-commit-config.yaml	Add CI-mirror pre-push gate + requirements-sync check	2026-07-11 17:51:16 +02:00
CLAUDE.md	Document the durable-clone editable-install requirement	2026-06-22 12:54:27 +02:00
install.sh	Extract wake_alarm from testsAndMisc as a standalone repo	2026-06-22 12:31:40 +02:00
MIGRATION.md	Add MIGRATION.md documenting the Gist -> crdt_sync move	2026-07-11 23:55:10 +02:00
pyproject.toml	Point gatelock at the consolidated utils monorepo	2026-07-10 14:01:43 +02:00
README.md	Extract wake_alarm from testsAndMisc as a standalone repo	2026-06-22 12:31:40 +02:00
requirements.txt	Point gatelock at the consolidated utils monorepo	2026-07-10 14:01:43 +02:00
shutdown-wrapper.sh	Migrate phone_app alarm sync from GitHub Gist to crdt_sync	2026-07-11 22:45:14 +02:00
sleep-hook.sh	Extract wake_alarm from testsAndMisc as a standalone repo	2026-06-22 12:31:40 +02:00
wake-alarm-fans.sh	Extract wake_alarm from testsAndMisc as a standalone repo	2026-06-22 12:31:40 +02:00
wake-alarm.service	Extract wake_alarm from testsAndMisc as a standalone repo	2026-06-22 12:31:40 +02:00

README.md

wake_alarm

A hibernate-scheduled weekend wake alarm: the machine hibernates overnight on alarm days and wakes itself via rtcwake, then shows a fullscreen, challenge-dismissed alarm with fan ramp and optional TP-Link Tapo P110 smart-plug control.

Install

bash install.sh

This installs the package + dependencies into system Python's user site-packages (the systemd service runs /usr/bin/python directly, not a venv — see CLAUDE.md), installs the systemd user service, the systemd-sleep resume hook, the shutdown wrapper that triggers hibernate on alarm nights, the fan-ramp script, and (optionally) python-kasa for smart-plug control.

Usage

python -m wake_alarm._alarm --demo   # test the alarm window (safe, closeable)

The alarm fires automatically via the hibernate/wake cycle once installed; no manual invocation is needed in normal operation.

Development

python -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/pre-commit install && .venv/bin/pre-commit install --hook-type pre-push
.venv/bin/python -m pytest wake_alarm/tests/ --cov=wake_alarm --cov-branch --cov-fail-under=100

See CLAUDE.md for scheduling details, the hibernate/rtcwake mechanism, the cross-repo workout_log.json read, and production deployment gotchas.