Radioob is a 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 Radioob

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


You can run Radioob 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:

$ radioob
Welcome to radioob

Copyright(C) 2010-2017 The Weboob 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:


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


radioob> ls [PATTERN]


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


radioob> info <# or ID>

For example:

radioob> info 1
id: blues@ouifm
title: OUÏ FM Blues
description: OUI FM - Blues
streams: [128kbits/s (]

Play a radio stream

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

radioob> play <# or ID>


radioob> play 1
Invoking "mplayer".

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 radioob info blues@ouifm --select current --no-keys}