Android app · Audio

AuraSound

Audio utility app for focused playback, sound control, and everyday listening workflows.

Get it on Google Play ↗ Source on GitHub ↗

AuraSound is an offline Android ambient sound mixer for focus, relaxation, meditation, and sleep. It lets users layer local sound loops, tune each channel, save favorite mixes, and start a sleep timer without signing in or streaming audio.

Project Overview

AuraSound turns a phone or tablet into a calm, private soundscape studio. It is designed for people who want background audio for deep work, studying, meditation, noise masking, or winding down at night. There is no hosted demo because this is a native Android app; Google Play listing assets are

Key Features

• 🎚️ Mix up to four sounds at once with individual volume controls for every channel.
• 🌧️ Choose from 18 bundled offline tracks across Focus, Nature, Ambient, and Sleep categories.
• 💾 Save named presets locally and reload favorite combinations from on-device storage.
• ⏲️ Start a sleep timer with configurable duration and smooth fade-out behavior.
• 📱 Use a phone navigation flow or an adaptive tablet split-pane interface.
• 🔁 Loop local Ogg audio assets through AndroidX Media3 ExoPlayer.
• 🛍️ Generate Play Store screenshots, feature graphics, and app icons from Roborazzi tests.

Architecture Overview

Components And Layers

AuraSound uses a compact MVVM structure. Compose screens in feature/ render state from ViewModels, ViewModels depend on repository interfaces in core/data/repository/, and concrete implementations in data/ handle playback, sound catalog access, presets, and timers.

ServiceLocator wires application-level dependencies when AuraSoundApp starts. MixerEngine owns the Media3 ExoPlayer instances for active channels. Presets are serialized with Moshi and stored locally with Preferences DataStore.

Request And Data Flow

A mixer action starts in MixerScreen, updates MixerViewModel, and calls MixerRepository. The repository updates Kotlin StateFlow values for UI state and forwards playback commands to MixerEngine. Timer and preset flows reuse the same repository layer so playback state stays centralized.

Design Patterns

• MVVM with Compose state collected from Kotlin StateFlow.
• Repository interfaces separating UI logic from data and playback details.
• Service locator dependency wiring without a full DI framework.
• Local-first persistence for presets and bundled asset playback.

Tech Stack & Libraries

Configuration

Release signing uses key.properties when present. If that file is missing, the release build falls back to KEYSTORE_PATH, STORE_PASSWORD, and KEY_PASSWORD.

Usage / Quick Start

Build And Run The App

./gradlew :app:assembleDebug
./gradlew :app:installDebug

Open AuraSound, add tracks from the category tabs, adjust channel volumes, and press play to start the mix.

Generate Store Assets

./gradlew generatePlayStoreAssets

screenshots, a feature graphic, and a 512 px icon.

Refresh Audio Assets

export FREESOUND_TOKEN="your-token"
python3 scripts/fetch_sounds.py

This refreshes CC0/public-domain nature, ambient, and sleep tracks, normalizes them with ffmpeg, and updates app/src/main/assets/sounds/CREDITS.txt. The focus noise tracks are generated by the Gradle generateAmbientSounds task.

API Reference

Not applicable. AuraSound is a local Android app and does not expose an HTTP API, CLI API, or public SDK. Retrofit and OkHttp are listed in the Gradle catalog, but the current source tree does not define network clients or endpoints.

Testing

Run local JVM, Robolectric, and non-screenshot tests:

./gradlew :app:testDebugUnitTest

Run instrumented tests on a connected Android device or emulator:

./gradlew :app:connectedDebugAndroidTest

Record Roborazzi screenshots directly:

./gradlew :app:recordRoborazziDebug

Generate the Play Store screenshot suite:

./gradlew generatePlayStoreAssets

Unit and Robolectric tests live in app/src/test/java/. Instrumented tests live in app/src/androidTest/java/. Screenshot tests are categorized with com.michael.aurasound.playstore.PlayStoreScreenshotTests and are excluded from ordinary testDebugUnitTest runs. Coverage reporting is not configured.

Deployment

Debug Build

./gradlew :app:assembleDebug

Debug builds use the local debug signing configuration.

Release APK

./gradlew :app:assembleRelease

Release App Bundle

./gradlew :app:bundleRelease

Docker and Docker Compose are not applicable because this repository ships a native Android app, not a server process. Health checks are not applicable; validate release candidates by installing the build on a test device and checking audio playback, preset persistence, timer fade-out, and generated store assets.