> For the complete documentation index, see [llms.txt](https://docs.ohmautomation.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ohmautomation.io/en/connect-devices/sonos.md).

# Sonos

This short guide explains how to connect your Home Automation System to Sonos.

{% embed url="<https://www.sonos.com/>" %}

To connect Sonos, open the OHMe app settings, search for *Sonos*, and select the dedicated option.

{% hint style="info" %}
This guide shows the steps for iOS devices, but aside from a few visual differences, the procedure is similar on Android devices as well.
{% endhint %}

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-d2b4508c347ff8af7359ab2a3673184dea932daf%2Fios_sonos_1.png?alt=media" alt="" width="300"></div>

On the next screen, you can link your Sonos account. Click the *Connect Sonos* button to continue.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-0c5ab08d48324e160ba71036548ce0c992692dc2%2Fios_sonos_2.png?alt=media" alt="" width="300"></div>

Clicking the button will open the following screen.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-a2286369651c6506cec89066392283251b8ee89e%2Fios_sonos_3.png?alt=media" alt="" width="300"></div>

Click the *Continue* button, then enter your Sonos account credentials.

{% hint style="danger" %}
You need to create a Sonos account before continuing.

To register an account, go to [this page](https://login.sonos.com/signin/register).
{% endhint %}

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-8d776b1995aca45411d99e1b55592256c6f57d38%2Fios_sonos_4.png?alt=media" alt="" width="300"></div>

After entering your credentials, press *Sign In* and accept the terms by selecting *I Consent*.

{% hint style="info" %}
By doing this, you authorize OHMe to control your Sonos System.
{% endhint %}

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-a5a40fecafd373eebf9ef89b97a9b1d81d164de4%2Fios_sonos_5.png?alt=media" alt="" width="300"></div>

Once the connection is completed, the *Sonos* page should show the *Disconnect Sonos* button.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-dd8db24271abb18749f83a9d96999a4d1d4e0eab%2Fios_sonos_6.png?alt=media" alt="" width="300"></div>

To access Sonos features, select the *Sonos* option from the main menu.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-12ed95b9e4060dfb8d0916571c2c7267580b3631%2Fios_sonos_7.png?alt=media" alt="" width="300"></div>

The available features are more limited than in the official app, but the connection allows you to create scenarios and automations that also include music.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-9d9fd7f3eea26ab4c5f8120e3f099cc0c6d6bf3f%2Fios_sonos_8.png?alt=media" alt="" width="300"></div>

Clicking a Group opens a dedicated page.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-06fcde85aca8fa4bbc85a38ae769c6d5f3c87fa9%2Fios_sonos_9.png?alt=media" alt="" width="300"></div>

## Voice Synthesis

Among the integrated features, *Voice Synthesis* deserves a special mention.

To access this feature, click the three dots `⋯` on the *Sonos Devices* page, then select the *Voice Synthesis* option.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-5706a39d661ec6c7ba24635307c936e48be5742e%2Fios_sonos_10.png?alt=media" alt="" width="300"></div>

Thanks to voice synthesis integration, you can convert text messages into voice messages that will be played by selected *Sonos Players*.

<div align="left"><img src="https://3582462918-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmaDJsMJp40TdufW4KHYA%2Fuploads%2Fgit-blob-4887d9dadf9a4eae4081ec16d1c2d0f9de3485c8%2Fios_sonos_11.png?alt=media" alt="" width="300"></div>

This function can also be used in scenarios, for example to announce when someone arrives home.

You can also play voice messages in response to an event, for example:

* a door opening
* when the alarm is sounding
* when someone rings the doorbell
* when a button is pressed
* and many others
