SolarOS 4.17.7 manual · app

webradio

Stream a direct MP3 URL through the default registered audio output. On a graphical display shell, WebRadio opens a two-tab media-player GUI. The GUI uses compact controls, scrolling channels and fitted edit dialogs on small display targets. On UART, USB CDC, Telnet, SSH, and other text shells, it opens a station-list TUI.

The catalog is stored as .solar/webradio/catalog.bin on the current storage root and starts with the Nightride, Chillsynth, Datawave, Spacesynth, Darksynth, Horrorsynth, EBSM, and Rekt streams. Catalog changes survive reboot. On first use after an upgrade, WebRadio moves an older NVS catalog to this file and removes the large NVS blob. reset restores the initial list.

Usage:

webradio
webradio --tui
webradio https://stream.nightride.fm/nightride.mp3
webradio list
webradio add MyStation https://example.net/live.mp3
webradio remove MyStation
webradio reset

--tui forces the station-list TUI even on a graphical shell and can be combined with a direct stream URL. Catalog-management commands also accept it as a harmless interface override.

URLs are literal HTTP or HTTPS MP3 stream URLs. WebRadio does not translate station names or website addresses and does not discover streams from HTML pages. Playlists, HLS, and AAC are unsupported.

Controls:

• Tab switches between the Player and Channels tabs in the GUI.
• The Player tab gives the space above the shared bottom controls to a live PCM oscilloscope or spectrum analyzer. V switches visualizers. The spectrum analyzer shows the frequencies in the playing audio.
• On the Player tab, Left and Right play the previous or next catalog channel. The catalog wraps as a ring. Enter stops playback or reconnects the channel; Space pauses/resumes, and Up/Down changes global volume in five-percent steps.
• The bottom controls show the channel name, playback state and elapsed output time above the volume bar, followed by Previous, Stop/Play, and Next buttons. The buttons support clicking or tapping; the middle icon indicates pause while paused. Live-channel pause uses bounded audio buffers; a server may disconnect during a long pause, requiring reconnection.
• On the Channels tab, Up/Down selects a channel, A adds one, E edits one, and Delete removes one. Enter starts the selected channel and returns to the Player tab. Add and edit dialogs accept a name followed by a literal stream URL.
• The TUI is a single catalog screen. Up/Down or J/K selects a channel, +/- changes output volume, A adds a channel, E edits it, and Delete removes it. Enter plays the selected channel, Space stops playback, and R reconnects it. Add and edit use inline name and URL fields on the catalog screen; Enter advances or saves and Esc cancels.
• Q, Esc, or the app-exit key exits when no catalog dialog is open.

The app is available on Wi-Fi builds even when the board has no built-in audio hardware. Playback starts when a default output device has been registered, including an output supplied by a runtime-attached expansion.

Playback continues when you switch sessions. Closing WebRadio stops reception and playback and releases the output device. The visualizer follows played audio, so it does not run ahead of sound while the stream buffers.