Songbox for Mac and Windows

Quick Help (press an area of the screenshot for assistance on that section):

  1. Introduction
  2. Installation
    1. System Requirements
      1. Mac
      2. Windows
    2. Installing
      1. Mac
      2. Windows
    3. Uninstalling
      1. Mac
      2. Windows
    4. Updating
  3. Running Songbox
  4. Configuring Songbox
  5. Help
  6. Preferences
  7. Library
  8. iTunes
  9. Media Apps
  10. Songbox in Kinsky
  11. Troubleshooting
    1. Known Issues
      1. Songbox fails to start on Windows when running Bizmodeller iHomeserver …
      2. Upgrading shared playlists from 4.2.1 to 4.3.62
      3. Try and add/edit iTunes Music Library location and get the message …

Introduction

Songbox provides the ability to browse and playback music on a Linn DS or UPnP media renderer. Songbox allows a UPnP control point, such as Kinsky, to,

  1. Browse music in folders on a local machine or on a mapped network share
  2. Browse an iTunes installation
  3. Listen to online content
  4. Save and Share playlists

Installation

System Requirements

Mac

  • Mac OS X Snow Leopard 10.6.8 or later
  • Mac OS X Lion
  • 32 or 64-bit hardware

Windows

  • Windows XP/Vista/7/8/Home Server
  • 32 or 64-bit hardware

Installing

Mac

  • Download the .dmg file from the download page
  • Double click the downloaded .dmg file
  • Double click the InstallerSongbox.pkg file contained within the window which pops up with the dmg contents
  • Follow the on screen instructions in the installer program

Windows

  • Download the installer from the download page
  • Double click the downloaded .exe file
  • Follow the on screen instructions in the installer program

Uninstalling

Mac

  • Download the .dmg file from the download page
  • Double click the downloaded .dmg file
  • Double click the uninstall.tool file and provide your password to the script if prompted

Windows

  • Open the Windows Control Panel and double click "Programs and Features"
  • Select "Songbox" in the list of programs and click the "Uninstall" button
  • Follow the on screen instructions in the uninstall window

Updating

Songbox for Mac and Windows will automatically check for new software updates and notify you via a badge on the preferences button (see below).

If an update is available, a button will appear in the preferences page which will open a dialog providing details on the update. Pressing the update button will cause Songbox to update to the latest stable or beta version (depending on whether you have selected the option to join the beta program in preferences).

Alternatively, Songbox can be updated by manually downloading the installation packages from the download page and installing them using the method described in the Installing section above.

Running Songbox

After installation, Songbox will run automatically using the user account of the first user who logs in and remain running as that user whilst they remain logged in.

If the user account running Songbox is logged out, Songbox will attempt to find another logged in user and run using the account of that user.

If you wish Songbox to run without intervention on computer restart, you must also configure a user account to log in automatically.

* On Mac, choose Automatic Login user under System Preferences, Users & Groups.

* On Windows, there should be an checkbox entitled "Users must enter a user name and password to use this computer" under Ctrl Panel, User Accounts, Manage User Accounts.

On Windows Home Server and other Windows Server installations, Songbox will run as the local system and does not require a user to be logged in.

Configuring Songbox

After installation of Songbox, you should ensure that you have also downloaded Konfig. When you run Konfig, Songbox will appear in the device list under the configuration tab (note: if running Songbox on a Mac or on a Windows Desktop, you must ensure a user is logged in for Songbox to be running - on Windows Home Server this is not necessary).

Clicking on the Songbox device in Konfig will bring up the main settings page.

The main settings page consists of 3 sections (detailed below), plus a help button which links to this manual and a preferences button which opens the preferences page.

Each of the 3 main sections Library, iTunes, and Media Apps can be individually enabled or disabled via the On / Off switch next to the section header.

In addition, a configuration button takes you to a configuration page for each section.

Help

The help button opens this manual in your default web browser.

Preferences

The preferences button opens the preferences page.

Here, you can choose which network to run Songbox on if you have more than one network, choose whether or not to send crash reports to Linn, choose whether to participate in the beta program and update Songbox when updates become available.

Clicking the 'BACK' button will take you back to the main settings page.

Library

The Library settings page allows you to add or remove folders containing music to be indexed by Songbox and made available to Kinsky for playing on your DS.

Clicking the 'ADD' button brings up a dialog which allows you to select a folder to add. Once Songbox has scanned this folder for music, a delete and refresh button will be available next to this folder in case you wish to remove it again or force a rescan.

