App: Soro - For Sonos
Developer: Laszlo Gergely
Genres: Utilities, Entertainment

Soro extends Siri and the Shortcuts app with new actions to control your Sonos speakers and devices.

Create both quick actions or extensive workflows integrating other apps to control your speakers with the Shortcuts app using widgets, Siri voice commands or automations.

* Highlight action added in version 1.4 *

‘Speak Text’ action aka Intercom for Sonos
Similar to the Intercom action available for the HomePod, this action lets users to play messages (or media files) on any of their supported* Sonos speakers utilizing the text to speech features built into iOS, iPadOS and macOS and continue the already playing content after the message.
See the example shortcuts 'Text to Speech' and 'Walkie Talkie' to explore the possibilities of what you can do in your own shortcuts.

Other actions added to the Shortcuts app by Soro:

- Group/Ungroup
- Set Volume
- Play/Pause/Stop
- Mute/Unmute
- Load Music and Favorites
- Load URL -> supports links from Apple Music, Spotify and Bandcamp; load and play albums, track, playlists or radio stations directly from the correspondent apps via the share sheet or from other 1st and 3rd party shortcuts (for example MusicHarbor, Toolbox Pro)
- Get Music Library Items -> Search or browse for albums, artists or genres then load and play them on your speakers
- Get Bandcamp Purchases
- Set a Sleep Timer
- Set Line-In input
- Set TV input
- Change Repeat/Shuffle
- Adjust Equalizer Settings (Treble/Bass/Loudness/Trueplay)
- Turn Speech Enhancement On/Off
- Turn Night Mode On/Off
- Adjust subwoofer and surround sound settings
- Set Crossfade
- Set TV Autoplay
- Set TV Dialog Sync Delay
- Wake Speaker
- Set Touch Control
- Get Alarms
- Create Alarm
- Delete Alarm
- Separate Stereo Pair
- Create Stereo Pair

Please note that your device needs to be on the same network as your speakers and local network access need to be granted by first launching the main Soro app.

If you are using VPN or experiencing connectivity issues please try the feature called Direct Connect within the app. It also improves the speed of execution in general so feel free to utilize it anytime.
You can set it up by tapping ••• in the top left corner and selecting 'Connection issues or using VPN?'

Both S1 and S2 systems are supported, however all speakers need to be on the same operating system.

* 'Speak Text' action supported speakers: Sonos One, Amp, Port, Play:5 (gen 2), Beam, One SL, Move, SYMFONISK table lamp with WiFi, SYMFONISK WiFi bookshelf and all newer speakers using the Sonos S2 system.
* 'Speak Text' action works over the local network only.

Soro is not affiliated with Sonos Inc. nor is it an official Sonos app. Sonos is trademarked by Sonos Inc.

Release notes:
Minor additions to improve the first run experience and to fix issues with the Speak Text action when running it on multiple speakers.

Update notes from version 1.4.1:
This quick release adds the following updates to the Speak Text action:
- New parameters 'Override Volume' and 'Volume'; volume of the announcement, message or audio file playback independent of the current speaker volume. Please note that Sonos may have set internal upper and lower limits for the volume level in order to prevent the audio clip from being too loud or inaudible.
- New Parameter 'Priority'; A High priority audio message can interrupt another high priority one if the latter has played for more than 10 seconds. A high priority audio message can interrupt a low priority one at any time.
- Notifications if incorrect file formats are being used for the URL and Audio File parameters. The URL parameter only accepts .mp3 files due to technical limitations. Other audio formats are supported by the Audio File parameter.
- Updated the internal logic of the action to make it work more reliably and efficiently.

Also updated the Walkie-Talkie example shortcut as it was returning an error in some cases.

Update notes from version 1.4:
- ‘Speak Text’ action aka Intercom for Sonos
Similar to the Intercom action available for the HomePod, this action lets users to play messages (or media files) on any of their supported* Sonos speakers utilizing the text to speech features built into iOS, iPadOS and macOS and continue the already playing content after the message.
    
Users can set the voice and the language to any of the available ones on their device (downloaded under Spoken Content - Voices option in Settings) and adjust the pitch and speed rate as well.
    
In addition to using text to speech the action can take local or remote media files as an input.
    
- Additional new actions:
    - Create Alarm, Delete Alarm and Update Alarm
    - Create/Separate Stereo Pair

- New example shortcuts:
    - Text to Speech
    - Walkie-Talkie

- Various fixes to improve speed of execution and overall reliability