KinskyDesktop Davaar Manual

Table Of Contents

  1. Introduction
  2. Installation
  3. System Requirements
  4. Operation
    1. Navigation
    2. Controlling Rooms
    3. Supported Sources
      1. Playlist
      2. Radio
      3. UpnpAv
      4. External
      5. Songcast
    4. Automatic Room Selection
    5. Volume Control
    6. Playback Control
    7. Kinsky Media Provider Plugins
      1. Enabling or disabling a plugin
      2. Default Media Provider Plugins
        1. BBC
        2. Folder
        3. iTunes
        4. Library
        5. Local Playlists
        6. MovieTrailers
        7. WFMU
    8. Media renderer playlist management
      1. Building a playlist
        1. Direct Play
        2. Media Provider Plugins
      2. Deleting the playlist
      3. Deleting a track
      4. Saving the playlist
    9. Putting a room into standby
  5. Troubleshooting

Introduction

This manual assumes that you have intermediate computer and internet skills.

The  UPnP forum defined an Audio Visual specification,  UPnP AV, which defined the interaction between UPnP control points and UPnP devices. The UPnP AV architecture was designed to be independent of device type, content format and transfer protocol.

The Kinsky software suite is a range of UPnP control point implementations as defined in the UPnP AV specification. The UPnP page gives an overview of how a control point fits into the overall UPnP AV architecture.

A Kinsky control point coordinates the operation between Media Servers, Silver Disk Players and Media Renderers, in response to user interaction.

Installation

Windows XP/Vista/Windows 7

Before you start the installation procedure please ensure you have closed any running instances of KinskyDesktop.

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

Uninstalling

To uninstall KinskyDesktop from your computer, open the control panel, Start->Control Panel, and double-click 'Add or Remove Programs' (Windows XP) or 'Programs and Features' (Windows Vista), select 'KinskyDesktop <version>' and click Uninstall.

Linux

Uninstalling

Mac OS X

Uninstalling

System Requirements

Operating Systems

Windows XP/Vista/Windows 7 with Microsoft .NET Framework v3.5 (Service Pack 1)

Linux with Mono v2.8

Mac OS X Snow Leopard

Minimum System Requirements

System RAM: 512MB

Video Card: 800x600

Wireless: 802.11b

Recommended System Requirements

System RAM: 1GB

Video Card: 1024x768

Wireless: 802.11g

Operation

KinskyDesktop contains four main areas, Now playing, Playlist, Plugin browser, and Control

The Now playing area at the top left of KinskyDesktop provides information about the now playing track, e.g. track title, album, artist, etc.

The Playlist area on the right side of KinskyDesktop provides information about the currently selected source. For example for a Playlist source this area provides the ability to select, add, remove, and re-order tracks.

The Plugin browser area on the left side of KinskyDesktop provides management and access to the installed Kinsky plugins.

The Control area at the top right of KinskyDesktop provides the controls to skip track, resume/pause a track, seek within a track and, (if the room has a preamp), control the volume.

Controlling Rooms

A typical modern home contains multiple HI-FIs, each of which are typically located in different rooms. The room selection box provides a way for a user to move between the different rooms, allowing the user to see what is currently playing in the selected room, as well as allowing the user to control the music playing in the selected room.

The source selection box provides a way for a user to change the current music source in the selected room. The number and types of sources available in each room depends on the HI-FI components installed in the room.

When moving between rooms the music will continue to play.

When a room is selected all preamps and sources in the room are brought out of standby.

Supported Sources

Playlist

The Playlist source allows a user to create a list of tracks that are played through in sequential order. A play indicator shows the currently playing track, which moves sequentially through the playlist as the is played. When adding tracks (or a selection of tracks) to the playlist, you can choose to Play Now (inserts the track(s) at the end of the playlist and starts immediate playback of the added track(s)), Play Next (inserts the track(s) after the currently playing track) or Play Later (inserts the track(s) at the end of the playlist).

The Playlist source allows for gapless playback of tracks.

The Playlist source can hold a maximum of 1000 tracks.

Radio

The Radio source allows a user to listen to internet radio stations, as well as podcasts and 'play again' shows. The Radio source allows a user to preset their favourite stations for quick access. A play indicator show the currently playing preset.

The Radio source can hold a maximum of 100 presets.

UpnpAv

The UpnpAv source allows a user to create a list of tracks that are played through in sequential order. A play indicator shows the currently playing track, which moves sequentially through the playlist as the is played. When adding tracks (or a selection of tracks) to the playlist, you can choose to Play Now (inserts the track(s) at the end of the playlist and starts immediate playback of the added track(s)), Play Next (inserts the track(s) after the currently playing track) or Play Later (inserts the track(s) at the end of the playlist).

The UpnpAv source provides support for standard UPnP Media Renderers. If a Playlist source is available in a room it should be used in preference to the UpnpAv source as it offers the following benefits,

  1. Gapless playback of tracks.
  2. Retains the created playlist between KinskyDesktop sessions.
  3. Allows predicable playback in the presence of multiple control points.

External

The External source allows a user to play external sources such as CD/DVD player, games console or portable music player.

An External sources display an icon indicating the type of external source they represent. The types of external sources are,

  1. Aux
  2. SPDIF
  3. TOS
  4. Analogue

Songcast

The Songcast source allows a user to listen to a remote Songcast source such as another DS on the network.

Automatic Room Selection

KinskyDesktop can be configured to automatically select a room at start up.

The start up room can be configured in the 'Startup Room' page in the user options dialog.

The default behaviour is for the last selected room to be selected.

Volume Control

