KinskyJukebox Manual

Table Of Contents

  1. Introduction
  2. Installation
  3. System Requirements
  4. Operation
    1. Using KinskyJukebox
      1. Initial Setup
      2. Using the Wizard
      3. Scanning your Collection
      4. Organizing your collection
      5. Exporting your Presets
      6. Sending your Preset Location to your Linn DS device
      7. Printing your collection
      8. Importing your Presets
      9. Using the Http Server
      10. Generating All Presets
    2. Selecting Presets on your Linn DS device
  5. Troubleshooting
  6. Developers
  7. Appendices
    1. Apache configuration on QNAP
    2. Configuration of ReadyNas web server
    3. Installation and Configuration of Apache on WHS NAS

Introduction

The jukebox service provides a means of loading stored presets (playlists with numerical names) into your Linn DS device from a known http location, bypassing any media server application. KinskyJukebox provides an easy way to scan and organize your collection into presets, allowing you to save these presets and sync the location with your DS device. It also provides a way to print your preset catalog for easy reference and contains a built in Http server if required.

If you are using a NAS device, you will need to enable its built in http server from its configuration page. Alternatively, you can run KinskyJukebox (or other available http servers such as Apache) as your http server from your PC. You can not use Twonky or other similar media server applications as your http server, it must be a standard http server to function correctly.

Installation

To install KinskyJukebox double-click on the KinskyJukebox downloadable from the download page. Follow the on screen installation instructions to complete the installation. Upon a successful installation, you can access KinskyJukebox by tapping Start->Programs->Linn->KinskyJukebox.

KinskyJukebox can be uninstalled using your platforms normal mechanisms for removing programs. An uninstaller program is distributed with the application if you want to uninstall it manually.

System Requirements

* OS: Windows XP/Vista with Microsoft .NET Framework v2.0, Linux with Mono v2.4, or Mac OS X with Mono v2.4
* RAM: 512MB
* Video Card: 800x600

Operation

Using KinskyJukebox

Initial Setup (Tools->Options->Media Collection)

  1. Select the default location of your music collection using the browse button
  2. Choose the categories that will be created when your music collection is scanned by ticking the relevant box (ie Artist/Album?, Genre, etc)
  3. Select the name of your compilations folder using the find button.
  4. If you have selected the Artist category, tick the box on the right if you want all artists for compilation albums to be stored as 'Various'
  5. A New music category can be included for easy access to recently ripped music. Use the number box to determine how far back the new music category should go
  6. Click the Randomize tick box to randomize large playlists (> 1000 tracks). Otherwise the first 1000 tracks will be used.
  7. Click the Sort albums by year tick box to sort albums chronologically (default behavior is alphabetical sorting of albums)
  8. Enter the http address of your music collection, can be verified using the test button. If you are not using a NAS device with a built in Http server, you can just tick to enable KinskyJukebox as your Http server instead.

Using the Wizard

  1. Press the wizard button on the top left to open the wizrd dialog.
  2. Press the start button to begin the wizard
  3. The wizard will then guide you through the necessary steps to create presets from your music collection based on the categories selected (artist/album, genre, etc)
  4. At various stages the wizard will need to prompt for a decision. Click on 'Remember my Decision' to insure that the wizard will always behave this way. You can change these options under Tools->Options->Wizard as well.

Scanning your Collection (Full Scan)

  1. Press the full scan button on the top left, your music collection will be scanned and organized into categories.
  2. This operation may take a while depending on the size of your collection
  3. Once complete, your collection is presented as a group of boomarks. One for each of the categories you selected.
  4. Each bookmark contains a group of presets for the given category
  5. Each preset contains a group of tracks as well as metadata and album art information (similar to a playlist)
  6. Press the play button to play a selected track on your computer

Scanning your Collection (Quick Scan)

  1. Press the quick scan button on the top left, you will be prompted to select a directory within your music collection (ie a new album).
  2. Only presets based on your selection will be created.

Organizing your collection

  1. If you want to use all of the presets created during scan, simply press the 'Sync with Scanned Collection' button
  2. Syncing with a full scan will reorder your presets, syncing with a quick scan will add the new presets to the end of your list
  3. Otherwise, you can Add bookmarks, presets, or tracks from your scanned collection into the middle (Preset) section using the Add button or by dragging and dropping.
  4. Any bookmark or preset can be moved, deleted, renamed, copied, or pasted.
  5. There are also buttons for creating new (empty) bookmarks and presets
  6. The preset number identifies which digit keys could be pressed on your handset to directly access it on your Linn DS device. Move the preset up and down in the list to change this number

