Skip to main content

Play any radio around the globe right from the terminal

Project description

RADIO-ACTIVE

Play any radios around the globe right from your terminal


GitHub PyPI PyPI - Downloads CodeFactor Grade

Features

  • Supports more than 30K stations !!
  • Saves last station information
  • Favorite stations (Aliasing)
  • Supports user-added stations
  • Looks minimal and user-friendly
  • Finds nearby stations
  • No external dependencies!

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 :-

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]

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-favourite-list,-W Optional Show fav list False
--add-to-favourite,-F Optional Add current station to fav list False
--flush Optional Remove all the entries from fav list 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.

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

Buy Me A Coffee

Acknowledgements

Icons made by Freepik from www.flaticon.com

Happy Listening

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

radio-active-2.2.0.tar.gz (11.2 kB view hashes)

Uploaded Source

Built Distribution

radio_active-2.2.0-py3-none-any.whl (20.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page