woob radio

Console application able to search for radios on supported websites, to get and play direct stream URLs, get current playing songs, etc.

It supports the following websites:

Get woob radio

This application is part of woob. To install it, please read this page.


You can run woob radio without any parameter to get an interactive prompt, or specify a command to run it directly and exit just after.

In this page we will use the interactive mode:

$ woob radio
Welcome to woob radio

Copyright(C) 2010-2021 The woob Team
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.

Type "help" to display available commands.

Loaded backends:

woob radio>

Use the help command to see what are the available commands.

For more information about common options of console applications, read this documentation.

The first time you launch woob radio, it will ask you what backends you want to add and configure. You can also use the backends command to manage them, and to enable only specific backends.

List radios


radio> ls [PATTERN]


radio> ls
* (1) OUÏ FM Indé (ouifm)
   OUI FM - Rock Indé             (Current: CAT POWER - NAKED)
* (2) OUÏ FM Blues (ouifm)
   OUI FM - Blues                 (Current: GUITAR SLIM - THE THINGS THAT I USED TO D)
* (3) OUÏ FM Collector (ouifm)
   OUI FM - Classic Rock          (Current: FRANK ZAPPA - JOE'S GARAGE)
* (4) OUÏ FM Alternatif (ouifm)
   OUI FM - L'Alternative Rock    (Current: JIMMY EAT WORLD - HIGHER DEVOTION)
* (5) OUÏ FM (ouifm)
   OUI FM                         (Current: ROBERT FRANCIS - KEEP ON RUNNING)

Get information about a radio


radio> info <# or ID>

For example:

radio> info 1
id: blues@ouifm
title: OUÏ FM Blues
description: OUI FM - Blues
streams: [128kbits/s (http://ouifm.ice.infomaniak.ch/ouifm4.mp3)]

Play a radio stream

You can play the stream of a radio with a found player:

radio> play <# or ID>


radio> play 1
Invoking "mplayer http://ouifm.ice.infomaniak.ch/ouifm4.mp3".

Use cases

Display the current song in Conky

You can add this line in ~/.conkyrc to refresh current song on OuiFM Blues every 30 seconds:

$color${texeci 30 radio info blues@ouifm --select current --no-keys}