Package: radio-active
RADIOACTIVESEARCH - PLAY - RECORD - REPEATPlay and record any radio stations around the globe right from your terminalJoin Discord ServerFeaturesSupports more than 40K stations !! :radio:Record audio from live radio on demand :zap:Get song information on run-time 🎶Saves last station informationFavorite stations :heart:Selection menu for favorite stationsSupports user-added stations :wrench:Looks minimal and user-friendlyRuns on Raspberry PiFinds nearby stationsDiscovers stations by genreDiscovers stations by languageVLC, MPV player supportDefault config fileI'm feeling lucky! Play Random stationsSee my progress ➡️hereWhy radioactive?While there are various CLI-based radio players likePyRadioandTERA, Radioactive stands out for its simplicity. It's designed to work seamlessly right from the start. You don't need to be a hardcore Linux or Vim expert to enjoy radio stations with Radioactive. The goal of Radioactive is to offer a straightforward user interface that's easy to grasp and comes preconfigured, without unnecessary complexities.In the SpotlightThe praise from YouTube channels and blogs underscores Radioactive's emergence as a top choice for radio enthusiasts. Its simple yet powerful features, make it a must-try application for radio lovers of all expertise levels. Discover the world of radio with ease – experience Radioactive today.See DistroTube YouTube channel talks about my app:https://www.youtube.com/watch?v=H7sf1RDFXpU&pp=ygUYcmFkaW9hY3RpdmUgcGxheWVyIHJhZGlvUbunlog:https://ubunlog.com/en/radio-activate-an-application-to-listen-to-the-radio-from-the-terminal/LinuxLinks:https://www.linuxlinks.com/radio-active-listen-radio-terminal/3/Official entry in the RadioBrowser API:https://www.radio-browser.info/usersThingsAndStuff:https://wiki.thingsandstuff.org/Streaming#:~:text=com/billniakas/bash_radio_gr-,radio%2Dactive,-https%3A//github.comAwesome-stars:https://arbal.github.io/awesome-stars/#:~:text=deep5050/radio%2Dactive%20%2D%20Play%20any%20radios%20around%20the%20globe%20right%20from%20the%20terminal%20%3Azap%3AOpenSourceAgenda:https://www.opensourceagenda.com/projects/my-awesome-stars#:~:text=deep5050/radio%2Dactive%20%2D%20Play%20any%20radios%20around%20the%20globe%20right%20from%20the%20terminal%20%3Azap%3AInstallSimply run:pip3 install --upgrade radio-activeI recommend installing it usingpipx install radio-activeTODO:Create deb, rpm and exe packagesAdd it to various Linux distribution package repositories.Add to scoop, chocolatelyExternal DependencyIt needsFFmpegto be installed on your
system in order to record the audioon Ubuntu-based system >= 20.04 Runsudo apt update
sudo apt install ffmpegFor other systems including Windows see the above linkInstalling FFmpegFFmpeg 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-WindowsRunSearch a station withradio --search [STATION_NAME]or simplyradio:zap: to select from the favorite menu.TipsUse a modern terminal emulator, otherwise the UI might break! (gets too ugly sometimes)On Windows, instead of the default Command Prompt, use the new Windows Terminal or web-based emulators like Hyper, Cmdr, Terminus, etc. for better UILet the app run for at least 5 seconds (not a serious issue though, for better performance)DemoOptionsOptionsNoteDescriptionDefaultValues(No Option)OptionalSelect a station from menu to playFalse--search,-SOptionalStation nameNone--play,-POptionalA station from fav list or url for direct playNone--country,-COptionalDiscover stations by country codeFalse--stateOptionalDiscover stations by country stateFalse--languageoptionalDiscover stations byFalse--tagOptionalDiscover stations by tags/genreFalse--uuid,-UOptionalID of the stationNone--record,-ROptionalRecord a station and save to fileFalse--filename,-NOptionalFilename to used to save the recorded audioNone--filepathOptionalPath to save the recordings<DEFAULT_DIR>--filetype,-TOptionalFormat of the recordingmp3mp3,auto--lastOptionalPlay last played stationFalse--randomOptionalPlay a random station from favorite listFalse--sortOptionalSort the result pagevotes--filterOptionalFilter search resultsNone--limitOptionalLimit the # of results in the Discover table100--volume,-VOptionalChange the volume passed into ffplay80[0-100]--favorite,-FOptionalAdd current station to fav listFalse--add,-AOptionalAdd an entry to fav listFalse--list,-WOptionalShow fav listFalse--removeOptionalRemove entries from favorite listFalse--flushOptionalRemove all the entries from fav listFalse--kill,-KOptionalKill background radios.False--loglevelOptionalLog level of the programInfoinfo,warning,error,debug--playerOptionalMedia player to useffplayvlc,mpv,ffplayNOTE:Once you save/play at least one station, invokingradiowithout any options will show a selection menu--search,-S: Search for a station online.--play,-P: You can pass an exact name from your favorite stations or alternatively pass any direct stream URL. This would bypass any user selection menu (useful when running from another script)--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--search. Example: 96444e20-0601-11e8-ae97-52543be04c81. typeuon the runtime command to get the UUID of a station.--loglevel,: Don't need to specify unless you are developing it.info,warning,error,debug-F: Add the 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.--limit: Specify how many search results should be displayed.--filetype: Specify the extension of the final recording file. default ismp3. you can provide-T autoto autodetect the codec and set file extension accordingly (in original form).DEFAULT_DIR: is/home/user/Music/radioactiveRuntime CommandsInput a command during the radio playback to perform an action. Available commands are:Enter a command to perform an action: ?

