Soro - For Sonos

*Soro 2.0 adds Live Activity and Home Screen widget to control your Sonos system from the lock and home screens.*

- Live Activity for the Lock Screen
- Widgets for the Home Screen and Standby Mode
- New App Shortcuts for the Action Button and Spotlight

2.0.3: fixes a an issue when speaker list doesn't appear properly in the Live Activity
2.0.2: fixes issues with the live activity and widget not showing or showing incorrect playback details and issues with the Play Favorite action/app shortcut.
2.0.1: fixes a regression causing issues with setting the discovery IP via the correspondent action.

*Soro 2.0 adds Live Activity and Home Screen widget to control your Sonos system from the lock and home screens.*

- Live Activity for the Lock Screen
- Widgets for the Home Screen and Standby Mode
- New App Shortcuts for the Action Button and Spotlight

2.0.1: fixes a regression causing issues with setting the discovery IP via the correspondent action.
2.0.2: fixes issues with the live activity and widget not showing or showing incorrect playback details and issues with the Play Favorite action/app shortcut.

*Soro 2.0 adds Live Activity and Home Screen widget to control your Sonos system from the lock and home screens.*

- Live Activity for the Lock Screen
- Widgets for the Home Screen and Standby Mode
- New App Shortcuts for the Action Button and Spotlight

Build 2.0.1 fixes a regression causing issues with setting the discovery IP via the correspondent action.

*Soro 2.0 adds Live Activity and Home Screen widget to control your Sonos system from the lock and home screens.*

- Live Activity for the Lock Screen
- Widgets for the Home Screen and Standby Mode
- New App Shortcuts for the Action Button and Spotlight

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

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

- ‘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

New actions:

- Get Alarms
- Create Alarm
- Delete Alarm
- Separate Stereo Pair
- Create Stereo Pair

Other improvements:

Improved caching logic to help with intermittent connection issues resulting in unexpected dialogs and improve execution speed.

New actions:

Seek; go forward or backward by specific number of seconds
Seek to Chapter; extending the podcast support this action allows to go to the previous, next or specific chapter in an mp3 file such as podcast episode. (only supported when the file has been loaded directly to the speaker, such as by using the Load URL action)

Other improvements:

Added caching logic to help with intermittent connection issues resulting in unexpected dialogs.
Added toggle option for settings where applicable, ie. toggle mute, toggle loudness etc.

Improvements to the Load URL action:
- It's handling .mp3 files in a better way now. For example, this allows loading podcast episode mp3 files now.
- Unnecessary URL parameters are being removed automatically. For example, this allows loading URLs returned by the 'Search iTunes Store' action without any extra actions.

The 'Get Favorites' action got a parameter to filter the results by type.

New example shortcuts:
- Podcast to Sonos; Send episode from the Apple Podcast app to Sonos
- Episode from Queue to Sonos; List queued episodes from Castro and play selected one on speaker

Various bug fixes and improvements:
- Added 'Toggle' option to all On/Off settings
- Play action now properly triggers when a speaker is in 'Stopped' state
- New action: Set LED State

The fix to gracefully fail when all speakers are offline had to be rolled back from the recent 1.3 update. Needs some further polishing.

Various bug fixes and improvements:
- Added 'Toggle' option to all On/Off settings
- Play action now properly triggers when a speaker is in 'Stopped' state
- New action: Set LED State

The fix to gracefully fail when all speakers are offline had to be rolled back from the recent 1.3 update. Needs some further polishing.

Various bug fixes and improvements:
- Added 'Toggle' option to all On/Off settings
- Play action now properly triggers when a speaker is in 'Stopped' state
- Actions gracefully continue in case of all selected speakers are offline (such as Move or Roam)
- New action: Set LED State

- The 'Load URL' action now 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)
- New action to get Sonos Music Library items; search or browse for albums, artists or genres then load and play them on your speakers
- New action to get Bandcamp purchases to load and play them
- New example shortcuts: Browse Music Library, Browse Music Library Folders, Share to Sonos

1.1.12 adds support to adjust the Arc audio height level.
-------------------------------------------------------
Notes from from 1.1.11:
This one ended up being much bigger update than expected, but it has a lot of new and updated actions as a result. Hope you will find them useful. If you run into issues with any of the new or updated actions feel free to submit a feedback through the main app. Thanks!

