Change Log
Help
Email: info@angrygoatapps.com
Web: www.angrygoatapps.com
Twitter: angrygoatapps

| About |  |  |

Squeeze Control is a remote control app for the Squeezebox networked music system. This app replicates most of the functions of the SqueezeBox Controller. Since it communicates with the server using the same methods as the Controller, it will show the same menus, minus the ones that are specific to the Controller. I've tweaked the user interface for touch screen use and added some features I hope you'll find useful. Read the sections below for more details. Thank you for purchasing this app.

| Requirements |  |  |

- A MySqueezebox.com account or a Squeezebox Server.
- I've tested this app with version 7.4 - 7.7 of SqueezeBox Server. It will not work with anything older.
- This app has been tested with the Squeezebox Receiver, Boom, Radio, and Touch. It should generally work with every player the Squeezebox Controller would work with.

| Setup |  |  |

Please see the Preferences section for more details, but here's few quick tips.

- If you're using a Squeezebox Server, make sure Wifi is turned on. It's possible for this app to work without Wifi, but it's a much more complicated setup that's beyond the scope this app. If you're interested please refer to the online documentation of Squeezebox Server. Also, make sure the server is accessible on your network and you can view its web interface from the web browser of your phone. The default address of the web interface is "http://(address of server):9000" with (address of server) being of the from XXX.XXX.XXX.XXX, eg. 192.168.1.101
- If you want to view the server's web interface on the computer that it's installed on, open a browser and type in 'http://localhost:9000'. This is NOT the correct address for adding a server to this app. Please see the preferences section for more information on how to do this.
- You can download a copy of Squeezebox Server from here: http://www.mysqueezebox.com/download
- The current generation of Squeezebox devices default to using MySqueezebox.com as their music source. To change this to your own Squeezebox Server, you can either change it through the menus of the device (it should be under Settings > Advanced > Networking), or use this app. See the Preferences section for more information.
- If you're using MySqueezebox.com, make sure your phone and your Squeezebox device can access the internet.
- Use the latest version of Squeezebox Server if you plan on using MySqueezebox.com too.
- If you are seeing random connection errors, try rebooting/resetting the phone. This applies to random errors in other apps too. As a general tip for WebOS phones, if you play a lot of 3D games on the phone and you're experiencing memory errors, reboot. Not really a fault of the phone, it's a lot harder for app developers to make sure 3D games don't have memory leaks.

| Upgrading from 1.X |  |  |

The user interface has been completely redesigned and a few controls have been moved to different locations. The following is a list of the most significant changes.

- The player selector has been moved from the 'Home' screen to the Player Menu, which is accessed by tapping the area between the volume up and rewind buttons.
- Sleep, Repeat, and Shuffle controls have also been moved to the Player Menu from the menu panel of the 'Current Playlist' screen.
- The Preferences option to show the server selector on the home screen has been removed. Instead a server selector is now always available in the menu panel of the 'Home' screen. Tap the title bar to show the menu panel.

| webOS 2.x Features |  |  |

The features described in this section are only available on devices running webOS 2.X or higher.

- Just Type - To add Squeeze Control as a search option, go to the 'Preferences' screen of 'Just Type' and tap 'Add More Searches' under the 'Launch & Search' section.
- Exhibition Mode - This is only available on webOS 2.1 or better. To enable exhibition mode, start the 'Exhibition' app and set Squeeze Control to 'On'. When in exhibition mode, if the main app is running and already connected to a server, the now playing screen will be displayed. Otherwise, you will see a 'Connect' button. Tap it to connect to the most recently selected server and player.
  On the now playing screen, the following gesture based commands are available:
  Tap - play/pause
  Flick left/right - rewind/foward
  Drag up/down - volume up/down

| General |  |  |

It should be pretty self explanatory how you navigate through this app, but there a few details you will need to know about.
Now Playing
Tapping on this button brings you to the 'Now Playing' screen.
Current Playlist
When on the 'Now Playing' screen, this button will replace the 'Now Playing' button. Tapping on it brings you to the current playlist screen.
Add Button
Tapping on this button adds the item to the current playlist.
Options Button
Tapping on this button opens a drawer under the item to reveal more options.
Add/Options Button
This button is a combination of the Add and Options button. Tapping will add the item. Tap and hold will open the options drawer.
Menu Panel
Tapping on the title bar of some screens will open a menu panel. For example the image is of the menu panel of an album listing
Player Menu
Tapping on the area between the volume up and rewind buttons will bring up the "Player Menu". This menu is where you select which player to control. It also contains additional controls for the currently selected player.
Tap and holding the same area will directly bring up a player selector.
Home Menu Panel
Tapping the title of the 'Home' screen will open a menu with the following items:

- Orientation (locked/unlocked) - Set to 'locked' to lock the display to the current orientation
- Use MySqueezebox (on/off) - Controls if the app will connect to MySqueezebox.com
- Use Server (on/off) - Controls if the app will connect to the server specified in the next item.
- Server - Selects the server to connect to.

Use MySqueezebox, Use Server, and the Server Selector are duplicates of the same the controls in Preferences. They are placed here for convenience.
Now Playing screen

- Tapping on the title bar, opens a menu with options for the currently playing item.
- Tapping on the artwork will bring up an interactive progress bar for local tracks. For music streams a non-interactive progress bar will be brought up if the stream has a duration.
- Swiping left rewinds the current song. Swing right skips the current song.

Deleting and Reordering
Deleting and/or reordering items is allowed on certain screens.

- Deleting is performed by swiping the item off to the side.
- Reordering is preformed by Tap and Holding an item.
- The Saved Playlist and Favorites screen will only allow deleting.
- The Current Playlist and the Save Playlist Tracks screen allows both deleting and reordering.

| Search |  |  |

To perform a music search, just start typing while on any screen other than the Preferences and Help screens.
General Search
This is the search panel for most of the screens.
Item Filter
This is the panel you'll see when you are browsing your music library. It filters the items of the screen you are browsing. (Note: Due to bugs in Squeezebox Server this filtering function is disabled under certain conditions. For SB Server 7.4-7.5 it is disabled when you are browsing artists of a genre. For SB Server 7.6.0-7.7.0, it is disabled when you are browsing genres)

| Preferences |  |  |

MySqueezebox.com
If you plan on using both MySqueezeBox.com and a local Squeezebox Server, please update your local server to the latest version. MySqueezebox.com generally works best with the latest version of Squeezebox Server, especially when switching players between the two.

- The USE MYSQUEEZEBOX switch controls if the app will connect the MySqueezebox.com. It must be 'ON' for the app to control any players connected to MySqueezebox.com. This switch is also on the menu panel of the 'Home' screen.
- The first time the app connects to MySqueezebox.com, you will be asked to either create a new account or to login to an existing one.
- Right after the initial registration process, the app may say there are no players connected even when there are. Either wait a minute for MySqueezebox.com update itself or disconnect and reconnect.
- Response from players connected to MySqueezebox.com will naturally be slower than ones connected to a local Squeezbox Server. How much slower depends on your network connection and if MySqueezebox.com is busy.
- The MAC address shown can be used to identify this app on the players page of your account when you sign on from a web browser. This app will show up as a generic player just like a Squeezebox Controller. The status will always be 'Not Connected', that's normal. A 'Connected' status is only for actual players that can play music.
- This is NOT the MAC address of your phone. It was generated when the app was installed. It will remain the same even when the app is upgraded. The only way to change it is to completely delete the app from your phone then reinstall it.
- If you want to register this app with another account, press the Re-Register button and disconnect from the server. When you connect again, you will be ask to re-register. Or you can delete the player item associated with this app in your MySqueezebox.com account.
- When you are connected to both MySqueezebox.com and a Squeezebox Server, the 'Music Source' item will appear in your home menu which will allow you to switch the current player between the two sources. For this to actually work, you must provide your Squeezebox Server with your MySqueezebox.com login info. You can do this in the account tab of the Squeezebox Server Control Panel, or the mysqueezebox.com tab in the setting page of the web inteface.
- If the app is set to use both MySqueezebox.com and and a SqueezeBox Server, there's constant communication between the app and both sources. To save battery life, it's recommended that you only turn on one source at a time until you need to do something that needs both.
- Switching a player from MySqueezebox.com to your server and vice versa can be very slow, depending on your connection to MySqueezebox.com and if that site is busy or not. It is also not a completely stable process especially if you are not using the latest version of Squeezebox Server. If the switching fails and the player loses connection with both sources, go the player's controls to choose a server to connect to. **For the Receiver you will need a Squeezebox Controller to do this. You need to reset the receiver by pressing and holding the button in the front until it starts blinking red fast. When the blinking slows down, you should be able to find it using the controller to setup it up again.
- A MySqueezebox.com account is required to view the squeezebox app gallery and to use any of the apps like Pandora or Rhapsody. When a player is connected to your Squeezebox Server, the server must have your login info for squeezebox app system to work.
- When a player is connected to MySqueezebox.com, your local music collection will be unavailable to it and the 'My Music' menu item will not appear in the home menu.
- For more information on MySqueezebox.com, please visit MySqueezebox.com

