🎧 PX7 Terminal Radio

PX7 Terminal Radio is a lightweight, feature-rich command-line internet radio player built in Python.

It lets you search, stream, and control thousands of radio stations directly from your terminal, with added support for streaming audio from YouTube search results.

Powered by the Radio Browser API and VLC, PX7 delivers a fast and minimal listening experience without leaving your terminal.

Features

• Search and stream internet radio stations
• Filter stations by tag, country, language, bitrate, and more
• Sort results using API parameters (votes, click count, etc.)
• Playback controls: play, pause, resume, stop
• Lightweight and fast CLI interface
• Stream audio directly from YouTube search results

Requirements

• Python 3.9+
• VLC Media Player (required for audio playback)

Installation

Install via pip (Recommended)

pip install px7-radio

Usage

Start the application:

px7-radio

If the command doesn't work, you can run:

python -m px7_radio

You will see a prompt:

>>

Radio Commands

Advanced Filtering

PX7 supports full Radio Browser API parameters:

radio search lofi --limit=5
radio search --tag=jazz --country=US
radio search chill --order=clickcount

API Docs: https://www.radio-browser.info/

YouTube Commands

Stream audio directly from YouTube search results:

Smart Query Enhancement

By default:

>> yt search <query>

Automatically becomes:

<query> original audio song

This improves audio-focused results (songs, mixes, etc.)

Disable it with:

>> yt search <query> --no-postfix

Example Usage

📜 License

This project is licensed under the MIT License.
See the LICENSE file for details.