If volume of the currently selected room can be controlled by KinskyDesktop, then the volume control will be enabled and display the current volume.

The volume control has two active areas, the outer ring and the inner circle (where the current volume is displayed). The volume control glows differently depending on which area is currently active.

To mute or un-mute the volume click in the inner circle. The volume control dims when the volume has been muted.

Playback Control

If the currently selected source is able to be controlled by KinskyDesktop, then the transport controls will become enabled.

The transport control reflects the controls that are appropriate for the currently selected source, e.g. for the Playlist source the transport controls are skip backwards, play/pause, and skip forwards.

Kinsky Media Provider Plugins

KinskyDesktop offers a mechanism for offering its users new ways of finding content for their media players. This additional functionality comes in the form of Media Provider Plugins (MPP). A MPP offers a way for KinskyDesktop to explore media content and for a user to select and playback this content on their media player.

KinskyDesktop comes with a variety of MPPs by default (BBC, Folder, iTunes, Library, Local Playlists, Movie Trailers), however users can install other MPPs that offering content they are interested in.

Plugins are distributed in packages. A plugin package is a zip archive with a kpz file extension.

Enabling or disabling a plugin

A list of installed plugins appears in the Plugins page in the user options dialog. To enable or disable a plugin, tick or untick the tickbox next to its name.

Default Media Provider Plugins

BBC

The BBC plugin provides an easy way for users to browse and listen to BBC content. It provides links to live BBC radio streams as well as to the BBC's Listen Again and Podcast catalogues.

Folder

The Folder plugin provides an easy way for users to browse folders on their computer.

How to add and remove folders

There are two ways to add and remove folders from the Folder plugin.

  1. Through the Folder plugin's options page add and remove buttons
  2. Using drag 'n' drop
    1. Add by dragging the folder into the browser window at the location Home > Folder
    2. Remove by dragging the folder into the waste bin

iTunes

The iTunes plugin provides an easy way for users to browse their iTunes library.

Library

The Library plugin provides a way to browse the UPnP media servers on your home network. A UPnP media server indexes your digital music collection and provides a mechanism for control points to browse your music collection.

Local Playlists

The Local Playlists plugin provides a way to browse, manage and insert DPL playlists into a media renderer's playlist.

To delete playlists or tracks, (within a playlist), drag and drop them onto the waste bin. To insert a playlist into a media renderer's playlist, drag and drop the playlist's icon onto the media renderer's playlist.

Movie Trailers

The Movie Trailers plugin provides an easy way for users to watch movie trailers on a video capable media renderer.

WFMU

The WFMU plugin provides an easy way for users to browse and listen to WFMU content. It provides links to live WFMU streams as well as to WFMU's podcast catalogue.

WFMU-FM is a listener-supported, non-commercial radio station broadcasting at 91.1 Mhz FM in Jersey City, NJ, right across the Hudson from lower Manhattan. It is currently the longest running freeform radio station in the United States.

Media renderer playlist management

Building a playlist

Direct Play

Direct play allows instant access to your media directly from your computer or the web. Just drag 'n' drop the media you want to listen to into your media renderer's playlist and sit back and listen.

Note: Using this feature requires that KinskyDesktop remain open and accessible from your media renderer whilst you are listening to the media.

Media Provider Plugins

To browse a media server, first select the Library plugin from the plugin browser's homepage, then the media server you wish to browse for music.

To insert containers/tracks into a media renderer's playlist, drag and drop onto the media renderer's playlist.

To move back up a level either click the 'Up Level' button or select the desired level on the 'Breadcrumb'.

Deleting the playlist

To clear the current playlist click on the waste bin.

Deleting a track

To delete a track, or a selection of tracks, drag and drop the track(s) onto the waste bin.

Saving the playlist

To save the entire playlist click on the 'Save' button and enter the name you wish to give the playlist. It is also possible to save a selection of tracks from the playlist by dragging the a selection of tracks to the 'Save' button.

Putting a room into standby

To put a room into standby, first select the room and then tap the standby button. When the room selection box shows 'Select a room' the room has been put into standby.

Troubleshooting

I have a Microsoft mouse and when I interact with KinskyDesktop it appears to 'freeze' for long periods

This is an issue with the IntelliPoint drivers supplied with newer Microsoft mice and the .NET framework.

To fix the problem you need to un-assign the 'Instant Viewer' action from whatever mouse button it is assigned to (typically the middle mouse button).

Firewall port settings

The Windows installer automatically adds a rule for KinskyDesktop to the built-in Windows firewall. For other operating systems, (and for other firewalls on Windows), you might need to manually open the following ports,

  • TCP 47832 to 47932 inclusive
  • TCP 49832 to 49932 inclusive
  • UDP 1900

 Microsoft provides support for the Windows XP firewall (included with Windows XP Service Pack 2, enabled by default)
 Norton provides support for Norton Personal Firewall
 McAfee provides support for McAfee Personal Firewall and the McAfee Internet Security Suite
 Zone Labs provides support for ZoneAlarm

If allowing permissions does not seem to affect the connection, please try disabling your firewall completely before launching to test this issue.

When I try to select a network card it only gives the option of "None"

Ensure that you have at least one network adapter card enabled.

If you are running OS X Snow Leopard ensure that you are running at least Mono v2.8.

When I start KinskyDesktop I get a dialog saying "An error has occured whilst trying to detect available network adapters"

There is a know  issue with Mono detecting network cards in the presence of some installed virtual machine software.

In order to get KinskyDesktop to run you will need remove any conflicting virtual machine software.

At present we believe that VirtualBox is the only virtual machine software that causes this problem to occur.