Files
meditation-timer/README.md
Marcus Rehbock 2370e9c796
Some checks failed
Build & Release APK / build (push) Failing after 46s
Meditation timer: gong service, wheel picker, history + health sync, Gitea CI
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 01:05:22 -07:00

39 lines
1.3 KiB
Markdown

# Meditation Timer
Jhana meditation timer for GrapheneOS. Start/end gong, scroll-wheel duration
picker (presets 20/45/60/90), session history with depth rating + notes, and
sync to the meditation dashboard at health.rehbock.xyz/meditation.html.
## Pipeline
Push to `main` on [git.rehbock.xyz](https://git.rehbock.xyz/marcus/meditation-timer)
→ Gitea Actions builds a signed release APK → published as a Gitea release
→ Obtainium on the phone picks up the new version.
## Sync
Sessions POST to `https://meditation.rehbock.xyz/v1/sessions` (health-api).
The bearer token is **not** in this repo or the APK — set it once in-app
(History → Token) or seed it via:
```
adb shell am start -n com.marcus.meditationtimer/.MainActivity --es sync_token "<token>"
```
Sessions shorter than 30 seconds are not recorded (gong tests).
## Local build
```
./gradlew assembleDebug # needs ANDROID_HOME or local.properties
```
Release signing (CI): secrets `KEYSTORE_B64` + `KEYSTORE_PASSWORD`; key alias
`meditation`. Keystore master copy: `~/.android-keys/` on the desktop.
## Gong
`app/src/main/res/raw/gong.wav` is synthesized (singing-bowl partials,
detuned fundamental pair for beating). Regenerate with the script in the
repo history / scratchpad if the tone needs tweaking.