"Search, bookmark, and stream internet radio stations directly from your terminal."

Xradios is a terminal tool to discover and streaming radio stations worldwide.

• Search: Find radio stations by name, genre, country, language or other criteria.
• Stream: Play radio stations directly in your terminal.
• Interactive Interface: Navigate and control playback with keyboard shortcuts.
• Bookmarks: Save stations for quick access. (TODO)

• Python 3.8 or higher
• mpv or libmpv for audio playback

pipx install xradios

pip install --user xradios

Start the server:

xradiosd

Launch the interactive interface:

xradios

• Open command line: Press :
• Navigate: Use Ctrl + UP/Ctrl + DOWN to move focus.
• Search for stations: search tag=rock limit=100 order=votes
• Play a station: Select a station with UP/DOWN and press ENTER.
• Exit: Press Ctrl + q

Press ? to see a complete list of shortcuts and commands.

1. Clone the repository:

git clone git@github.com:andreztz/xradios.git
cd xradios

2. Install in editable mode with development dependencies:

pip install -e .

3. Run tests:

pytest

Contributions are welcome! Please open an issue or submit a pull request.
See CONTRIBUTING.md for guidelines.

• No audio? Ensure mpv or libmpv is installed and accessible in you PATH.

André P. Santos – @ztzandre – andreztz@gmail.com

Distributed under the MIT license. See LICENSE for details.

GitHub: https://github.com/andreztz/xradios