px7-radio 0.1.0

Terminal-based internet radio player

PX7 Terminal Radio

PX7 Terminal Radio is a lightweight command-line internet radio player written in Python. It allows you to search, stream, and control thousands of online radio stations directly from your terminal., and now also supports streaming audio from YouTube search results.

Stations are fetched using the Radio Browser API, and playback is handled through VLC.

Table of Contents

• Features
• Requirements
• Installation
• Usage
• Radio Commands
• YouTube Commands
• License

Features

New Feature

• Search and stream audio from YouTube

Legacy Features

• Search internet radio stations
• Stream radio directly from the terminal
• Filter and sort stations using API options
• Control playback (play, pause, resume, stop)
• Lightweight command-line interface

---

Requirements

• Python 3.9+
• VLC Media Player

Installation

1. Clone the repository:

If you just want to use:

git clone --depth 1 https://github.com/px7nn/px7-radio.git
cd px7-radio

else:

git clone https://github.com/px7nn/px7-radio.git
cd px7-radio

2. Install Python dependencies

pip install -r requirements.txt

3. Run the application

python main.py

After starting, you will see the terminal prompt:

>>

You can now search and play radio stations. Example:

>> radio search lofi
>> play 1

Usage

Radio Commands

Command	Description
radio search <query>	Search radio stations by name
radio search --tag=<tag>	Search stations by tag (e.g., jazz, lofi)
radio search --country=<country>	Filter stations by country
radio search --language=<language>	Filter stations by language
radio search --limit=<number> <query>	Limit the number of results
radio search --order=votes	Sort results (e.g., clickcount, votes, bitrate)
play <index>	Play a station from the search results
pause	Pause playback
resume	Resume playback
stop	Stop playback

Additional filters and parameters are supported since PX7 Terminal Radio is compatible with the Radio Browser API.

You can pass API parameters using the format: --parameter=value

Example:

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

For the complete list of supported parameters, see the Radio Browser API documentation:
https://www.radio-browser.info/

YouTube Commands

PX7 Terminal Radio can also stream audio from YouTube search results directly in the terminal.

Command	Description
yt search <query>	Search YouTube and stream results
yt search <query> --limit=<number>	Limit the number of search results
yt search <query> --no-postfix	Search without modifying the query

Default Query Postfix

By default, the command:

>> yt search <query>

internally modifies the query:

query += DEFAULT_QUERY_POSTFIX

DEFAULT_QUERY_POSTFIX = " original audio song" This helps return better audio-focused results (for example music or long mixes).

If you want to search YouTube without modifying the query, use:

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

Example:

>> yt search joji
>> yt search the weeknd lofi one hour --no-postfix

License

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