Skip to content

Latest commit

 

History

History
164 lines (98 loc) · 2.67 KB

README.rst

File metadata and controls

164 lines (98 loc) · 2.67 KB

radio

radio is a command line tool to just listen to the radio.

pip install radio

or

pip install --upgrade radio

Just play the radio like this...

radio play <id>

Look for available radios with

radio show

Search for you favourite radio with

radio search <term>

or else add it with

radio add <id> --name "My Favourite Radio" --url <streaming-url>

General usage:

radio [OPTIONS] COMMAND [ARGS]...

Options:

--version Show the version and exit.
--help Show this message and exit.
add:Add or update a radio information.
play:Play a radio.
remove:Remove a radio information.
search:Search radio in the available radios.
show:Show all radios information.

Add or update a radio information.

Usage:

radio add [OPTIONS] RADIO_ID

Options:

-n, --name TEXT
 Radio complete fancy name. [required]
-u, --url TEXT Radio playable streaming url. [required]
--help Show this message and exit.

For example:

radio add convos --name "Radio Con Vos FM 89.9" --url https://server1.stweb.tv/rcvos/live/chunks.m3u8

Play a radio.

Usage:

radio play [OPTIONS] RADIO_ID

Options:

--help Show this message and exit.

Turn off the radio by pressing "q" or with Ctrl-<C>.

Remove a radio information.

Usage:

radio remove [OPTIONS] RADIO_ID

Options:

--help Show this message and exit.

Search radio in the available radios.

Usage:

radio search [OPTIONS] STRING

Options:

-i, --invert Invert filter.
--help Show this message and exit.

Show all radios information.

Usage:

radio show [OPTIONS]

Options:

--urls Also show Streaming URLS.
--count Show how many radios are available.
--help Show this message and exit

It requires any of the following media player:

  • ffplayer (ffmpeg package)
  • cvlc (vlc package)
  • mplayer

Priority or alternative players yet to make customizable in future versions.

radio is licensed under the do What The Fuck you want to Public License, WTFPL. See the LICENSE file.