auntie-sounds 1.0.0b3

A library for interacting with BBC Radio stations and streams

Auntie Sounds

A library for interacting with BBC radio stations via an interface to BBC Sounds. It was written to be used for the BBC Sounds provider for Music Assistant but exists as a standalone library.

Features

✅ Signing into a BBC Sounds account
✅ Listing current station programming
✅ Obtaining a stream to listen to a station
✅ Getting the current and previous segments (typically songs) on a station

Not implemented

❌ Pausing or rewinding live radio
❌ Displaying and listening to previous shows

Notes

• It is written as an async library
• A BBC account is not required for most actions, but as BBC region-locks streams and is turning off non-UK access soon, is it the supported way to use it

Example Usage

import asyncio
from sounds import exceptions
from sounds.client import SoundsClient

async def main():
    try:
        async with SoundsClient() as client:
            if await client.auth.authenticate(username, password):
                stations = await client.stations.get_stations()
                bbc_6music = await client.stations.get_station("bbc_6music", include_stream=True)
                stream = bbc_6music.stream.uri
                schedule = bbc_6music.schedule
    except exceptions.LoginFailedError:
        ...
    except exceptions.APIResponseError:
        ...
    except exceptions.NetworkError:
        ...

asyncio.run(main())