• Stars
    star
    164
  • Rank 230,032 (Top 5 %)
  • Language
    Python
  • License
    MIT License
  • Created over 3 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Play any radios around the globe right from the terminal ⚑

RADIO-ACTIVE

Play any radios around the globe right from your terminal

radio-active - Play more than 30K radio stations from your terminal | Product Hunt

UPI


GitHub PyPI PyPI - Downloads CodeFactor Grade Discord

YouTube Video Likes and Dislikes

Join Discord Server

Features

  • Supports more than 30K stations !!
  • Saves last station information
  • Favorite stations (Aliasing)
  • Supports user-added stations
  • 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
  • No external media player dependency!

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

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] ⚑

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 atleast 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-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
--discover-by-country,-D Optional Discover stations by country code false
--discover-by-state Optioanl Discover stations by country state false
--discover-by-tag Optional Discover stations by tags/genre fasle
--discover-by-language optional Discover stations by false
--limit Optional Limit the # of results in the discover table 100

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

Buy Me A Coffee

Acknowledgements

Icons made by Freepik from www.flaticon.com

Happy Listening

More Repositories

1

HighlightedCS

Popular computer science books (PDF) with highlighting :) add yours now
69
star
2

Mr.Dclutterer

A minimal looking cross-platform desktop application made with Electron that handles quick file aggregation and bulk renaming.
JavaScript
36
star
3

cppcheck-action

A github action to perform C/C++ security checks automatically
C
29
star
4

programming-memes

collection of thousands of programming memes WIP
Python
24
star
5

qikQR

minimal desktop app to create QR codes.
CSS
23
star
6

awesome-lightroom-presets

5000 (and counting ..) Adobe Lightroom presets for free !!
19
star
7

memes-on-issues-action

greet the issue raiser with a custom message and a bonus programming meme πŸ˜„
JavaScript
18
star
8

autobadge

Simple CLI tool to generate essential repository badges with ease
JavaScript
17
star
9

autopy-lot

github action to convert jupyter notebooks to various formats
Jupyter Notebook
16
star
10

MastJokeMara

GitHub workflow to greet with a random joke on new isssue or PR :)
JavaScript
10
star
11

NaughtyLust

Useful Nautilus Scripts made with ❀️
Python
9
star
12

minimal-weather

A minimalistic and smart weather app made with electron API
JavaScript
7
star
13

jobful-api

A RESTful API to fetch latest job notifications(INDIA only) from various sources.
JavaScript
7
star
14

indian-pincodes-database

indian pincodes collection in JSON and SQL format.
6
star
15

Abosar

অবসর πŸ“š A Collection Of Short Bengali Stories Web Scraped From Various Bengali eMagazines And eNewspapers.
Python
6
star
16

comment-to-code-ratio-action

GitHub action to measure comment-code ratio for your entire project on every push πŸŽ‰
JavaScript
6
star
17

hello-yocto

Helloworld stuffs with Yocto
C
5
star
18

one-more-joke-please

Random joke on new chrome tab πŸŽ‰
JavaScript
5
star
19

amori-banglabhasha

Collection of Bangladeshi Stories
Python
3
star
20

mixmoji

Emojis with mixed emotions !!
3
star
21

count-comments-action

count number of comments in the codebase of a PR before you merge πŸŽ‰
JavaScript
3
star
22

rainbow-villa

Handpicked collection of CSS gradinets ❀️
JavaScript
3
star
23

smart-radio

Play Online Radios From The Terminal with song information !!
Python
2
star
24

flawfinder-action

A simple Github Action that checks for security flaws in your C/CPP codes and push the report back πŸ˜‰
Python
2
star
25

natgeo-magz-db

A National Geographic magazine archive. Automatically adds magazine every month.
Python
2
star
26

awesome-homescreens

An awesome list of community-shared beautiful android home-screen setups πŸ†’
2
star
27

plzz

A python CLI to automate daily tasks of both common and advanced users :)
Python
2
star
28

star-this-repo-and-enjoy-a-meme

Star ⭐ this repo to enjoy a random meme :trollface: WIP
JavaScript
2
star
29

galpokatha

Cllection of bengali novels and stories
1
star
30

kopykat

Looks for new code snippets in system clipboard and creates a notebook automatically.
JavaScript
1
star
31

Cmder-Themes

custom xml themes for Cmder / conEmu terminal
1
star
32

DEEP-NEON

Submit your opensource projects for review
1
star
33

qikstart

kick-start a github repository with one command
JavaScript
1
star
34

deep5050

1
star
35

obsidian-workspace

My personal obsidian workspace for public use :)
JavaScript
1
star
36

investiGator

Unversity Project on Criminal Investigation Tracker System.
PHP
1
star
37

qikwall

Simple GUI to change wallpaper and terminal color scheme based on the wallpaper on Ubuntu ⚑
Python
1
star
38

Mighty-Benfords-Law

Experiments With Benford's Law On Crazy Datasets (WIP)
Jupyter Notebook
1
star
39

oracle-connect-vb6

visual basic 6.0 with oracle database connection ( oracle 10g express)
Visual Basic
1
star