Skip to content
Open
Show file tree
Hide file tree
Changes from 6 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/assets/icons/bbcsounds-logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
48 changes: 48 additions & 0 deletions docs/music-providers/bbc-sounds.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# BBC Sounds Provider ![Preview image](../assets/icons/bbcsounds-logo.png){ width=70 align=right }

Music Assistant has support for streaming from BBC Sounds. Contributed and maintained by [Keiran Hogg](https://github.com/keiranhogg)

## Features

| | |
|:-----------------------|:---------------------:|
| Subscription FREE | Yes |
| Self-Hosted Local Media | No |
| Media Types Supported | Tracks, Radio, Podcasts |
| [Recommendations](../ui.md#view-home) Supported | Yes |
| Lyrics Supported | No |
| [Radio Mode](../ui.md#track-menu) | No |
| Maximum Stream Quality | Lossy, AAC-LC(320kbps) |
| Login Method | None or Password |

### Other

- Stream live BBC radio shows, podcast series and on-demand audio
- Shows the currently playing song when streaming radio stations
- Access your personalised BBC Sounds content*
- Keeps your My Sounds listen history up to date with your Music Assistant activity*

*Requires a logged in BBC account

## Configuration

The provider works without a login, but you will be restricted to the limited International version of the Sounds menu

### Settings
- <b>Enable UK Sounds content.</b> This toggle should be selected on for UK based listeners to unlock the full catalogue
- <b>Username and Password.</b> A BBC Sounds account is optional, but some UK-only content may not work without being logged in
- <b>Advanced - Show local radio stations</b> Define the maximum stream bitrate
- <b>Advanced - Show 'now playing' details</b> Show details of the currently playing track instead of the station details
- <b>Advanced - Player update interval (seconds)</b> How often to check for now playing updates
- <b>Advanced - Show recommendations</b> BBC Sounds has several recommendation categories, configure if and where these are shown

## Known Issues / Notes

The full functionality is enabled when you are a UK-based listener, and signed in to your BBC account. The BBC has slowly been moving towards excluding non-UK listeners from using its Sounds platform, more details [here](https://www.bbc.co.uk/sounds/help/questions/listening-outside-the-uk/outside-uk-changes). This provider currently allows access to live and catch up radio to International listeners via the Sounds API, but this could be restricted in the future.

## Not Yet Supported

- Pausing and seeking live radio
- The international menu should show avaiable podcasts, this will be supported in a future release, but is not currently
- Showing the currently playing song on catch-up
- For signed-in users, accessing your subscribed content through the library is not yet supported, but is planned
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ nav:
- Apple Music: music-providers/apple-music.md
- Audible: music-providers/audible.md
- Audiobookshelf: music-providers/audiobookshelf.md
- BBC Sounds: music-providers/bbc-sounds.md
- Builtin: music-providers/builtin.md
- Deezer: music-providers/deezer.md
- gPodder: music-providers/gpodder.md
Expand Down