radio-active 2.6.0

Play any radio around the globe right from the terminal

RADIO-ACTIVE

Play any radios around the globe right from your terminal

---

Join Discord Server

Features

• Supports more than 40K stations !! :radio:
• Saves last station information
• Favorite stations (Aliasing) :heart:
• Selection menu for favorite stations
• Supports user-added stations :wrench:
• Looks minimal and user-friendly
• Runs on Raspberry-Pi
• Finds nearby stations
• Discovers stations by genre
• Discovers stations by language
• I'm feeling lucky ! Play Random stations
• Record audio from live radio on demand :zap:

See my progress here

External Dependency

It needs FFmpeg to be installed on your system in order to play the audio

on Ubuntu based system >= 20.04 Run

sudo apt update
sudo apt install ffmpeg

For other systems including windows see the above link

Installing FFmpeg

FFmpeg is required for this program to work correctly. Install FFmpeg by following these steps :-

• On Linux - https://www.tecmint.com/install-ffmpeg-in-linux/
• On Windows - https://www.wikihow.com/Install-FFmpeg-on-Windows

Install

Just run: pip3 install --upgrade radio-active

I encourage you to install with pipx: pipx install radio-active

Run

Run with radioactive --station [STATION_NAME] or as simply radio -U [UUID] :zap:

Tips

1. Use a modern terminal emulator, otherwise the UI might break! (gets too ugly sometimes)
2. On Windows, instead of default Command Prompt, use the new Windows Terminal or web-based emulators like hyper,Cmdr,Terminus etc. for better UI
3. Let the app run for at least 5 seconds (not a serious issue though, for better performance)

Demo

---

Options

Argument	Note	Description	Default
--station, -S	Required (Optional from second run)	Station name	None
--uuid, -U	Optional	ID of the station	None
--log-level, -L	Optional	Log level of the program	Info
--add-station , -A	Optional	Add an entry to fav list	False
--show-favorite-list,-W	Optional	Show fav list	False
--add-to-favorite,-F	Optional	Add current station to fav list	False
--flush	Optional	Remove all the entries from fav list	False
--discover-by-country,-D	Optional	Discover stations by country code	False
--discover-by-state	Optional	Discover stations by country state	False
--discover-by-tag	Optional	Discover stations by tags/genre	False
--discover-by-language	optional	Discover stations by	False
--limit	Optional	Limit the # of results in the Discover table	100
--volume	Optional	Change the volume passed into ffplay	80
--kill	Optional	Kill background radios.	False

---

--station, -S : Expects a station name to be played (if not provided it will try to get the last played station). Example: "pehla nasha" , pehla_nasha, bbc_radio

--uuid,-U : When station names are too long or confusing (or multiple results for the same name) use the station's uuid to play . --uuid gets the greater priority than --station. Example: 96444e20-0601-11e8-ae97-52543be04c81

--log-level, -L : don't need to specify unless you are developing it. info , warning , error , debug

-F : Add current station to your favorite list. Example: -F my_fav_1

-A: Add any stations to your list. You can add stations that are not currently available on our API. When adding a new station enter a name and direct URL to the audio stream.

Changes

see CHANGELOG

Community

Share you favorite list with our community 🌐 ➡️ Here

Your favorite list .radio-active-alias is under your home directory as a hidden file :)

Extra

If you ever face a situation where radio-active quits but the audio (ffplay) runs in the background. Kill the process ID (PID) of ffplay. Run ps -al get the PID of ffplay and kill [PID]. I know you Know that :)

Support

Visit my contribution page for more payment options.

Acknowledgements

Icons made by Freepik from www.flaticon.com

Happy Listening

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Joe Smith ⚠️ 💻 🤔

salehjafarli 💻

This project follows the all-contributors specification. Contributions of any kind welcome!