Skip to main content

Just listen to the radio

Project description

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

Installation

pip install radio

or

pip install --upgrade radio

Usage

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.

Commands

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

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

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

Remove a radio information.

Usage:

radio remove [OPTIONS] RADIO_ID

Options:

--help Show this message and exit.

show

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

How does it plays the radio?

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.

ToDo

  • support multiples radio lists (is it useful?)
  • support downloading radio lists from somewhere
  • customize player and priorities or autodetect (something like rifle in the ranger-fm package)
  • what more?
  • help me at https://github.com/quijot/radio-package

Author

Collaborators

License

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

Project details


Download files

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

Files for radio, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size radio-0.1.3-py3-none-any.whl (5.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size radio-0.1.3.tar.gz (5.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page