Skip to main content

A Python wrapper for the

Project description


A Python wrapper for the Radio Browser.


 pip install pyradios

Usage example

In [1]: from pyradios import RadioBrowser

In [2]: rb = RadioBrowser()

In [3]: rb.station_search(params={'name': 'BBC Radio 1', 'nameExact': 'true'})                
[{'id': '64094',
  'changeuuid': '4f7e4097-4354-11e8-b74d-52543be04c81',
  'stationuuid': '96062a7b-0601-11e8-ae97-52543be04c81',
  'name': 'BBC Radio 1',
  'url': '',
  'homepage': '',
  'favicon': '',
  'tags': 'bbc,indie,entertainment,music,rock,pop',
  'country': 'United Kingdom',
  'countrycode': 'GB',
  'state': '',
  'language': 'English',
  'votes': '4816',
  'negativevotes': '0',
  'lastchangetime': '2018-04-19 20:26:52',
  'ip': '',
  'codec': 'MP3',
  'bitrate': '128',
  'hls': '0',
  'lastcheckok': '1',
  'lastchecktime': '2019-09-23 16:20:11',
  'lastcheckoktime': '2019-09-23 16:20:11',
  'clicktimestamp': '2019-09-24 10:21:47',
  'clickcount': '123',
  'clicktrend': '-12'}]

In [4]: rb.stations_byid('92585')
[{'id': '92585',
  'changeuuid': 'e78eb8c0-1a25-11e8-a334-52543be04c81',
  'stationuuid': '9621d43e-0601-11e8-ae97-52543be04c81',
  'name': 'Radio Maria Südtirol',
  'url': ';',
  'homepage': '',
  'favicon': '',
  'tags': 'bressanone,talk,catholic,christian',
  'country': 'Italy',
  'state': 'Trentino-Alto Adige/Südtirol',
  'language': 'German',
  'votes': '10',
  'negativevotes': '0',
  'lastchangetime': '2018-02-25 13:17:54',
  'ip': '',
  'codec': 'MP3',
  'bitrate': '128',
  'hls': '0',
  'lastcheckok': '1',
  'lastchecktime': '2018-09-03 08:56:36',
  'lastcheckoktime': '2018-09-03 08:56:36',
  'clicktimestamp': '2018-09-03 09:57:59',
  'clickcount': '0',
  'clicktrend': '0'}]

Development Setup

$ git clone
$ cd pyradios
$ virtualenv venv
$ source venv/bin/activate
$ python develop

Run Tests

$ virtualenv venv
$ source venv/bin/activate
$ python test

Release History

-   Work in progress


Andre P. Santos –

Distributed under the MIT LICENSE. See LICENSE for more information.


  1. Fork it (
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request

Project details

Download files

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

Source Distribution

pyradios-0.0.17.tar.gz (7.5 kB view hashes)

Uploaded source

Built Distribution

pyradios-0.0.17-py3-none-any.whl (9.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page