*Fixes*
- Load Favorites (used to be Load Music) action initiated on the Apple Watch should execute without issues
- Load Favorites action supports Audible audiobooks
- Other minor fixes and improvements

* New Actions *
- Get Playback Information: Returns rooms (excluding members of any group since they are controlled by the group coordinator) and groups with the following properties added: Playback State, Playing Title, Playing Album, Playing Artist, Input, Current Track Duration, Current Track Elapsed Time, Track Number in Playback Queue.
- Get Rooms (And Groups): Returns all rooms and groups. Includes rooms which are members of any group.
- Get Playback Queue: Returns the current playback queue. Default limit of returned items is 5. This is due to that the 'Choose from List' action (probably most common use case to use right after) is really slow with more than 5 items added (iOS issue)
- Set TV Dialog Sync Delay
- Set Relative Volume
- Seek to Track: Skip to the specified track number in the playback queue if queue is already in use.
- Set Speaker Discovery IP: this action updates the IP address being used by the 'Direct Connect' feature to discover your speakers. You can use this if you have multiple systems (ie. S1 and S2) on the same network, for example, just before running the 'Get Playback Details' action.
- Get Favorites: Returns favorites from 'My Sonos'. Only returns items that can be loaded by the Load Favorite and Load Multiple Favorites actions. You can use this with the built-in list actions such 'Get Item from List' or 'Choose From List'.
- Load Multiple Favorites: improve the speed and prevent Siri timeouts when loading multiple favorites

* Updated Actions *
- Set Volume: added 'Ask Each Time' switch to allow dynamic input. The updated action also allows 0% as input now.
- Use Line-In: it shows both speakers in a stereo pair to select as input. (filtering to show only supported speakers will come later)

* New Examples *
- SonosBot: Lists rooms and groups with playback details and provides menu to choose various actions for the selected room/group
- Skip to Track: demonstrates the use case of the 'Skip To Track' and 'Get Playback Details' actions
- Airplay to All Sonos: groups all speakers and sets group as Airplay destination. You can modify this to group any set of Sonos rooms or ask each time.

This one ended up being much bigger update than expected, but it has a lot of new and updated actions as a result. Hope you will find them useful. If you run into issues with any of the new or updated actions feel free to submit a feedback through the main app. Thanks!

*Fixes*
- Load Favorites (used to be Load Music) action initiated on the Apple Watch should execute without issues
- Load Favorites action supports Audible audiobooks
- Other minor fixes and improvements

* New Actions *
- Get Playback Information: Returns rooms (excluding members of any group since they are controlled by the group coordinator) and groups with the following properties added: Playback State, Playing Title, Playing Album, Playing Artist, Input, Current Track Duration, Current Track Elapsed Time, Track Number in Playback Queue.
- Get Rooms (And Groups): Returns all rooms and groups. Includes rooms which are members of any group.
- Get Playback Queue: Returns the current playback queue. Default limit of returned items is 5. This is due to that the 'Choose from List' action (probably most common use case to use right after) is really slow with more than 5 items added (iOS issue)
- Set TV Dialog Sync Delay
- Set Relative Volume
- Seek to Track: Skip to the specified track number in the playback queue if queue is already in use.
- Set Speaker Discovery IP: this action updates the IP address being used by the 'Direct Connect' feature to discover your speakers. You can use this if you have multiple systems (ie. S1 and S2) on the same network, for example, just before running the 'Get Playback Details' action.
- Get Favorites: Returns favorites from 'My Sonos'. Only returns items that can be loaded by the Load Favorite and Load Multiple Favorites actions. You can use this with the built-in list actions such 'Get Item from List' or 'Choose From List'.
- Load Multiple Favorites: improve the speed and prevent Siri timeouts when loading multiple favorites

* Updated Actions *
- Set Volume: added 'Ask Each Time' switch to allow dynamic input. The updated action also allows 0% as input now.
- Use Line-In: it shows both speakers in a stereo pair to select as input. (filtering to show only supported speakers will come later)

