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. Configuration of QNAP web server
    2. Configuration of ReadyNas web server
    3. Installation and Configuration of Apache on WHS NAS
    4. Making a NAS drive visible on MAC
    5. Handling NAS which requires username and password

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. You will also need to ensure that the NAS is always allocated the same IP address (use your router to designate an address or use static IP setup within the NAS. Using the NAS name i.e. //nas001/share will not work). 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->Setup)

  1. Scan Directory: Select the default location of your music collection using the browse button
  2. URL of Scan Directory: 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 use KinskyJukebox as your Http server instead (if you tick this option, Kinsky Jukebox must be running at all times to serve your music).
  3. Compilations Folder Name: Select your compilations folder using the browse button.
  4. Randomize Large Playlists: Click the Randomize tick box to randomize large playlists (> 1000 tracks). Otherwise the first 1000 tracks will be used.

Initial Organisation Setup (Tools->Options->Organisation)

  1. Sort by New: A New music category can be included for easy access to recently ripped music. If ticked, use the New Music cutoff (days) box to determine how far back the new music category should go
  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. If you have selected the Artist category, select how to Group Compilation Artists using the drop down box (Group as 'Various' or retain artist names)
  4. If you have selected the Artist/Album, Album Artist/Album, or Album category, use the Album Arrangement drop down box to arrange albums alphabetically or chronologically (using the Year tag)

Using the Wizard

  1. Press the wizard button on the top left to open the wizard 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 QNAP Web Server

  1. Open up the QNAP web interface to configure your NAS (http://<qnap-ip-address>:8080) and click on 'Administration'
  2. Under Network Services => Web Server: Tick 'Enable Web Server' and 'Enable WebDAV' and hit the 'Apply' button

  1. Under Access Right Management => Share Folders: click on the 'WebDAV Access Control' button for the 'Multimedia' share

  1. Inside the pop up window: Tick 'Allow guests to have read access to this network share (applies to web browser only).' and hit the 'Apply' button

  1. You should now be able to access the Multimedia share by typing http://<qnap-ip-address>/Multimedia into a web browser, without having to enter a username or password.
    • NOTE: that after the web server is enabled, the QNAP web interface will ONLY 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'
    • NOTE: The latest Netgear Ready NAS models (Windows based) require you tick 'Enable WebDAV Support' on this screen as well

  1. 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
  2. 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

Appendix D: Making a NAS drive visible on MAC

If you want to use KinskyJukebox for MAC, your NAS drive will need to be available to Scan

  1. Go->Connect to Server with Server Address:  smb://nas/ShareName (where nas is your nas name/ip address and ShareName is the name of your music share, depending on your configuration)
  2. Click connect (enter username and password as required)
  3. A drive called 'ShareName' will now appear on the desktop (Finder->Preferences->General must have 'Connected servers' ticked for it to be visible)
  4. You can follow instructions  here for insuring the drive remains connected after reboot
  5. Open Applications->Utilities->Terminal
  6. type: cd Desktop/
  7. type: ln -s /Volumes/ShareName ShareNameLink (where ShareName is the name of the connected server drive on your desktop)
  8. A symbolic link (similar to an alias or shortcut) called 'ShareNameLink' should appear on your desktop
  9. Go to Kinsky Jukebox Options->Setup->Scan Directory and select 'ShareNameLink' which should be visible under the main Desktop item
  10. A scan from KinskyJukebox should now work a treat

Appendix E: Handling NAS which requires username and password

If you want to use KinskyJukebox with a NAS that requires a username annd password, the Presets Folder URL will need to contain the username and password:

 scheme://user:password@host/path (example:  http://josh:linn123@192.168.1.25/music)

Attachments