···11+---
22+title: Sonos
33+toc_min_heading_level: 2
44+toc_max_heading_level: 5
55+---
66+77+import Tabs from '@theme/Tabs';
88+import TabItem from '@theme/TabItem';
99+import CodeBlock from '@theme/CodeBlock';
1010+import JsonConfig from '!!raw-loader!@site/../config/sonos.json.example';
1111+1212+Multi-scrobbler can use the [Sonos](https://www.sonos.com) [local API](https://docs.sonos.com/docs/control) to monitor what your Sonos system is playing.
1313+1414+MS supports scrobbling simultaneous, different Plays based on what each Group/Zone is playing.
1515+1616+:::note
1717+1818+For some services, including Spotify, Sonos only reports the **first** artist for a Track. You will most likely want to enable [Musicbrainz scrobble enhancements](/configuration/transforms/musicbrainz) so that your plays have correct information, including all artists, when scrobbled.
1919+2020+:::
2121+2222+:::tip
2323+2424+Activity reporting for **other [Sources](/configuration/sources)** does not work well **when played through Sonos.**
2525+2626+If you have other Sources configured for Multi-Scrobbler that you may play *through Sonos* you should try to add Sonos to the "deny" list for that Source so that it does not try to monitor Sonos activity. Check the documentation for each individual Source to see how to configure this exclusion.
2727+2828+An example of this for [Plex](/configuration/sources/plex) would be to add Sonos to the "block" list ENV EX: `PLEX_DEVICES_BLOCK=sonos`
2929+3030+:::
3131+3232+## Configuration
3333+3434+You **must** define the IP address of at least one Sonos/accessory in order for Multi-scrobbler to connect to your Sonos system.
3535+3636+<Config config="SonosSourceConfig" fileContent={JsonConfig} name="sonos">
3737+ | Environmental Variable | Required? | Default | Description |
3838+ | ---------------------- | --------- | ------- | ---------------------------------------------------------------------- |
3939+ | `SONOS_HOST` | Yes | | The IP address of any active Sonos device/accessory EX `192.168.0.150` |
4040+</Config>