helios/helios-alarm-clock
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
4 commits 1 branch 0 tags 863 KiB
Find a file
Moritz 6032e9fd07 Production cleanup: enable R8, add ProGuard rules, validate API input 
- Enable R8 minification and resource shrinking for release builds
- Add ProGuard keep rules for Ktor, kotlinx.serialization, Room
- Validate hour/minute range in POST /set endpoint
- Guard wake lock release on server start failure
- Remove unused template colors from colors.xml
- Rewrite README with curl examples, security note, troubleshooting

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 17:10:41 +01:00
app Production cleanup: enable R8, add ProGuard rules, validate API input 2026-02-15 17:10:41 +01:00
gradle Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00
.gitignore Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00
build.gradle.kts Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00
gradle.properties Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00
gradlew Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00
gradlew.bat Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00
helios-alarm-app-icon.png Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00
README.md Production cleanup: enable R8, add ProGuard rules, validate API input 2026-02-15 17:10:41 +01:00
settings.gradle.kts Initial commit: Helios Alarm Clock 2026-02-14 17:47:10 +01:00

README.md

Helios Alarm Clock

An Android alarm clock with an embedded HTTP server for remote control from a Raspberry Pi or any device on the local network.

Features

  • HTTP API on port 8080 for remote alarm management
  • Material 3 UI with time picker and alarm list
  • Reliable alarms via AlarmManager.setExactAndAllowWhileIdle() (survives Doze)
  • Full-screen alarm with system alarm sound and DND bypass
  • Persistent server as a foreground service with wake lock
  • Boot survival — server and alarms reschedule after reboot
  • Auto-cleanup — fired alarms are deleted automatically

HTTP API

All endpoints listen on port 8080. Replace PHONE_IP with the IP shown in the app.

Set an alarm

curl -X POST http://PHONE_IP:8080/set \
  -H "Content-Type: application/json" \
  -d '{"hour": 7, "minute": 30, "label": "Wake up"}'

Response: 201 Created

{"id": "550e8400-e29b-41d4-a716-446655440000"}

hour must be 0-23, minute must be 0-59. label is optional (defaults to empty).

Remove an alarm

curl -X POST http://PHONE_IP:8080/rm \
  -H "Content-Type: application/json" \
  -d '{"id": "550e8400-e29b-41d4-a716-446655440000"}'

List alarms

curl http://PHONE_IP:8080/list

Returns a JSON array of all scheduled alarms.

Security

The HTTP server has no authentication. Anyone on the same network can set or remove alarms. Only run this on a trusted local network.

Tech Stack

  • Kotlin, Jetpack Compose, Material 3
  • MVVM with Hilt dependency injection
  • Room database for persistence
  • Ktor CIO embedded HTTP server
  • Foreground service (connectedDevice type)

Requirements

  • Android 8.0+ (API 26)
  • Target SDK 36 (Android 16)

Permissions

Permission Purpose
INTERNET / ACCESS_NETWORK_STATE HTTP server
FOREGROUND_SERVICE_CONNECTED_DEVICE Keep server alive
SCHEDULE_EXACT_ALARM / USE_EXACT_ALARM Precise alarm timing
USE_FULL_SCREEN_INTENT Wake screen on alarm
WAKE_LOCK Prevent CPU sleep
RECEIVE_BOOT_COMPLETED Restart after reboot
POST_NOTIFICATIONS Service + alarm notifications

Building

./gradlew assembleRelease

The APK is at app/build/outputs/apk/release/app-release.apk.

Installing via ADB

adb install app/build/outputs/apk/release/app-release.apk

Troubleshooting

  • Server not reachable: Ensure the phone and client are on the same Wi-Fi network. Check that battery optimization is disabled for the app.
  • Alarm doesn't fire: Grant exact alarm permission in system settings. Disable battery optimization for the app.
  • Notification not showing: Grant notification permission (Android 13+).
  • Server dies in background: Some OEMs aggressively kill background services. Disable battery optimization and lock the app in recents.

License

MIT