SonicSyncSail Logo

SonicSyncSail

Home Features About Blog FAQ

Radio Streaming

📑 Table of Contents
  • 1. Overview
  • 2. Library Organization
  • 3. Adding Custom Radio Stations
  • 4. Edge Cases & Safeguards
  • 5. Known Limitations
  • 6. Future Enhancements

1. Overview

SonicSyncSail’s Radio Streaming module provides users with a powerful and organized way to explore, stream, and record online radio stations. The system includes a structured radio library, the ability to add custom radio stations securely, full-text search, logo caching, and an advanced recording interface with waveform visualization.

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.
Documentation: Radio Streaming
Back to Docs Home
© SonicSyncSail 2025 · v1.0
GitHub🐙 GitHub GitHub🔗 LinkedIn 📧 contact@sonicsyncsail.com Privacy Policy Terms & Conditions Data Deletion Request