RadioWave

Deutsch | English

The modern, ad-free internet radio app for Android.

Fast | Privacy-first | No tracking | 45,000+ stations

Project website: radiowave.sven-neurath.de

---

Roadmap

The public roadmap is available in ROADMAP.md.

• Focus: stability and user value
• Updated continuously with releases and polish passes
• Feedback is welcome through GitHub Issues
• RadioWave is live on Google Play; beta/sideload notes now only apply to GitHub APKs and test installs

Availability

• Website: https://radiowave.sven-neurath.de
• Google Play: https://play.google.com/store/apps/details?id=de.darksoon.radiowave
• GitHub Releases: https://github.com/darksoon/RadioWave/releases/latest
• Android package / applicationId: de.darksoon.radiowave

Highlights

• No account required; favorites, history and settings stay on the device
• Completely ad-free, no analytics, no behavior tracking
• 45,000+ stations via Radio Browser
• Album art lookup via the iTunes Search API
• Launcher quick actions for Search, Favorites, Player, and Settings
• Android Auto support with favorites, quick access, search, and previous/next in the car player
• Chromecast / Google Cast support with direct route selection from the player
• Sleep timer and direct share action in the fullscreen player
• Free EQ presets (Bass Boost, Treble Boost, Vocal) — no paywall
• Favorites backup/restore (JSON) and bulk station import from M3U/PLS playlists
• Local crash-report export with share action and prefilled GitHub issue handoff

Screenshots

Home	Search

Favorites	Fullscreen Player	Settings

Android Auto 1	Android Auto 2

Android Auto 3	Android Auto 4

Tech Stack

• Kotlin 2.1.0
• Jetpack Compose + Material 3
• Clean Architecture + MVVM
• Hilt
• Media3 / ExoPlayer
• Room
• Retrofit + Kotlinx Serialization

Quick Start

git clone https://github.com/darksoon/RadioWave.git
cd RadioWave
chmod +x gradlew
./gradlew :build-logic:build
./gradlew assembleDebug

Local Builds

# Full build
./gradlew build

# Lint + tests
./gradlew lint
./gradlew test

# Install debug APK
./gradlew installDebug

# GitHub-flavor debug build
./gradlew :app:assembleGithubDebug

# Play Store debug build
./gradlew :app:assemblePlayDebug

Restricted Networks / Proxy

If Gradle downloads are blocked, use a mirror or proxy:

# ~/.gradle/gradle.properties
systemProp.http.proxyHost=<proxy-host>
systemProp.http.proxyPort=<proxy-port>
systemProp.https.proxyHost=<proxy-host>
systemProp.https.proxyPort=<proxy-port>

Release Signing

Signed release builds are handled through GitHub Actions.

• For GitHub/direct download use the signed github APK
• For Google Play distribution use the signed play App Bundle (.aab)

For local signing experiments only:

cp keystore.properties.example keystore.properties
# edit keystore.properties

Installation

Google Play

Install RadioWave from Google Play:

https://play.google.com/store/apps/details?id=de.darksoon.radiowave

GitHub APK

1. Open the latest release page: https://github.com/darksoon/RadioWave/releases/latest
2. Download the current APK asset.
3. Allow installs from unknown sources if your device asks for it.
4. Open the APK and install it.

Player Improvements

• Short network interruptions are handled more gracefully with improved reconnect tuning
• The playback timer now reflects actual listening time and pauses during buffering
• Fullscreen player includes a share action and a sleep timer
• Favorites can be reordered more easily from the favorites screen
• Active Chromecast sessions can be started directly from the fullscreen player, station changes are handed over to TV, and in-app play/pause controls route to the cast device

Android Auto

• Browse is optimized for in-car usage: Favorites, Quick Access, Top Stations, Genres
• Quick Access combines favorites and recents
• Search merges local and remote results more robustly
• Previous/next in the car player now works as real station navigation
• Browse/search callbacks run asynchronously so Android Auto is not blocked by repository or network work
• The player only holds the WiFiLock while the active network is Wi-Fi; WakeLock stays active for stable playback

See also: docs/ANDROID_AUTO_DEV_MODE.md

Chromecast / Google Cast

• Cast devices can be selected directly from the fullscreen player
• Starting a cast session moves the current station to TV and stops parallel phone playback
• Changing stations while casting updates the TV stream instead of starting a separate local stream
• In-app play/pause controls work on the active cast session
• The player UI shows when playback is currently running on TV
• Alexa / Echo streaming is not part of this cast integration and would require a separate Amazon-specific solution

GitHub Actions

Manual Android Build

Available under Actions -> Manual Android Build -> Run workflow.

PR CI

• Runs automatically on pushes and pull requests to main
• Can also be started manually
• Uses Gradle build cache plus configuration cache
• Test-task gating is configuration-cache-safe, so CI no longer breaks on modules without unit tests

Release Build

• Signed releases are created through Actions -> Release Build
• The workflow:
  • updates app.versionName and app.versionCode
  • builds a signed Play APK plus a Play Store App Bundle (.aab)
  • creates a tag and GitHub release
  • uploads release assets, including native debug-symbol artifacts for Play Console troubleshooting
• Workflows are prepared for the GitHub Actions Node 24 migration (actions/checkout@v5)

Privacy

• No analytics, no ads, no account, no tracking SDKs
• Favorites, history, custom stations and settings are stored only on the device
• Crash reports are stored locally only and shared explicitly by the user

An internet radio app has to talk to the internet. These are all connections RadioWave makes:

Destination	When	What is sent	How to turn it off
Radio Browser API (all.api.radio-browser.info)	Browsing, search, top list, genres/countries, station-quality lookup, offline directory sync	Search terms, filters and station IDs, plus your IP address	Required for the directory; the offline directory (Settings -> Storage & Data) reduces live requests
Radio Browser click counter (json/url/<station-id>)	Once per station session after the stream started playing	The station ID (and your IP address) — feeds the community popularity ranking	Settings -> Storage & Data -> Privacy -> "Report station plays to Radio Browser"
iTunes Search API (itunes.apple.com)	When a station sends artist/title and no own cover	Artist and title of the current song (and your IP address)	Settings -> Storage & Data -> Privacy -> "Look up song covers online" (the station logo is shown instead)
Station stream hosts	While playing	A normal HTTP(S) request for the stream (IP address, RadioWave/1.0 user agent)	Inherent to playback; plain-HTTP stations can be hidden in Settings -> Storage & Data
Station logo / cover image hosts	When a list, the player, the notification or Android Auto shows a logo or cover	An image request to the host named in the directory entry (IP address)	Not configurable
Google Cast (Google Play services, Default Media Receiver)	Only when you open the Cast dialog or cast	Device discovery on the local network; while casting, the stream URL, station name and logo URL go to the Cast device, which then connects to the stream host itself	Don't use Cast
GitHub	Only when you tap a GitHub link or "Open GitHub issue"	Whatever you choose to submit there	Don't tap it

The app does not send playback history, favorites or device identifiers anywhere.

License

RadioWave is licensed under the GNU General Public License v3.0 or later. See LICENSE.txt.

For source files, Kotlin code uses SPDX-License-Identifier: GPL-3.0-or-later.

Links

• Website: https://radiowave.sven-neurath.de
• Google Play: https://play.google.com/store/apps/details?id=de.darksoon.radiowave
• GitHub Releases: https://github.com/darksoon/RadioWave/releases/latest
• Ko-fi: https://ko-fi.com/darksoon

Credits

• Station data: Radio Browser API
• Album art: iTunes Search API
• Icons: Material Design Icons