Any network drives mapped by the user account Songbox is running under will appear in the drive letters dropdown within this Dialog (on Mac, these will appear as /Volumes/XXX).

Folders on a local hard drive on your computer should automatically refresh if their contents change, but a refresh button is also provided in case you have selected a mapped network drive which may not notify Songbox when its contents change.

Within the Library settings page, you can also edit the default label used for various artists in compilation albums.

Clicking the 'BACK' button will take you back to the main settings page.

iTunes

iTunes stores its music collection in a file called "iTunes Music Library.xml", which is stored by default in the Music folder of the logged in user.

Clicking the 'BROWSE' button in the iTunes settings page brings up a file chooser which allows you to select a new location if the default location of the iTunes library file is not correct for your setup.

This should automatically refresh if the iTunes music collection changes, but a refresh button is also provided to allow manual refreshing.

The 'DEFAULT' button restores the default iTunes xml file location (<<user home>>/Music/iTunes/iTunes Music Library.xml).

Clicking the 'BACK' button will take you back to the main settings page.

Media Apps

Media apps is an aggregation of common media sources available online. Content from individual providers appears as an item within the list of media apps.

These will refresh periodically but can also be manually refreshed by pressing the refresh button .

Individual apps can be enabled and disabled via the On / Off switch next to that app and it will appear and disappear in Kinsky accordingly.

Clicking the 'BACK' button will take you back to the main settings page.

Songbox in Kinsky

Songbox appears as a media server in the Library page of Kinsky.

We advise if Songbox is being used to turn off the iTunes Plugin with Kinsky and use Songbox for this instead.

Troubleshooting

Known Issues

  • If you have a compilation Album, in some cases you will get a repeat of the same Album but have different Artists against each Album cover, but iTunes only show this one Album. The solution in this case is to go into iTunes and "Get Info" on that Album, you will find that the Album Artist is blank. Add in either "Various Artists" or the primary artist name. This will fix the multiple Albums in Songbox listings.
  • iTunes does not save the coverart (folder.jpg) in the same folder as the Music files. If there is no coverart embedded in the Music files (typical with a CD-RIP), then you may have use software to either add the folder.jpg or embed the cover art on the Music files. Check  Linn Docs for instructions to add this.
  • If no coverart within the Library view then
    1. check that there is a folder.jpg within each Album folder
    2. Go into Preferences and check that there is a Network defined
  • Check the within the MAC OSX System preferences - Energy Saver - Computer sleep is set to Never.
  • If you have just installed iTunes11 and Songbox had stopped working then check that the iTunes location is still correct. iTunes may have changed this to /Users/------/Music/iTunes/iTunes Library.xml instead of /Users/------/Music/iTunes/iTunes Music Library.xml.
  • Songbox cannot share iTunes Music that resides in the iCloud (iTunes Match). iCloud Music can only be accessed by Apple devices.
  • If there is no coverart and the Linn DS/DSM will not play any of the tracks, check the Network settings of the Songbox. If this is set to "No Network" then Songbox can cause this issue

Songbox fails to start on Windows when running Bizmodeller iHomeserver application

  • There is a known issue with Songbox failing to start on Windows startup if Bizmodeller iHomeserver is also running on the machine. We are aware of the issue and are trying to find a fix, however the workaround for now is either to disable iHomeserver or start the Songbox service manually after restarting Windows.

Upgrading shared playlists from 4.2.1 to 4.3.62

Upgrading from Songbox 4.2.1 to 4.3.62 will break existing shared playlists.

You should use the following tool to migrate these:

http://oss.linn.co.uk/Releases/Songbox/Davaar/migrate_shared_playlists.zip

  • Windows Vista/7: unzip the above file to desktop and right-click, run windows.bat as administrator
  • Windows XP/Server 2003: unzip the above file to desktop and double click windows.bat
  • Mac: unzip the above file to home folder and double click mac.tool

Try and add/edit iTunes Music Library location and get the message "File path cannot be accessed"

This is typically on a multi-user PC/MAC. If the PC/MAC has just started Songbox is started on the first user logon. <br> If you do not log-out of this user and only SWITCH to another user this can cause issue in file/folder permissions. <br> If you are going to edit the Songbox settings then the solution is to logout of the all of the other users and only have a single user logged in. That is, the simple solution is to restart the PC/MAC and first of all log-into the User whose iTunes library you are using. The use Konfig within this user to make the settings.