Logitech Squeezebox Binding

This binding integrates the Logitech Media Server and compatible Squeeze players.

Introduction

Slim Devices was established in 2000, and was first known for its SlimServer used for streaming music, but launched a hardware player named SliMP3 able to play these streams in 2001. Although the first player was fairly simple only supporting wired Ethernet and MP3 natively, it was followed two years later by a slightly more advanced player which was renamed to Squeezebox. Other versions followed, gradually adding native support for additional file formats, Wi-Fi-support, gradually adding larger and more advanced displays as well as a version targeting audiophile users. Support for playing music from external streaming platforms such as Pandora, Napster, Last.fm and Sirius were also added. The devices in general have two operating modes; either standalone where the device connects to an internet streaming service directly, or to a local computer running the Logitech Media Server or a network-attached storage device. Both the server software and large parts of the firmware on the most recent players are released under open source licenses.

In 2006, Slim Devices was acquired by Logitech for $20 million USD. Logitech continued the development of the player until they announced in August 2012 that it would be discontinued. Given the cross-platform nature of the server and software client, some users have ensured the continued use of the platform by utilizing the Raspberry Pi as dedicated Squeezebox device (both client and server).

Taken from: Wiki

Supported Things

At least one Squeeze Server is required to act as a bridge for Squeeze players on the network. Squeeze players may be official Logitech products or other players like Squeeze Lites.

Discovery

A Squeeze Server is discovered through UPnP in the local network. Once it is added as a Thing the Squeeze Server bridge will discover Squeeze Players automatically.

Binding Configuration

The binding requires no special configuration

Thing Configuration

The Squeeze Server bridge requires the ip address, web port, and cli port to access it on. If Squeeze Server authentication is enabled, the userId and password also are required.

Squeeze Players are identified by their MAC address, which is required. In addition, the notification timeout can be specified. If omitted, the default timeout value will be used. A notification volume can be optionally specified, which, if provided, will override the player's current volume level when playing notifications.

Here are some examples of how to define the Squeeze Server and Player things in a things file.

Bridge squeezebox:squeezeboxserver:myServer [ ipAddress="192.168.1.10", webport=9000, cliport=9090 ]
{
    Thing squeezeboxplayer myplayer[ mac="00:f1:bb:00:00:f1" ]
}

If Squeeze Server authentication is enabled, the user ID and password can be specified for the Squeeze Server:

Bridge squeezebox:squeezeboxserver:myServer [ ipAddress="192.168.1.10", webport=9000, cliport=9090, userId="yourid", password="yourpassword" ]
{
    Thing squeezeboxplayer myplayer[ mac="00:f1:bb:00:00:f1" ]
}

The notification timeout and/or notification volume can be specified for the Squeeze Player:

Bridge squeezebox:squeezeboxserver:myServer [ ipAddress="192.168.1.10", webport=9000, cliport=9090 ]
{
    Thing squeezeboxplayer myplayer[ mac="00:f1:bb:00:00:f1", notificationTimeout=30, notificationVolume=35 ]
}

Server Channels

The Squeezebox server supports the following channel:

Channel Type IDItem TypeDescription
favoritesListStringComma-separated list of favorite IDs & names, updated whenever list changes on server

Player Channels

All devices support some of the following channels:

