SonicSyncSail Logo SonicSyncSail™

Radio Streaming

Browse internet radio stations or add a custom HTTPS stream. Listening requires an internet connection; station availability and content depend on third-party stream providers.

📑 Table of Contents

1. Overview

SonicSyncSail’s Radio Streaming module provides users with a powerful and organized way to explore, stream, and listen to online radio stations. The system includes a structured radio library, custom radio stations, full-text search, and logo caching. Streaming requires an internet connection.

2. Library Organization

The Radio Streaming library is preloaded from bundled assets on the first app launch. This initial load saves all built-in radio stations into the Room database, enabling instant access and offline-ready metadata. Once populated, stations are organized into multiple browsing categories for intuitive exploration.

2.1 Categories Supported

  • Genre List – Stations grouped by music genre.
  • Country List – Stations grouped by broadcasting country.
  • Language List – Stations grouped by primary language.
  • All Stations – Inclusive list of all stored stations.

2.2 Search Functionality

Users can search across station names, genres, countries, and languages with real-time filtering for fast discovery.

2.3 Logo Caching

Logos for radio stations are cached locally, improving loading performance, scrolling fluidity, and reducing repeated network requests.

3. Adding Custom Radio Stations

SonicSyncSail includes a dedicated workflow that enables users to add their own radio stations securely. Each addition is validated before saving, ensuring high playback reliability.

3.1 Fields Users Can Enter

  • Station Name
  • Station Stream URL (HTTPS only)
  • Station Icon URL (HTTPS only)

3.2 Stream & Icon URL Validation

The Add button remains disabled until both the stream URL and icon URL successfully pass validation. A lightweight test connection ensures the URLs are accessible and safe.

3.3 Duplicate Detection

If a station already exists in the preloaded Room database, the Add button is replaced with “Add to Favorites”, preventing duplicates while keeping the workflow user-friendly.

3.4 Editing & Deleting

Currently, SonicSyncSail does not provide UI for editing or deleting custom stations. These enhancements are planned for future updates.

4. Edge Cases & Safeguards

  • No custom stations allowed without valid HTTPS URLs.
  • Search may return empty lists based on filters.
  • If no built-in stations exist, the library rebuilds from bundled assets.

5. Known Limitations

  • No UI for editing or removing custom stations.
  • No auto-fetching or validation for non-HTTPS URLs.

6. Future Enhancements

  • Custom station editing and deletion tools.