InternetRadio

InternetRadio is an Android app for discovering and listening to radio stations from around the world, with features like favorites, recent history, and advanced search by country,language and tags.

Join the Telegram community for discussions, feedback, and announcements, sharing stations:

• Global Radio Access: Browse and stream thousands of radio stations globally.
• Search, Filter & Sort: Easily find stations by country, language, or tags, with advanced sorting options.
• Library & Customization: Manage station Library. Edit any station and configure the startup screen.
• Android TV Support: Enjoy a fully optimized and tailored experience on Android TV devices.
• Android Auto Support: Support for car screen via android auto.
• FCast Support: Cast and control radio stations on FCast-compatible devices.
• Recording & Scheduling: Record live streams to your device or set schedules for automated playback and recording.
• Recent History: Keep track of your recently played streams.
• Backup & Restore: Easily backup and restore your library and app settings.
• Modern UI: Built with Jetpack Compose for a smooth, intuitive, and responsive experience across phones, tablets, and widescreen devices.

• Language: Kotlin
• UI Framework: Jetpack Compose
• Database: Room
• Dependency Injection: Hilt
• API: Radio Browser API

To build InternetRadio from source, ensure you have the latest version of Android Studio installed.

1. Clone the repository:

   git clone https://github.com/armanmaurya/internetradio.git

2. Open the project in Android Studio.
3. Wait for Gradle sync to complete.
4. Run the app on a physical device or emulator.

If FCast is not discovering or connecting to your device on desktop Linux, your firewall may be blocking the required ports. This is a known issue with UFW and similar firewall tools. To allow FCast connections, run:

sudo ufw allow 46899/tcp
sudo ufw allow 46899/udp

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Please see CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Translations are managed on Weblate — no local setup needed, contribute directly from your browser.

InternetRadio uses the following open-source libraries:

• Android Jetpack Libraries (Compose, Room, Media3, Lifecycle, Navigation, DataStore, etc.)
• Hilt - A dependency injection library for Android.
• Radio Browser API - A community-driven effort to collect radio stations.
• FCast - An open-source protocol for wireless streaming.

• Maintendo - app logo.

This project is licensed under the GNU GPL v3 License - see the LICENSE file for details.