{"id":50933332,"url":"https://github.com/kimptoc/chimer","last_synced_at":"2026-06-17T06:32:45.144Z","repository":{"id":357693734,"uuid":"1238130072","full_name":"kimptoc/chimer","owner":"kimptoc","description":"Chimer — a chiming countdown timer for Android, with Android Auto support","archived":false,"fork":false,"pushed_at":"2026-05-22T16:43:24.000Z","size":156,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T20:56:40.148Z","etag":null,"topics":["alarm","android","android-auto","car-app-library","jetpack-compose","kotlin","material3","timer"],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kimptoc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-13T20:57:13.000Z","updated_at":"2026-05-15T08:42:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kimptoc/chimer","commit_stats":null,"previous_names":["kimptoc/chimer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kimptoc/chimer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimptoc%2Fchimer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimptoc%2Fchimer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimptoc%2Fchimer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimptoc%2Fchimer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kimptoc","download_url":"https://codeload.github.com/kimptoc/chimer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimptoc%2Fchimer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34437449,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alarm","android","android-auto","car-app-library","jetpack-compose","kotlin","material3","timer"],"created_at":"2026-06-17T06:32:44.234Z","updated_at":"2026-06-17T06:32:45.132Z","avatar_url":"https://github.com/kimptoc.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chimer\n\n[![CI](https://github.com/kimptoc/chimer/actions/workflows/ci.yml/badge.svg)](https://github.com/kimptoc/chimer/actions/workflows/ci.yml)\n\nA simple Android countdown-timer app — chimes when time's up, with an Android Auto cancel surface.\n\n- Set a timer from the phone (minutes; defaults to your most-recent duration, plus a list of the last five used)\n- A four-note chime + vibration loops on expiry, auto-stopping after 2 minutes if you don't cancel\n- Survives the app being killed and the device being rebooted\n- When connected to Android Auto, the running countdown and a big STOP button show on the head unit\n- When the timer expires, the car screen shows a prominent red STOP button (no more \"unlock screen\" UI)\n\n## Tech stack\n\n- Kotlin, Jetpack Compose, AndroidX Car App Library\n- `minSdk = 29` (Android 10), `compileSdk = 35`\n- AlarmManager (`USE_EXACT_ALARM`) for scheduling, foreground service (`specialUse`) for the ringing playback\n- DataStore Preferences for persistence\n- No DI framework — single `AppContainer` for wiring\n- 21 JVM unit tests covering the recents helper, time formatting, and the repository (DataStore via Robolectric)\n\n## Build\n\nYou'll need a JDK 17+ — the build uses Android Studio's bundled JBR by default.\n\n```bash\nJAVA_HOME=/Applications/Android\\ Studio.app/Contents/jbr/Contents/Home \\\n  ./gradlew :app:assembleDebug\n\nJAVA_HOME=/Applications/Android\\ Studio.app/Contents/jbr/Contents/Home \\\n  ./gradlew :app:testDebugUnitTest    # 21 unit tests\n\nJAVA_HOME=/Applications/Android\\ Studio.app/Contents/jbr/Contents/Home \\\n  ./gradlew :app:installDebug\n```\n\nOpen in Android Studio normally; everything is Gradle Kotlin DSL.\n\n## Android Auto: known limitations\n\nThis app is **not Play-ready** out of the box:\n\n- The `CarAppService` declares `androidx.car.app.category.IOT`. This is for sideloaded/development use only; Android Auto category support is host-controlled and not Play-publishable for this timer app without a different product shape.\n- `TimerCarAppService.createHostValidator()` returns `HostValidator.ALLOW_ALL_HOSTS_VALIDATOR`. Useful for development; replace with the strict validator before any production release.\n\nFor personal/sideloaded use these are fine. To use it in your own car: enable developer mode in the Android Auto app on your phone, then add this app from \"Unknown sources\".\n\n## Project docs\n\n- `docs/superpowers/specs/2026-05-13-timer-with-auto-design.md` — design spec\n- `docs/superpowers/plans/2026-05-13-timer-with-auto-implementation.md` — full implementation plan (20 tasks)\n- `docs/MANUAL_SMOKE_TESTS.md` — manual smoke test checklist for phone + Auto\n\n## How this was built\n\nThis repo was developed with [Claude Code](https://claude.com/claude-code) using the brainstorming → spec → plan → subagent-driven implementation workflow from the `superpowers` plugin. The full design spec, implementation plan, and an honest per-commit history (including the field-debug session that fixed five real Android 14/16 bugs after the initial implementation passed unit tests) are checked in.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimptoc%2Fchimer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkimptoc%2Fchimer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimptoc%2Fchimer/lists"}