Saving your Presets

  1. Press the save button to save your presets to the location defined in the options menu.
  2. This operation may take a while depending on the size of your collection
  3. Once complete, you will be asked if you wish to send the preset location to your Linn DS device

Sending your Preset Location to your Linn DS device

  1. This operation only has to be done once unless your http server address changes
  2. Select your device from the list of available devices and click Apply
  3. At this stage you will be able to select and listen to your presets on your Linn DS device
  4. Press the Test button to test the jukebox functionality on a selected device. This will send a random preset to the device which should start playing. The device must be set to the given location first.

Printing your collection

  1. These operations may take a while depending on the size of your collection
  2. You can use the print preview button to preview your collection as a catalog
  3. You can use the print button to print your catalog as an Adobe pdf file (read only) or an rtf file (editable)
  4. The catalog can contain a quick reference table of contents, followed by a page (or more) for every preset, including album art and track metadata (optional)
  5. User is prompted prior to print to select various options (these options are remembered for next time):
    1. Sections to print (ie TOC, Artist / Album, Genre, etc)
    2. Orientation (landscape or portarait with or without track details)
    3. Pages per sheet (1, 2, 4, 8, 9, 16, 25, 32, 36)
    4. File type (PDF or RTF)
    5. Folded booklet ordering (if using multiple pages per sheet, order is adapated for printing double-sided folded booklets)
  6. Have a look at this sample catalog

Importing your Presets

  1. If you are returning to KinskyJukebox, you can import your previously created presets and bookmarks using the import button.
  2. This operation may take a while depending on the size of your collection
  3. Any playlists created using KinskyDesktop will also be loaded into a new bookmark called 'Miscellaneous'. The preset will be named using the file name of the playlist. This assumes that you have told KinskyDesktop to save playlists into the same folder as will be used by KinskyJukebox (<music collection path>/_Presets). On export, the original playlist file will be deleted and replaced with a numerically named preset file.

Using the Http Server

  1. You can use KinskyJukebox as an Http Server by selecting the option in the menu
  2. Simply click to minimize the application and the server will continue running in the background
  3. Presets will be served by KinskyJukebox as long as the computer running KinskyJukebox remains on
  4. If you are serving your Presets from a NAS device with a built in Http server, this is not required

Selecting Presets on your Linn DS device

Once you have created your presets using KinskyJukebox and sent their location to your Linn DS device, you will be able to select any of your presets from your IR handset as long as your Http Server is running.

Directly select a numerical preset by pressing digits keys, leading with a 0

ie to select preset 12, press 0 + 1 + 2

Select the next/prev preset in your list using the scan keys on the handset (single arrow). This requires Cara 6 device firmware or higher

Browse through your named presets and bookmarks using the navigation keys

Press the select navigation key to begin browsing presets
Press the left navigation key to begin browsing bookmarks
Use the left navigation key to go to your bookmarks
Use the right navigation key to go to your presets
Use the up and down navigation keys to browse through your bookmarks and presets
Press the select navigation key once you have chosen a bookmark and it will got to the first preset in that bookmark for browsing
Press the select navigation key once you have chosen a preset and it will be loaded into your Linn DS device for playing
You can search your presets alphabetically during browse by using the digit keys on your handset to enter text (like a mobile phone) and then press select to find a match
You can page through your presets (jump ahead 20 items) during browsing using the scan keys on the handset (single arrow keys)

Troubleshooting

Drag and Drop on Mac

Drag and drop support is not currently implemented in Mono v2.4 for Mac OS X. The application will immediately exit if this is tried.

Developers

Detailed developer documentation relating to the Jukebox service can be found  here

Appendices

Appendix A: Configuration of Apache HTTP server on QNAP NAS