t/T/track: Current song name (track info)
r/R/record: Record a station
f/F/fav: Add station to favorite list
rf/RF/recordfile: Specify a filename for the recording.
h/H/help/?: Show this help message
q/Q/quit: Quit radioactiveSort Parametersyou can sort the result page with these parameters:name(default)votes(based on user votes)codecbitratelastcheckok(active stations)lastchecktime(recent active)clickcount(total play count)clicktrend(currently trending stations)randomFilter ParametersFilter search results with--filter. Some possible expressions are--filter "name=shows"--filter "name=shows,talks,tv"--filter "name!=news,shows"--filter "country=in"--filter "language=bengali,nepali"--filter "bitrate>64"--filter "votes<500"--filter "codec=mp3"--filter "tags!=rock,pop"Allowed operators are:=,!=><&Allowed keys are:name,country(countrycode as value),language,bitrate,votes,codec,tagsProvide multiple filters at one go, use&A complex filter example:--filter "country!=CA&tags!=islamic,classical&votes>500"NOTE: set--limitto a higher value while filtering resultsDefault ConfigsDefault configuration file is added into your home directory as.radio-active-configs.ini[AppConfig]loglevel=infolimit=100sort=votesfilter=nonevolume=80filepath=/home/{user}/recordings/radioactive/filetype=mp3player=ffplayDo NOT modify the keys, only change the values. you can give any absolute or relative path as filepath.Bonus Tipswhen usingrf: you can force the recording to be in mp3 format by adding an extension to the file name. Example "talk-show.mp3". If you don't specify any extension it should auto-detect. Example "new_show"You don't have to pass the exact option name, a portion of it will also work. for example--seafor--search,--counfor--country,--limfor--limitIt's better to leave the--filetypeas mp3 when you need to record something quickly. The autocodec takes a few milliseconds extra to determine the codec.ChangesseeCHANGELOGCommunityShare you favorite list with our community 🌐 ➡️HereYour favorite list.radio-active-aliasis under your home directory as a hidden file :)SupportVisit my contribution page for more payment options.AcknowledgementsIcons made byFreepikfromwww.flaticon.comHappy ListeningContributors ✨Thanks goes to these wonderful people (emoji key):Joe Smith⚠️💻🤔salehjafarli💻marvoh💻🐛This project follows theall-contributorsspecification. Contributions of any kind welcome!