Add optional systemd user service #38

Merged

JackFrostbyte merged 1 commit from feature/v0.6-issue-17-systemd-user-service into main

2026-05-09 22:29:28 -04:00

JackFrostbyte commented

2026-05-09 22:29:21 -04:00

Owner

Title:
Add optional systemd user service

Description:
Adds optional systemd user service support for RGB Aura.

Changes:

Added systemd/user/rgb-aura.service
Added docs/systemd-user-service.md
Service runs from /home/psyco/Projects/rgb-aura
Service uses /home/psyco/Projects/rgb-aura/.venv/bin/python
Service starts RGB Aura with --animation-speed 1.25 --leave-dark-blue
Service starts after and wants app-OpenRGB@autostart.service
Added TimeoutStopSec=20 to allow clean shutdown cleanup
Added SIGTERM handling so systemctl --user stop rgb-aura.service exits cleanly
Fixed continuous runtime mode so cycles: null and duration_seconds: null no longer fall back to one scheduler cycle
Updated dry-run display so continuous mode shows as Mode: continuous

Validation:

ruff format src/rgb_aura
ruff check src/rgb_aura scripts tests
python -m rgb_aura.main --dry-run --animation-speed 1.25
Confirmed dry-run remains hardware-free and exits with code 0
Confirmed service starts and stays running
Confirmed service logs Runtime mode: continuous
Confirmed systemctl --user stop rgb-aura.service triggers SIGTERM cleanup
Confirmed shutdown restores active RGB Aura zones to dark blue
Confirmed service stop exits with status=0/SUCCESS

Notes:

Service is optional and is not installed automatically.
Service is a user service, not a system-wide root service.
Reserved ARGB zone remains untouched.
Animation visuals were not changed.

Closes #17

Title: Add optional systemd user service Description: Adds optional systemd user service support for RGB Aura. Changes: - Added `systemd/user/rgb-aura.service` - Added `docs/systemd-user-service.md` - Service runs from `/home/psyco/Projects/rgb-aura` - Service uses `/home/psyco/Projects/rgb-aura/.venv/bin/python` - Service starts RGB Aura with `--animation-speed 1.25 --leave-dark-blue` - Service starts after and wants `app-OpenRGB@autostart.service` - Added `TimeoutStopSec=20` to allow clean shutdown cleanup - Added SIGTERM handling so `systemctl --user stop rgb-aura.service` exits cleanly - Fixed continuous runtime mode so `cycles: null` and `duration_seconds: null` no longer fall back to one scheduler cycle - Updated dry-run display so continuous mode shows as `Mode: continuous` Validation: - `ruff format src/rgb_aura` - `ruff check src/rgb_aura scripts tests` - `python -m rgb_aura.main --dry-run --animation-speed 1.25` - Confirmed dry-run remains hardware-free and exits with code `0` - Confirmed service starts and stays running - Confirmed service logs `Runtime mode: continuous` - Confirmed `systemctl --user stop rgb-aura.service` triggers SIGTERM cleanup - Confirmed shutdown restores active RGB Aura zones to dark blue - Confirmed service stop exits with `status=0/SUCCESS` Notes: - Service is optional and is not installed automatically. - Service is a user service, not a system-wide root service. - Reserved ARGB zone remains untouched. - Animation visuals were not changed. Closes #17

JackFrostbyte added 1 commit

2026-05-09 22:29:21 -04:00