|
|
| (72 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| {{Addon | | {{Delete|Page emptied by add-on author and hasn't been in official repository for three consecutive major release cycles}} |
| |Name=Sonos | |
| |provider-name=robwebset
| |
| |ID=script.sonos
| |
| |latest-version=1.0.5
| |
| |extension point=xbmc.python.script
| |
| |provides=executable
| |
| |Summary=Sonos Controller
| |
| |Description=Supports simple Sonos Controls and notifications from XBMC. Look at the wiki for more details.
| |
| |Platform=all
| |
| |Language=
| |
| |License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
| |
| |Forum=http://forum.xbmc.org/showthread.php?tid=183020
| |
| |Website=
| |
| |Source=http://robwebset.googlecode.com/svn/trunk/script.sonos/
| |
| |Email=
| |
| |broken=
| |
| |icon url=http://mirrors.xbmc.org/addons/frodo/script.sonos/icon.png}}
| |
| | |
| == Introduction ==
| |
| The XBMC Sonos addon allows you to control your Sonos system from XBMC. It is implemneted (for those who like to know) as a script, plugin and service. In addition to controlling your Sonos system it also allows you to be notified (via a popup) whenever a new track starts and link the audio volume control of XBMC to the audio volume of the Sonos system. There is also a full "Artist View" controller that will display images and descriptions of the artists currently playing on the Sonos System.
| |
| <br /><br />
| |
| The Sonos addon currently only supports a single speaker - this is partly because I only have one speaker available to test any features.
| |
| <br />
| |
| | |
| == Installation ==
| |
| The Sonos addon does not require any other programs installed. It will communicate directly with your Sonos speaker to perform operations.
| |
| <br /><br />
| |
| The following settings are available:
| |
| === Speaker ===
| |
| :'''Search For Sonos Speakers...'''
| |
| ::Attempt to auto detect any Sonos speakers on the network
| |
| :'''IP Address'''
| |
| ::The IP Address of your speaker
| |
| '''''Debugging'''''
| |
| :'''Enable Debug logging'''
| |
| ::Enables Sonos debug logging into the XBMC log file
| |
| :'''Use Test Data'''
| |
| ::Useful for testing if a Sonos speaker is not available (Also allows custom skinners that do not have a Sonos system to develop skins)
| |
| === Controller ===
| |
| :'''Refresh Interval (Seconds)'''
| |
| ::Sets how often the controller screen should refresh and check for changes of track being played
| |
| :'''Display Artist Information'''
| |
| ::Displays images and artist information while items are playing when the controller is selected (using [[Add-on:Artist Slideshow|ArtistSlideshow]])
| |
| :'''Avoid Duplicate Key Presses (Seconds)'''
| |
| ::When using a remote control and holding down a button (such as volume) it will send many requests to increase the volume - this setting allows you to ensure only one press is detected every X seconds. (This prevents flooding the Sonos system with requests).
| |
| :'''Volume Change Increments'''
| |
| ::When the volume increase/decrease button, how much to change the volume by (default is 3%)
| |
| :'''Link XBMC Volume With Sonos Speaker (Requires Restart)'''
| |
| ::Whenever you change the XBMC volume, the Sonos volume will be set to the same percentage value (Note: Changes in the Sonos Volume are not reflected in XBMC - this is one way only)
| |
| :'''Switch Sonos To Line-In On XBMC Startup'''
| |
| ::When XBMC starts, it will send a message to the Sonos speaker to switch it to line-in
| |
| === Notifications ===
| |
| :'''Enable Notifications (Restart Required)'''
| |
| ::Enables or disables the popup notification of track change
| |
| :'''Display Notification For (Seconds)'''
| |
| ::How long to display the track information on the screen
| |
| :'''Notification Check Frequency (Seconds)'''
| |
| ::The frequency in which the service check which track is playing on the Sonos speaker
| |
| :'''Do Not Display Notification If Video Is Playing'''
| |
| ::Prevents the popup notification displaying while a video file is playing
| |
| :'''Use Default XBMC Notification Dialog'''
| |
| ::Uses the default XBMC popup dialog instead of the custom Sonos one
| |
| === Plugin ===
| |
| :'''Batch Size'''
| |
| ::The number of records to retrieve from Sonos in one chunk, looping to get all the records in this batch size. (Default = 100)
| |
| :'''Maximum Entries In Displayed Lists'''
| |
| ::Limits the number of entries that are retrieved from the Sonos system when generating lists (e.g. The Queue). (Default = 1000)
| |
| <br />
| |
| | |
| == Features ==
| |
| === Notifications ===
| |
| Upon startup of XBMC, the Sonos addon will launch a service to monitor your Sonos speaker. It will then provide a popup each time the track being played on the Sonos speaker changes. This can be disabled via the settings menu if not required.
| |
| <br />
| |
| | |
| === Main Script/Controller ===
| |
| The controller enables you to control your Sonos speaker. It suports commands like:
| |
| * Play
| |
| * Pause
| |
| * Stop
| |
| * Previous
| |
| * Next
| |
| * Mute
| |
| * Change Volume
| |
| * Seek to position in track
| |
| In addition to this, the controller will display the currently playing track information and the Album Art. Additional artist information can be retrieved from the web and displayed if selected in the settings.
| |
| <br />
| |
| | |
| === Plugin ===
| |
| The plugin allows users to view and select tracks that are available on the Sonos system. It has a root menu that contains
| |
| * Music Library - The list of locally stored tracks on your server
| |
| * Radio Stations - The radio stations saved in "My Radio Stations"
| |
| * Queue - The currently queued tracks to play on the Sonos system
| |
| It suports commands like:
| |
| * Play now
| |
| * Add to queue
| |
| * Replace queue
| |
| * Clear queue
| |
| | |
| <br /><br />
| |
| To enable this feature just run the addon program in the normal way or add it to your XBMC Home Page and launch it from there.
| |
| <br />
| |
| | |
| == Debugging ==
| |
| If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
| |
| * XBMC [[Settings/System#Debugging|logging]] from the main setting menu
| |
| * Sonos debug from the Sonos addon settings menu
| |
| Please do not paste the log into the forum thread, just link to it.
| |
| <br />
| |
| <br />
| |
| | |
| [[Category:Frodo add-on repository]]
| |
