StreamRadio

StreamRadio is an Obsidian plugin for listening to web radio stations from radio-browser.info, searching and saving favorites, and which lives in the right sidebar. As an additional option, it also provides a highly customizable and appealing Pomodoro timer for working focused on your tasks, accompanied by the tunes you favor.

Features

• Search stations by name, country, language, and tag through the radio-browser.info API.
• Preview stations directly in the search dialog before saving them in your favorites list.
• Re-order favorites with drag and drop in the settings tab.
• Show or hide station logos in the player.
• Start, pause, skip to the previous or next favorit station.
• Adjust playback volume with a slider in the player.
• Start a timer with 5, 10, 15, 30, 45, 60, 120 minutes, or a custom minute value.
• Run Pomodoro focus sessions with short and long breaks while listening to streams.
• Customize Pomodoro durations, interval count, long-break cadence, and focus/break colors.

Player

StreamRadio adds a radio icon to the left ribbon. The icon opens the StreamRadio player in Obsidian's right sidebar. If the sidebar already contains other views, StreamRadio opens as another tab.

The player shows:

• Station logo, when enabled and available
• Station name
• Country and language information
• Codec and bitrate
• Playback controls
• Volume slider
• Timer status
• Optinal: Pomodoro timer with interval markers, focus/break labels, countdown ring, and start, pause, restart, skip, and reset controls

Settings

The settings tab contains:

• A release notes button styled as a primary action.
• A toggle for station logos in the player.
• A button for opening the station search modal.
• The saved favorites list.
• A Pomodoro section for enabling the timer, setting focus and break durations, choosing focus, short-break, and long-break colors, selecting the number of intervals, and configuring when long breaks occur.

The search modal shows 20 results per page and displays the current page with the total page count. Additional results can be reached with previous and next arrow buttons. Every result row shows station logo, station name, codec, bitrate, a favorite checkbox, and a preview play button.

radio-browser.info

StreamRadio uses the public radio-browser.info API:

• https://all.api.radio-browser.info/json/countries
• https://all.api.radio-browser.info/json/languages
• https://all.api.radio-browser.info/json/tags
• https://all.api.radio-browser.info/json/stations/search

The plugin uses Obsidian's requestUrl API for network requests. StreamRadio is a desktop-only Obsidian plugin and supports Windows, macOS, and Linux.

Obsidian guidelines

StreamRadio follows the Obsidian plugin guidelines:

• It uses the plugin instance this.app instead of the global app object.
• It avoids direct file system access.
• It stores plugin settings through Obsidian plugin data APIs.
• It uses Obsidian DOM helper methods instead of HTML string injection.
• It avoids innerHTML, outerHTML, and insertAdjacentHTML.
• It uses CSS classes and Obsidian CSS variables instead of hardcoded inline styling.
• It uses the Obsidian accent color variables for the default Pomodoro focus color.
• It does not set default hotkeys.
• It cleans up audio playback and timers on unload.

Disclosures

• This plugin uses the network to search and play public web radio streams.
• Station search data comes from radio-browser.info.
• Playback connects directly to the stream URL provided by each station.
• This plugin does not require an account.
• This plugin does not require payment for full functionality.
• This plugin does not include telemetry.
• This plugin does not show ads.
• This plugin does not read or write notes in your vault.

Limitations

• Desktop only. Mobile Obsidian is not supported.
• Supported operating systems are Windows, macOS, and Linux.
• Stream availability depends on the station data provided by radio-browser.info and the radio station itself.
• Browser audio playback does not expose ICY stream metadata in a reliable cross-platform way. StreamRadio does not display live artist or song metadata.
• Drag and drop in the favorites list uses standard browser drag events because Obsidian does not provide a dedicated reorder-list component.
• Notebook Navigator compatibility does not require a special integration because StreamRadio does not add file explorer or note context menu actions.

License

MIT

Donations

• PayPal.me