Channel Type IDItem TypeDescription
powerSwitchPower on/off your device
muteSwitchMute/unmute your device
volumeDimmerVolume of your device
stopSwitchStop the current title
controlPlayerControl the Zone Player, e.g. play/pause/next/previous/ffward/rewind
streamStringPlay the given HTTP or file stream (file:// or http://)
syncStringAdd another player to your device for synchronized playback (other player mac address)
playListIndexNumberPlaylist Index
currentPlayingTimeNumberCurrent Playing Time
durationNumberDuration of currently playing track (in seconds)
currentPlaylistShuffleNumberCurrent playlist shuffle mode (0 No Shuffle, 1 Shuffle Songs, 2 Shuffle Albums)
currentPlaylistRepeatNumberCurrent playlist repeat Mode (0 No Repeat, 1 Repeat Song, 2 Repeat Playlist)
titleStringTitle of the current song
remotetitleStringRemote Title (Radio) of the current song
albumStringAlbum name of the current song
artistStringArtist name of the current song
yearStringRelease year of the current song
genreStringGenre name of the current song
coverartdataImageImage data of cover art of the current song
ircodeStringReceived IR code
numberPlaylistTracksNumberNumber of playlist tracks
playFavoriteStringID of Favorite to play (channel's state options contains available favorites)

Playing Favorites

Using the playFavorite channel, you can play a favorite from the Favorites list on the Logitech Media Server (LMS). The favorites from the LMS will be populated into the state options of the playFavorite channel. The Selection widget in HABpanel can be used to present the favorites as a choice list. Selecting from that choice list will play the favorite on the SqueezeBox player. Currently, only favorites from the root level of the LMS favorites list are exposed on the playFavorite channel.

How to Set Up Favorites

  • Add some favorites to your favorites list in LMS (local music playlists, Pandora, Slacker, Internet radio, etc.). Keep all favorites at the root level (i.e. favorites in sub-folders will be ignored).

  • If you're on an older openHAB build, you may need to delete and readd your squeezebox server and player things to pick up the new channels.

  • Create a new item on each player

String YourPlayer_PlayFavorite "Play Favorite [%s]" { channel="squeezebox:squeezeboxplayer:736549a3:00042016e7a0:playFavorite" }

For HABpanel (do this for each player)

  • Add a Selection widget to your dashboard

  • In the Selection widget settings

    • Enter the YourPlayer_PlayFavorite item

    • Select Choices source of Server-provided item options

    • Modify other settings to suite your taste

  • When you load the dashboard and click on the selection widget, you should see the favorites. Selecting a favorite from the list will play it.

For Sitemap

  • To use state options on the playFavorite channel, simply omit the mappings from the Selection widget.
Selection item=YourPlayer_PlayFavorite label="Play Favorite"

Notifications

How To Set Up

Squeeze Players can be set up as audio sinks in openHAB. Please follow the openHAB multimedia documentation for setup guidance.

You can set the default notification volume in the player thing configuration.

You can override the default notification volume by supplying it as a parameter to say and playSound.

You can play notifications from within rules.

rule "Garage Door Open Notification"
when
    Item GarageDoorOpenNotification received command ON
then
    // Play the notification on the default sink at a specified volume level
    say("The garage door is open!", "voicerss:enUS", new PercentType(35))
    // Play the notification on a specific sink
    say("The garage door is open!", "voicerss:enUS", "squeezebox:squeezeboxplayer:5919BEA2-764B-4590-BC70-D74DCC15491B:20cfbf221510")
end

And, you can play sounds from the conf/sounds directory.

rule "Play Sounds"
when
    Item PlaySounds received command ON
then
    // Play the sound on the default sink
    playSound("doorbell.mp3")
    // Play the sound on a specific sink at a specified volume level
    playSound("squeezebox:squeezeboxplayer:5919BEA2-764B-4590-BC70-D74DCC15491B:20cfbf221510", "doorbell.mp3", new PercentType(45))
end

Known Issues

  • There are some versions of squeezelite that will not correctly play very short duration mp3 files. Versions of squeezelite after v1.7 and before v1.8.6 will not play very short duration mp3 files reliably. For example, if you're using piCorePlayer (which uses squeezelite), please check your version of squeezelite if you're having trouble playing notifications. This bug has been fixed in squeezelite version 1.8.6-985, which is included in piCorePlayer version 3.20.

  • When streaming from a remote service (such as Pandora or Spotify), after the notification plays, the Squeezebox Server starts playing a new track, instead of picking up from where it left off on the currently playing track.

  • There have been reports that notifications do not play reliably, or do not play at all, when using Logitech Media Server (LMS) version 7.7.5. Therefore, it is recommended that the LMS be on a more current version than 7.7.5.

  • There have been reports that the LMS does not play some WAV files reliably. If you're using a TTS service that produces WAV files, and the notifications are not playing, try using an MP3-formatted TTS notification.