Managing Servers

- The USE SERVER switch controls if the app will connect to the chosen Squeezebox Server. It must be 'ON' for the app to control any players connected to that server. This switch is also on the menu panel of the 'Home' screen
- CURRENT SERVER is the server that this app will connect to.
- Tap "Add Server" to add a server.
- Tap on a server name to edit it's settings
- Swipe to delete a server
- Tap and hold to change the order of servers (Note: this is just for organizational purposes only)

Server Settings

- Server name is for identification purposes only. It doesn't affect the connection in any way
- Server address can be an IP address (eg. 192.168.1.1) or a domain name (eg. somename.com). If the address is not prefixed by "http://" the app will automatically add it. If you've setup a connection using a different protocol, make sure you use the correct prefix, eg. an SSL connection would require the "https://" prefix. The server address can be found on the information page of your SqueezeBox Server settings. Do not use the url in the address bar of your browser when you access the web interface of your server (this maybe wrong depending on the machine you're accessing the server from)
- Server port is optional. If you specify it here, make sure you do not have it in the address field
- Username and Password is optional. Only set this if you've enabled security on your SqueezeBox Server. If you haven't enabled security, make sure to uncheck the 'Save login' checkbox

| Backgrounds |  |  |

You have a choice of predefined background colors for this app along with the ability to use a custom image as the background. Each player can also have a different background color or custom image.

- The Default Background selector in Preferences chooses the background to use for players that do not have an assigned background.
- To assign a background to a player, open the Player Menu and tap 'Select Player Background'
- If you choose to use a custom background, a picker screen will appear to allow you to pick an image. When you select an image a cropping screen will appear with a white rectangle indicating the cropping area. You can pan and scale the image to pick cropping area. Then tap 'Open Photo' to select the indicated crop as the background.
- Using a large image as a background may make the app sluggish, even if you crop to a smaller area.

| Manage Players |  |  |

This screen gives to access to the basic controls of every player connected to single server, at the same time. This is also where you can control how the players are synchronized with each other.

- Tap on the name of a player to open a drawer with its playback controls.
- The green power light to the left of the player name is also a power button.
- Tap the server name button on the right side of the header to choose between seeing players connected to your local server, or players connected to MySqueezebox.com. This only works if you are connected to both servers.
- To synchronize players, tap the checkbox of the players you want to synchronize. Then tap the 'Sync To' button and choose the player you want to synchronize to from the popup menu.
- To unsynchronize players, tap the checkbox of the players you want to unsynchronize and tap 'Unsync'.

| Song Download |  |  |

When connected to a local Squeezebox Server, you have the option to download songs from the server onto the Touchpad.

- Only songs files that are on the server can be downloaded. You cannot download songs from internet services like Rhapsody or Spotify.
- The built-in server of the Squeezebox Touch needs to be at least version 7.6 to support song downloading.
- Downloading is available for songs, albums, artists, saved playlists and current playlist. You can find the download button in the options drawer of the mentioned items and also in the header menu.
- The download button queues each item for download in the 'Download Manager', which you can access from the app menu.
- By default the downloads do not automatically start. You can change this in Preferences.
- Files are NOT transcoded when you download them.
- The app must be running for the downloads to proceed, but it does not have to be the active app.
- Once a song is queued for download, the app does not have to be connected to server for the downloading to proceed.
- Swipe an item to the side to delete it from the list.
- Closing the app erases the download queue.

| Known Issues |  |  |

Automatic server discovery is not available in the current version of this app. Implementing it will require at least webOS version 2.2.0, which is currently only used on a Pre 3. Since the majority of users of this app is still using webOS 1.4.5, I cannot implement server discovery without cutting off those users from future updates.
Some SqueezeBox apps may not work or only work partially. The structure of the commands the server sends to the controller is a bit inconsistent, so there's no way I can make sure every app works without testing all of them. I've listed below I ones I have tested to be fully functional. Please visit the website for a more up to date list.

- BBC
- AccuRadio
- Amazon CD Store
- Facebook
- Flickr
- Last.FM
- MP3tunes Music Locker
- Napster
- Odeo
- Pandora
- Queen
- Rhapsody
- Shoutcast
- SIRIUS Internet Radio
- Slacker
- SomaFM
- Sound & Effects

| Important Note |  |  |

When this app is connected to a server or MySqueezebox.com, there is constant communication between the two. If you're not connecting through Wifi, this may incur a significant data access fee on your phone bill.
For the best experience, please connect through Wifi. It will work on a cell data service (assuming you've setup external access to your server), but the performance will be sluggish.