The QNAP NAS devices come with the  Apache HTTP server pre-installed which is suitable for use with KinskyJukebox. However this requires manual reconfiguration to map access to the Qmultimedia (audio files) folder and permit folder browsing.

  1. Enable telnet access to the QNAP
    • In QNAP settings select Network Services -> Remote Login
    • Check the box beside Allow Telnet Connection
    • Press Apply

  1. Open a Windows command prompt
    • XP: Start->Run, type cmd and press Enter
    • Vista/Win?7: type cmd in Search box and press Enter
  2. Telnet into QNAP NAS
    • At command prompt type telnet <NAS IP> 13131 and press Enter
    • Enter NAS user name and password when requested (admin/admin by default)
  3. Create link from multimedia folder to web folder
    • Enter the following commands at the telnet prompt
      • cd /share/Qweb and press Enter
      • ln -s /share/Qmultimedia multimedia and press Enter
  4. Check link setup
    • Type ls -l at telnet prompt
    • Check for entry containing multimedia -> /share/Qmultimedia

  1. Exit telnet
    • Type exit at telnet prompt
  2. Install WinSCP to facilitate update to Apache configuration file
  3. Connect to NAS using WinSCP
    • Open WinSCP
    • Enter <nas ip> address for Host name
    • Enter admin for User name
    • Enter <password> (default admin) for Password
    • Select SFTP for File protocol
    • Press Login
  4. Navigate to Apache configuration using WinSCP
    • Browse to /mnt/HDA_ROOT/apache/conf

  1. Edit apache.conf by right-clicking on icon and selecting Edit
  2. Update configuration file
    • Add the word Indexes in the Options section of <Directory "/share/Qweb">

  1. Save the updated file
  2. Disable and re-enable QNAP web server
    • Uncheck Enable Web Server in Network Services -> Web Server and press Apply
    • Wait 10 seconds
    • Check Enable Web Server in Network Services -> Web Server and press Apply

  1. Check setup
    • Use web browser
    • Navigate to  http://<nas ip>/multimedia
    • Should see list of folders in your music collection

NOTE that after the server is enabled, the QNAP web interface will be available at http://<qnap-ip-address>:8080

Appendix B: Configuration of ReadyNas Web Server

Follow the steps below to configure the built in web server of a ReadyNas device to work with Kinsky Jukebox. The directions below assume you are using the 'Media' share.

  1. Open up ReadyNas Frontview to configure your NAS (https://<ip address of nas>/admin)
  2. Under Shares => Share Listing => Media => HTTP/S: Set 'Default Access' to 'Read-only' and click 'Apply'
  3. Under Services => Standard File Protocols => HTTP: Set 'Redirect default web access to this share' to 'Media', and set 'Login authentication on this share' to 'Disabled' and then click 'Apply'.
    • NOTE: Only one share on the NAS can be set to be the default http access share, and only this one share can have login authentication disabled
  4. You should now be able to access the Media share by typing http://<ip address of nas>/Media into a web browser, without having to enter a username or password.
    • NOTE: The 'http' part of the address should not change to 'https'. This is a reported issue against Radiator 4.1.6. Please see these help threads from Netgear to get around this problem:  Help Thread 1 ,  Help Thread 2

Appendix C: Install and Configure Apache Web Server on WHS NAS

NAS device which use the Windows Home Server (WHS) operating system come with the IIS web server pre-installed and configured for remote access. This is not suitable for use as a Kinsky Jukebox server, hence installing Apache as an additional web server to serve the audio files is recommended for this application. This does mean that files will be served on a non-standard port, hence the address will contain the port number.

  • Connect to WHS NAS using Remote Desktop (if using a Mac see  here)
  • Download  Apache Web Server - select the apache_2.2.14-win32-x86-no_ssl.msi executable
  • Install Apache web server - accept defaults for all settings
  • On completion Apache will attempt to start, but will most probably fail with and error. This will be fixed when Apache is configured
  • Configure Apache be editing its configuration file
    • Start->All Programs->Apache HTTP Server 2.x->Configure Apache Server->Edit the httpd.conf Configuration file
    • Change the Listen to port to 8080 
      #
# Change this to Listen on specific IP addresses as shown below to 
# prevent Apache from glomming onto all bound IP addresses.
#
#Listen 12.34.56.78:80
Listen 8080
    • Change DocumentRoot to Music directory 
      #
# DocumentRoot: The directory out of which you will serve your
# documents. By default, all requests are taken from this directory, but
# symbolic links and aliases may be used to point to other locations.
#
DocumentRoot "D:/Shares/Music"
    • Change Directory reference to updated DocumentRoot 
      #
# This should be changed to whatever you set DocumentRoot to.
#
<Directory "D:/Shares/Music">
    #
    • Save the updated configuration (File->Save)
  • Restart Apache (can use the Taskbar icon)
  • Add exception to firewall
    • Start->Control Panel->Windows Firewall
    • Select Exceptions tab
    • Add program C:\Program Files\Apache Software Foundation\Apache2.2\bin\httpd.exe
  • Test using web browser on  http://ripnas:8080 - should get directory listing of top level Music directory
  • User options in Kinsky Jukebox should set
    • Default location of media collection -> \\Ripnas\Music
    • Http location of media collection ->  http://ripnas:8080