How devgitpit/supertonic-android works
Supertonic is an Android systemwide text-to-speech app with an in-app reading and playback experience. Users can enter text or choose an ebook, select language and voice settings, then play or export synthesized audio; the app also supports queues, history, saved audio, pronunciation rules, and model downloads. The documented synthesis path normalizes text in Kotlin, chunks it in Rust through JNI, and runs on-device ONNX inference. Several relationships below rely on the README or SOURCE INDEX because the relevant source excerpts are partial; uncertain wiring is omitted.
Main entry points: MainActivity.kt App entry · lib.rs JNI synthesis · PlaybackService.kt Playback service · EbookOutlineActivity.kt Ebook outline
Components 25
Android app
- App entry
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - Main screen
app/src/main/java/com/brahmadeo/supertonic/tts/ui/MainScreen.kt - Model downloads
app/src/main/java/com/brahmadeo/supertonic/tts/ui/DownloadScreen.kt - Model assets
app/src/main/java/com/brahmadeo/supertonic/tts/utils/AssetManager.kt - Playback activity
app/src/main/java/com/brahmadeo/supertonic/tts/PlaybackActivity.kt - Playback screen
app/src/main/java/com/brahmadeo/supertonic/tts/ui/PlaybackScreen.kt - Playback service
app/src/main/java/com/brahmadeo/supertonic/tts/service/PlaybackService.kt - Playback queue
app/src/main/java/com/brahmadeo/supertonic/tts/utils/QueueManager.kt - History store
app/src/main/java/com/brahmadeo/supertonic/tts/utils/HistoryManager.kt - Saved audio
app/src/main/java/com/brahmadeo/supertonic/tts/ui/SavedAudioScreen.kt
Reading and text
- Ebook library
app/src/main/java/com/brahmadeo/supertonic/tts/EbookLibraryActivity.kt - Ebook outline
app/src/main/java/com/brahmadeo/supertonic/tts/EbookOutlineActivity.kt - Book tracking
app/src/main/java/com/brahmadeo/supertonic/tts/utils/EbookManager.kt - Document parser
app/src/main/java/com/brahmadeo/supertonic/tts/utils/EbookParser.kt - Pronunciation rules
app/src/main/java/com/brahmadeo/supertonic/tts/utils/LexiconManager.kt - Text normalization
app/src/main/java/com/brahmadeo/supertonic/tts/utils/TextNormalizer.kt - Number expansion
app/src/main/java/com/brahmadeo/supertonic/tts/utils/NumberUtils.kt
Speech engine
- System TTS service
app/src/main/java/com/brahmadeo/supertonic/tts/service/SupertonicTextToSpeechService.kt - JNI engine API
app/src/main/java/com/brahmadeo/supertonic/tts/SupertonicTTS.kt
Rust processing
- JNI synthesis
rust/src/lib.rs - Language chunking
rust/src/lang/mod.rs - Synthesis helper
rust/src/helper.rs - Thermal control
rust/src/thermal.rs - Audio filtering
rust/src/filter.rs
Other components
- User
Connections 30
- User → App entry: opens app
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - App entry → Main screen: shows
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - App entry → Playback service: binds
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - App entry → Model assets: loads models
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - App entry → Model downloads: shows
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - Model downloads → Model assets: downloads
- App entry → History store: uses history
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - App entry → Playback queue: uses queue
app/src/main/java/com/brahmadeo/supertonic/tts/MainActivity.kt - User → Ebook library: chooses book
app/src/main/java/com/brahmadeo/supertonic/tts/EbookLibraryActivity.kt - Ebook library → Book tracking: tracks books
app/src/main/java/com/brahmadeo/supertonic/tts/EbookLibraryActivity.kt - Ebook library → Ebook outline: opens outline
app/src/main/java/com/brahmadeo/supertonic/tts/EbookLibraryActivity.kt - Ebook outline → Document parser: parses content
app/src/main/java/com/brahmadeo/supertonic/tts/EbookOutlineActivity.kt - Ebook outline → Book tracking: records book
app/src/main/java/com/brahmadeo/supertonic/tts/EbookOutlineActivity.kt - Ebook outline → Playback activity: starts reading
app/src/main/java/com/brahmadeo/supertonic/tts/EbookOutlineActivity.kt - Playback activity → Playback screen: shows
app/src/main/java/com/brahmadeo/supertonic/tts/PlaybackActivity.kt - Playback activity → Playback service: binds
app/src/main/java/com/brahmadeo/supertonic/tts/PlaybackActivity.kt - Playback service → Playback queue: manages queue
app/src/main/java/com/brahmadeo/supertonic/tts/service/PlaybackService.kt - Playback service → Text normalization: normalizes text
app/src/main/java/com/brahmadeo/supertonic/tts/service/PlaybackService.kt - Text normalization → Number expansion: expands numbers
app/src/main/java/com/brahmadeo/supertonic/tts/utils/TextNormalizer.kt - Text normalization → Pronunciation rules: applies rules
app/src/main/java/com/brahmadeo/supertonic/tts/utils/TextNormalizer.kt - Playback service → JNI engine API: synthesizes
app/src/main/java/com/brahmadeo/supertonic/tts/service/PlaybackService.kt - System TTS service → Text normalization: normalizes input
app/src/main/java/com/brahmadeo/supertonic/tts/service/SupertonicTextToSpeechService.kt - System TTS service → JNI engine API: synthesizes
app/src/main/java/com/brahmadeo/supertonic/tts/service/SupertonicTextToSpeechService.kt - JNI engine API → JNI synthesis: calls JNI
rust/src/lib.rs - JNI synthesis → Language chunking: chunks text
rust/src/lib.rs - JNI synthesis → Synthesis helper: uses helpers
rust/src/lib.rs - JNI synthesis → Thermal control: controls thermal
rust/src/lib.rs - Synthesis helper → Language chunking: uses normalizers
rust/src/helper.rs - JNI synthesis → Audio filtering: filters audio
rust/src/lib.rs - User → Saved audio: manages audio