Single Radio - Flutter App for Android and iOS

Single Radio — a beautiful radio app for Android & iOS

Single Radio is a complete Flutter project for a single-station internet radio. Listeners get a glowing player with live spectrum bars, a sea that swells with the music, a sleep timer with a gentle fade-out and real sound effects. You change the name, stream, colours and ad ids in one config file and publish.

A player that shines

Large artwork with a glowing ring and spectrum bars, a drag-to-set volume bar with mute, one-tap controls and the sleep-timer countdown right on the player. Live streams reconnect automatically.

Waves that follow the sound

The sea and the bars react to the real audio: bass lifts the swell, treble moves the outer bars. On Android the app's own playback is analysed (the permission is explained first and is optional); on iOS no permission is needed. Without it a smooth fallback motion is used.

Sleep timer with a gentle fade

Off, 15, 30, 45 or 60 minutes in a quick bottom sheet. The volume fades out during the last minute and the radio stops by itself.

Real sound effects

Normal, Bass Boost, 3D Surround and Vocal Boost, applied by the platform audio engines – Android Equalizer, BassBoost and Virtualizer, and an AVAudioEngine EQ with reverb on iOS.

12 colours, applied everywhere

Bars, artwork ring, sea, buttons, sheets and icons follow the colour the listener picks. Light, dark and auto mode are included.

Light, dark & 5 languages

Every screen is designed for both modes. English, Spanish, French, Portuguese and German are included and a new language is one map in a single file.

Every screen ready

Splash preloader, settings, music quality, social links, about, privacy, more menu (rate, share, help, notifications, language) and a friendly exit popup that can keep the radio playing.

Customize in one file

App name, stream URL, artwork, theme colour, languages, social and privacy links and AdMob ids all live in lib/config/app_config.dart. The documentation walks through rebranding, building the APK / App Bundle and the Google Play forms.

What you get

• Full Flutter source code (Android + iOS)
• HTML documentation and a Google Play checklist
• Original app icon, artwork and graphics you may use in your app

Support and updates

Support through the Codester item page covers installation, configuration and bugs in the item. Custom development and store publishing are not included.

The demo APK uses Google test ads and a public demo stream.

Features

Player

• Live streaming: MP3, AAC, HLS, Icecast / Shoutcast
• Background playback with notification and lock-screen controls
• Volume bar with mute, remembered between launches
• Auto-reconnect when the connection drops
• Music quality: low / medium / high stream URLs

Visuals

• Music visualizer: sea waves and spectrum bars follow the real sound
• Splash preloader that pre-loads the artwork
• 12 theme colours applied everywhere, light / dark / auto mode

Listening tools

• Sleep timer with fade-out in the last minute
• Sound effects: Normal, Bass Boost, 3D Surround, Vocal Boost
• Exit popup: exit or keep playing in the background

App & business

• AdMob banner and interstitial with GDPR consent (UMP)
• 5 languages: English, Spanish, French, Portuguese, German
• Rate, share, help (e-mail), social links, privacy and about pages
• Google Play ready: target SDK 36, 16 KB page size, edge-to-edge, predictive back
• One config file for rebranding

Requirements

• Flutter 3.47 or newer (Dart 3.13+)
• Android Studio with Android SDK 36 for Android builds (app runs on Android 7.0+)
• A Mac with Xcode 16+ for iOS builds (app runs on iOS 13+)
• Your own radio stream URL (MP3, AAC or HLS)
• Optional: a Google AdMob account for ads

Instructions

Run the app

1. Unzip the package and open the single_radio folder in Android Studio or VS Code.
2. Run flutter pub get, then flutter run on a phone or emulator.

Rebrand

1. Edit lib/config/app_config.dart: app name, stream URL, links, theme colour, AdMob ids.
2. Replace the app icon and the package name (step-by-step in the documentation).

Publish

1. Create your upload key and fill android/key.properties.
2. Build with flutter build appbundle --release and follow PLAY_STORE_CHECKLIST.md.

Full guide: documentation/index.html inside the package.