avi/S.H.O.N.A.R.
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
S.H.O.N.A.R. — Self-Hosted Oral Notes and Audio Recorder. Shonar is a hushed, offline-only mobile recorder for life's conversations, where one-tap memos live in a folder you own and never touch the cloud.
64 commits 1 branch 0 tags 246 MiB
  • Kotlin 93.8%
  • Shell 6.2%
Find a file
Exact
avi d6b55d79d6
Some checks failed
CI / android (push) Has been cancelled
Details
Add Shonar Android launcher icon
2026-10-06 14:35:36 -05:00
.github Local-only app: remove network, uploads, providers, backend, desktop 2026-09-14 11:56:20 -05:00
android Widget instant start: sync consent cache, plain banner with actions 2026-10-06 14:31:08 -05:00
data/storage Checkpoint: current Shonar state 2026-09-23 18:58:28 -05:00
deferred/home-assistant Product pivot: defer Home Assistant; provider-based server architecture (Nextcloud default) 2026-09-08 18:19:57 -05:00
docs Local-only app: remove network, uploads, providers, backend, desktop 2026-09-14 11:56:20 -05:00
.gitignore Checkpoint: current Shonar state 2026-09-23 18:58:28 -05:00
.icon.png Checkpoint: current Shonar state 2026-09-23 18:58:28 -05:00
CODE_OF_CONDUCT.md M0: repo scaffold, backend skeleton, schema + migrations, dev compose, docs 2026-09-08 13:23:45 -05:00
CONTRIBUTING.md P3-M7: providers, background sync, AI pipeline 2026-09-12 11:29:55 -05:00
DesignReferenceShonar.png Checkpoint: current Shonar state 2026-09-23 18:58:28 -05:00
Icon_Shonar_android.png Add Shonar Android launcher icon 2026-10-06 14:35:36 -05:00
LICENSE M0: repo scaffold, backend skeleton, schema + migrations, dev compose, docs 2026-09-08 13:23:45 -05:00
README.md Update README.md 2026-09-15 16:01:59 +00:00
SECURITY.md M0: repo scaffold, backend skeleton, schema + migrations, dev compose, docs 2026-09-08 13:23:45 -05:00

README.md

S.H.O.N.A.R.

S.H.O.N.A.R. — Self-hosted Oral Notes and Audio Recorder (local-only)

Record conversations on your Android phone and keep them in a folder you control. No accounts, no servers, no uploads, no telemetry — the app has no network permission at all. If you want your recordings on other machines, sync the folder yourself (Syncthing, Nextcloud); the app adopts files added from outside into its library automatically.

  • Record with one tap (app, notification, or home-screen widget), pause / resume, save with rename, play back with seek + speed.
  • Library lives in a folder on the phone (Music/Recordings by default; change it in Settings → Library folder); rename and delete move together with the audio file.
  • Apache-2.0 licensed.

Repository layout

android/           Android app (Kotlin, Jetpack Compose, Material 3)
docs/              Recording-consent notice

Quick start (Android)

Requirements: JDK 17, Android SDK (platform 35). See android/README.md.

cd android
./gradlew assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk

Development

cd android && ./gradlew test

Legal notice

You are responsible for complying with recording-consent laws in your jurisdiction. Many jurisdictions require all-party consent to record a conversation. S.H.O.N.A.R. shows this notice in-app and never records without a visible, persistent recording indicator and an obvious stop control.