* New Examples *
- SonosBot: Lists rooms and groups with playback details and provides menu to choose various actions for the selected room/group
- Skip to Track: demonstrates the use case of the 'Skip To Track' and 'Get Playback Details' actions
- Airplay to All Sonos: groups all speakers and sets group as Airplay destination. You can modify this to group any set of Sonos rooms or ask each time.

This one ended up being much bigger update than expected, but it has a lot of new and updated actions as a result. Hope you will find them useful. If you run into issues with any of the new or updated actions feel free to submit a feedback through the main app. Thanks!

*Fixes*
- Load Music action initiated on the Apple Watch should execute without issues
- Other minor fixes and improvements

* New Actions *
- Get Playback Information: Returns rooms (excluding members of any group since they are controlled by the group coordinator) and groups with the following properties added: Playback State, Playing Title, Playing Album, Playing Artist, Input, Current Track Duration, Current Track Elapsed Time, Track Number in Playback Queue.
- Get Rooms (And Groups): Returns all rooms and groups. Includes rooms which are members of any group.
- Get Playback Queue: Returns the current playback queue. Default limit of returned items is 5. This is due to that the 'Choose from List' action (probably most common use case to use right after) is really slow with more than 5 items added (iOS issue)
- Set TV Dialog Sync Delay
- Set Relative Volume
- Seek to Track: Skip to the specified track number in the playback queue if queue is already in use.
- Set Speaker Discovery IP: this action updates the IP address being used by the 'Direct Connect' feature to discover your speakers. You can use this if you have multiple systems (ie. S1 and S2) on the same network, for example, just before running the 'Get Playback Details' action.
- Get Favorites: Returns favorites from 'My Sonos'. Only returns items that can be loaded by the Load Favorite and Load Multiple Favorites actions. You can use this with the built-in list actions such 'Get Item from List' or 'Choose From List'.
- Load Multiple Favorites: improve the speed and prevent Siri timeouts when loading multiple favorites

* Updated Actions *
- Set Volume: added 'Ask Each Time' switch to allow dynamic input. The updated action also allows 0% as input now.
- Use Line-In: it shows both speakers in a stereo pair to select as input. (filtering to show only supported speakers will come later)

* New Examples *
- SonosBot: Lists rooms and groups with playback details and provides menu to choose various actions for the selected room/group
- Skip to Track: demonstrates the use case of the 'Skip To Track' and 'Get Playback Details' actions
- Airplay to All Sonos: groups all speakers and sets group as Airplay destination. You can modify this to group any set of Sonos rooms or ask each time.

This version brings major speed and reliability improvements.
Also added the ability to discover your speaker system using a single IP address. This should help if you are using VPN or experiencing connectivity issues but also improves the speed of execution in general so feel free to utilize it. You can set it up by tapping ••• in the top left corner of the app and selecting 'Connection issues or using VPN?'
In addition, version 1.1.8 fixes the IP address input for locales with comma decimal sign.

This version brings major speed and reliability improvements.
Also added the ability to discover your speaker system using a single IP address. This should help if you are using VPN or experiencing connectivity issues but also improves the speed of execution in general so feel free to utilize it. You can set it up by tapping ••• in the top left corner of the app and selecting 'Connection issues or using VPN?'

Improved the execution speed of chained actions. Additional improvements coming in that area soon.
Resolved a bug when loading favourites with Siri.
Added 2 new shuffle/repeat options.
Updated the “Set Sleep Timer” action to properly handle execution via Siri. You may need to re-add the action in the Shortcuts app.

Thanks all for trying Soro, if you like the app, rating it or leaving a review on the App Store would be much appreciated!

This version adds 2 new actions: Clear Queue and Set TV Autoplay.
Also includes minor improvements to the speaker discovery logic and logging. More improvements to that are in the works and coming in an upcoming update.

Thanks all for trying Soro, if you like the app, rating it or leaving a review on the App Store would be much appreciated!

This version fixes the number formatting of the set volume action and handles the case when you want provide a value each time. (set the value to 0% in the shortcuts app and the action will prompt to provide the volume value each time)
It also includes a fix to the TV Input action. It should now set the input correctly.

Resolves an issue when your system has a Boost or Bridge device.

Resolves a crash when first launching the app.

This version resolves a few speaker discovery related issues.