Difference between revisions of "Kazoo Server setup Manual"

From LinnDocs
Jump to: navigation, search
m (Updating)
m
 
(97 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
[[image:KazooServerOverview.png|600px|right]]
 +
__TOC__
 +
<font style="color:red">Due to constantly changing Windows/Max & QNAP security changes, Kazoo Server is no longer maintained. <big><u>There will be no future releases.</u></big></font><br>
 
= Kazoo Server for Mac, Windows and QNAP =
 
= Kazoo Server for Mac, Windows and QNAP =
[[image:KazooServerOverview.png|600px]]
 
 
 
== Introduction ==
 
== Introduction ==
  
Line 9: Line 10:
 
#. Browse an iTunes installation
 
#. Browse an iTunes installation
 
#. Listen to online content
 
#. Listen to online content
#. Save and Share playlists
+
<!--#. Save and Share playlists -->
  
 
Supported formats include MP3, FLAC, MP4, AIFF, Ogg FLAC, & Ogg Vorbis.
 
Supported formats include MP3, FLAC, MP4, AIFF, Ogg FLAC, & Ogg Vorbis.
Line 16: Line 17:
 
:* Untagged files are not listed in the Kazoo Server tree
 
:* Untagged files are not listed in the Kazoo Server tree
  
 +
==Version History==
 +
Check [http://cloud.linn.co.uk/applications/kazooserver/history.html#// HERE] for details of Kazoo Server versions.
  
 
== Installation ==
 
== Installation ==
Line 21: Line 24:
 
=== System Requirements ===
 
=== System Requirements ===
 
==== Mac ====
 
==== Mac ====
:* Mac OS X Lion 10.7 or later
+
:* Mac OS X from OS X 10.11 - El Capitan
 
:* 32 or 64-bit hardware
 
:* 32 or 64-bit hardware
  
 
==== Windows ====
 
==== Windows ====
:* Windows XP/Vista/7/8/10/Home Server 2011
+
:* Windows 8 / 10 / 11
 
:* 32 or 64-bit hardware
 
:* 32 or 64-bit hardware
  
 
==== QNAP ====
 
==== QNAP ====
:* Intel-x86 32bit based CPU 
+
;Beta V4.11.32 for QNAP
:: Due to QNAP End-Of-Life support these QNAP NAS only have firmware up to QTS 4.26.  
+
::[https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.11.32_qnap-x86_64.qpkg QNAP x86 64bit]
:: This version of firmware is no longer supported by Kazoo Server.
 
  
:::'''The latest version of Kazoo Server available for QTS 4.26 and earlier is [http://oss.linn.co.uk/Releases/KazooServer/Davaar/KazooServer_4.8.5_qnap-x86.qpkg V4.8.5 QNAP x86 (32bit)]'''
+
::[https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.11.32_qnap-arm_64.qpkg QNAP ARM 64bit]
  
::For example
+
 
::: TS-239 Pro, TS-239 Pro II, TS-239 Pro II+, TS-259 Pro, TS-259 Pro+, TS-439 Pro II,   
+
:* <u>Intel-x86 64bit based CPU</u>
::: TS-459 Pro, TS-459U-RP+/SP+, TS-439 Pro II+, TS-459 Pro II, TS-459 Pro+, TS-459U-RP/SP, SS-439-Pro
+
:: Kazoo Server V4.10.1 onwards will ONLY work with QNAP firmware QTS 4.4.1 onwards
 +
<!--  up to QTS 4.3 <big><font style="color:red"><u>DOES NOT WORK WITH QTS 4.4.1 onwards</u> </font></big>
 +
:::(For QTS 4.4.1 try <font style="color:red">Kazoo Server Beta 4.10.7</font> QNAP x86 downloadable from [https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.10.7_qnap-x86_64.qpkg ><u>HERE</u><] )-->
 +
 
 +
::* <u>Intel-x86 64bit based CPU</u> (with  <b>QTS 4.4.1 <u>onwards</u></b>)
 +
:::Recommend <b><u>at least</u> 4GB of RAM</b> installed on these QNAP NAS
 
          
 
          
 +
:::For example
 +
::::TS-x51 Series, TS-x51+ Series, TS-x51A Series, TS-x53B Series, TS-x53A Series, TS-x53U Series
 +
::::TS-251, TS-253A, TS-259 Pro, TS-269L, Pro II, TS-451,  TS-459 Pro II, TS-469L, TS-651, TS-851
 +
:::QNAP Models may change and this information was correct at the time of writing
  
 +
::* Intel-x86 64bit based CPU (with  <b><u>upto</u> QTS 4.3.5</b>)
 +
:::* Some QNAPs using Intel X86 based CPU have come to End-Of-Life support. These intel-x86 QNAP NAS listed below, only have firmware up to QTS 4.26.
 +
::: QTS firmware V4.26 is no longer supported by Kazoo Server.
 +
::::'''The latest version of Kazoo Server available for QTS 4.26 and earlier is <u>[https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.8.5_qnap-x86.qpkg V4.8.5 QNAP x86 (32bit)]</u>'''
  
:* Intel-x86 64bit based CPU
+
:::For example
       
+
:::: TS-239 Pro, TS-239 Pro II, TS-239 Pro II+, TS-259 Pro, TS-259 Pro+, TS-439 Pro II,   
 +
:::: TS-459 Pro, TS-459U-RP+/SP+, TS-439 Pro II+, TS-459 Pro II, TS-459 Pro+, TS-459U-RP/SP, SS-439-Pro
 +
:::QNAP Models may change and this information was correct at the time of writing   
 +
   
 +
 
 +
:* <u>ARM 64bit</u> based CPU support
 
::For example
 
::For example
:::TS-x51 Series, TS-x51+ Series, TS-x51A Series, TS-x53B Series, TS-x53A Series, TS-x53U Series
+
:::TS-269L, TS-230
:::TS-251, TS-253A, TS-259 Pro, TS-269L, Pro II, TS-451,  TS-459 Pro II, TS-469L, TS-651, TS-851
 
   
 
  
:* Intel ARM x19 based CPU support
+
:* <u>ARM x19</u> based CPU support <b>(only supported up to <u>[https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.9.3_qnap-arm-x19.qpkg Kazoo Server V4.9.3 Sept 2019]</u>) later QTS versions may not work with this</b>
 +
::For example
 
:::TS-119P II,TS-119P +,TS-119, TS-219P, TS-219, TS-219P II, TS-219P+, TS-221, TS-419U II, TS-419P, TS-419U II, TS-439U-RP/SP
 
:::TS-119P II,TS-119P +,TS-119, TS-219P, TS-219, TS-219P II, TS-219P+, TS-221, TS-419U II, TS-419P, TS-419U II, TS-439U-RP/SP
 
:::TS-419P II, TS-419P+, TS-419U+, TS-419U,SS-439-Pro
 
:::TS-419P II, TS-419P+, TS-419U+, TS-419U,SS-439-Pro
 +
::QNAP Models may change and this information was correct at the time of writing
  
:* Intel ARM x31/x41 based CPU support
+
:* <u>ARM x31/x41</u> based CPU support <b>(only supported up to <u>[https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.9.3_qnap-arm-x31.qpkg Kazoo Server V4.9.3 Sept 2019)]</u> later QTS versions may not work with this</b>
 
::For example
 
::For example
 
:::TS-131,  TS-231 ,TS-231+, TS-431, TS-431+
 
:::TS-131,  TS-231 ,TS-231+, TS-431, TS-431+
:::Note TS-231'''P2''' uses a different CPU that is not supported at this time  
+
:::Note TS-231'''P2''', TS-431P TS-131K... uses an Alpine CPU that is not supported at this time.
 +
::QNAP Models may change and this information was correct at the time of writing 
  
:* Intel ARM x41 based CPU support
+
:* <u>ARM x41</u> based CPU support <b>(only supported up to <u>[https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.9.3_qnap-arm-x41.qpkg Kazoo Server V4.9.3 Sept 2019)]</u> later QTS versions may not work with this</b>
 
::For example
 
::For example
 
:::TS-128, TS-131P, TS-231P
 
:::TS-128, TS-131P, TS-231P
:::Note TS-128'''A'''/228'''A''' uses a different CPU that is not supported at this time  
+
:::Note TS-128'''A'''/228'''A''' uses a different CPU that is not supported at this time
 
+
::QNAP Models may change and this information was correct at the time of writing
  
 
=== Installing ===
 
=== Installing ===
 
==== Mac ====
 
==== Mac ====
:# Download the .dmg file from the [DownloadKazooServer download] page
+
:1. Download the .dmg file from this <u><b>[https://linn-ui-buildartifacts-prod.s3.eu-west-1.amazonaws.com/applications/kazooserver/releases/Davaar/KazooServer_4.11.32_osx.dmg DOWNLOAD LINK]</b></u>
:# Double click the downloaded .dmg file
+
:2. Double click the downloaded .dmg file
:# Double click the !InstallerKazooServer.pkg file contained within the window which pops up with the dmg contents
+
:3. Double click the !InstallerKazooServer.pkg file contained within the window which pops up with the dmg contents
:# Follow the on screen instructions in the installer program
+
:: In OSX CATALINA you will need to give authorisation to install. To do this go into '''System Preferences''' > <b>Security & Privacy"</b> and allow thi sApp to install.
 +
:4.Follow the on screen instructions in the installer program
  
 
==== Windows ====
 
==== Windows ====
:# Download the installer from the [DownloadKazooServer download] page
+
:# Download the installer using this <b><u>[https://linn-ui-buildartifacts-prod.s3.eu-west-1.amazonaws.com/applications/kazooserver/releases/Davaar/KazooServer_4.11.32_win.exe DOWNLOAD LINK] </u></b>.
 
:# Double click the downloaded .exe file
 
:# Double click the downloaded .exe file
 
:# Follow the on screen instructions in the installer program
 
:# Follow the on screen instructions in the installer program
  
 
==== QNAP ====
 
==== QNAP ====
:# Download the Kazoo Server .qpkg file from the [DownloadKazooServer download] page<br /> Check the QTS firmware version on the QNAP, if this is 4.26 or earlier on a x86 processor NAS <br />you will need to download the [http://oss.linn.co.uk/Releases/KazooServer/Davaar/KazooServer_4.8.5_qnap-x86.qpkg QNAP x86 (32bit)] version<br />  
+
<u>Instructions to install</u>
:# Login to the QNAP web interface
+
:1. Download the Kazoo Server .qpkg file <!-- from the [https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/kazooserver_latest_qnap-x86_64.qpkg download] page<br /> Check the QTS firmware version on the QNAP, if this is 4.26 or earlier on a x86 processor NAS <br />you will need to download the https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.8.5_qnap-arm-x31.qpkg-->
:# Click the "Control Panel" icon
+
::* Intel X86 64bit (QNAP OSX 4..4 onwards) or ARM 64 check [https://www.linn.co.uk/software Linn.co.uk/<u>Downloads</u>]
:# Select "Privilege Settings" --> "Users" and click the "Home Folder" button
+
::* Intel X86 <b>32bit</b>  based CPU support [https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.8.5_qnap-x86.qpkg Kazoo Server x86 (32bit) <u>Download</u>]
:# Select the "Enable home folder for all users" tick box and choose a disk volume in the drop down men  
+
::* ARM x19 based CPU support [https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.8.5_qnap-arm-x19.qpkg Kazoo Server V4.8.5 ARM x19 <u>Download</u>]
:# Click the "App Center" icon
+
::* ARM x31/x41 based CPU support [https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.8.5_qnap-arm-x31.qpkg Kazoo Server V4.8.5 ARM x31/X41 <u>Download</u>]
:# Click the "All Apps" tab
+
::*ARM x41 based CPU support [https://cloud.linn.co.uk/applications/kazooserver/releases/Davaar/KazooServer_4.8.5_qnap-arm-x41.qpkg Kazoo Server V4.8.5 ARM x41 <u>Download</u>]
:# For x86 QNAP running QTS 4.2.6 and earlier (such as TS 239), Click and Install the QMONO package from [https://www.forum-nas.fr/viewtopic.php?t=1523 HERE (5.4.1.6 version)] or [https://www.qnapclub.eu/en/qpkg/193 HERE, select Older versions and look from 5.4.1.6.0 for '''TS-NASX86''']
+
:2. Login to the QNAP web interface
:# Select Settings and click the "Install Manually" button
+
:3. Click the "Control Panel" icon
:# "Browse.." to the location you have downloaded KazooServer .qpkg file
+
:4. Select "Privilege Settings" --> "Users" and click the "Home Folder" button
:# Click on "Install"
+
:5. Select the "Enable home folder for all users" tick box and choose a disk volume in the drop down men  
:# After the installation completes click the "ON/OFF" button on the KazooServer icon to enable the application.
+
:6. Click the "App Center" icon
:# Then Reboot the QNAP
+
:7. Click the "All Apps" tab
 +
:8. For x86 QNAP running QTS 4.2.6 and earlier (such as TS 239), Click and Install the QMONO package from [https://www.forum-nas.fr/viewtopic.php?t=1523 HERE (5.4.1.6 version)] or [https://www.qnapclub.eu/en/qpkg/193 HERE, select Older versions and look from 5.4.1.6.0 for '''TS-NASX86''']
 +
:9. Select Settings and click the "Install Manually" button
 +
:10. "Browse.." to the location you have downloaded KazooServer .qpkg file
 +
:11. Click on "Install"
 +
:12. After the installation completes click the "ON/OFF" button on the KazooServer icon to enable the application.
 +
:12 Then Reboot the QNAP
  
 
=== Uninstalling ===
 
=== Uninstalling ===
 
==== Mac ====
 
==== Mac ====
:# Download the .dmg file from the [DownloadKazooServer download] page
+
:# Download the .dmg file from the [https://www.linn.co.uk/software#kazoo-server download] page
 
:# Double click the downloaded .dmg file
 
:# Double click the downloaded .dmg file
 
:# Double click the uninstall.tool file and provide your password to the script if prompted
 
:# Double click the uninstall.tool file and provide your password to the script if prompted
Line 134: Line 162:
 
== Configuring Kazoo Server ==
 
== Configuring Kazoo Server ==
  
After installation of Kazoo Server, one of the following icons will appear in the system tray [[Image(wiki:MediaServerImages:SysTrayIcon.2.png,title=Systray icon,link="", 25px)]] [[Image(wiki:MediaServerImages:SysTrayIconScanning.png,title=Systray icon,link="", 25px)]] [[Image(wiki:MediaServerImages:SysTrayIconDisabled.png,title=Systray icon,link="", 25px)]].
+
After installation of Kazoo Server, one of the following icons will appear in the system tray [[Image:Icons.png‎|25px)]]
  
 
The colour of this icon is an indicator of the current state that Kazoo Server is in.  A green icon indicates that Kazoo Server is started and not currently refreshing any of its content.  An amber icon indicates that Kazoo Server is started but one or more of its components is currently refreshing.  Lastly, a red icon implies that either Kazoo Server itself is stopped or else none of its components are presently enabled.  Clicking this system tray icon will bring up a context menu which has two items in it.  !Start/Stop Kazoo Server toggles the server between started and stopped states.  If the server is started, then clicking Configure Kazoo Server will open a configuration window with the main settings page.
 
The colour of this icon is an indicator of the current state that Kazoo Server is in.  A green icon indicates that Kazoo Server is started and not currently refreshing any of its content.  An amber icon indicates that Kazoo Server is started but one or more of its components is currently refreshing.  Lastly, a red icon implies that either Kazoo Server itself is stopped or else none of its components are presently enabled.  Clicking this system tray icon will bring up a context menu which has two items in it.  !Start/Stop Kazoo Server toggles the server between started and stopped states.  If the server is started, then clicking Configure Kazoo Server will open a configuration window with the main settings page.
  
If running on '''Windows Home Server''' or '''QNAP''', the system tray icon is not available.  You should ensure that you have also downloaded '''[DownloadKonfig Konfig]'''.  When you run Konfig, Kazoo Server will appear in the device list under the configuration tab.  Clicking on the Kazoo Server device in Konfig will bring up the main settings page.  
+
If running on '''Windows Home Server''' or '''QNAP''', the system tray icon is not available.  You should ensure that you have also downloaded '''[http://oss.linn.co.uk/trac/wiki/DownloadKonfig Konfig]'''.  When you run Konfig, Kazoo Server will appear in the device list under the configuration tab.  Clicking on the Kazoo Server 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.
 
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 Library], [#iTunes iTunes], and [#MediaApps Media Apps] can be individually enabled or disabled via the On / Off switch next to the section header.
+
Each of the 3 main sections [[Kazoo_Server_setup_Manual#Library|Library]], [[Kazoo_Server_setup_Manual#iTunes | iTunes]], and [[Kazoo_Server_setup_Manual#MediaApps|Media Apps]] can be individually enabled or disabled via the On / Off switch next to the section header.
  
In addition, a [[Image(wiki:MediaServerImages:KazooServerSettingsButton.gif,title=Preferences button,link="", 25px)]] configuration button takes you to a configuration page for each section.
+
In addition, a [[Image:KazooServerSetupButton.png|25px]] configuration button takes you to a configuration page for each section.
  
 
== Help ==
 
== Help ==
  
The [[Image(wiki:MediaServerImages:KazooServerHelpButton.gif,title=Help button,link="", 25px)]] help button opens this manual in your default web browser.
+
The [[Image:KazooServerSetupButton.png|25px]] help button opens this manual in your default web browser.
  
 
== Preferences ==
 
== Preferences ==
  
[[Image(wiki:MediaServerImages:KazooServerSettingsScreen.png,title=Preferences,link="",align=center, 600px)]]
+
[[Image:KazooServerSettingsScreen.png|600px]]
  
The [[Image(wiki:MediaServerImages:KazooServerSettingsButton.gif,title=Preferences button,link="", 25px)]] preferences button opens the preferences page.
+
The [[Image:KazooServerSetupButton.png|25px]] preferences button opens the preferences page.
  
 
Here, you can choose which network to run Kazoo Server 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 Kazoo Server when updates become available.
 
Here, you can choose which network to run Kazoo Server 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 Kazoo Server when updates become available.
Line 164: Line 192:
 
== Library ==
 
== Library ==
  
[[Image(wiki:MediaServerImages:KazooServerLibrary.png,title=Library,link="",align=center, 600px)]]
+
[[Image:KazooServerLibrary.png‎|600px]]
 +
 
 +
The Library uses the default "tags" and <b><u>cannot</u></b> be changed. This is to try and keep Kazoo Server setup simple without undue complication:
 +
: The dedicated Tags in Linn Kazoo & Linn App are
 +
::Title
 +
::Artist
 +
::Album
 +
::Composer (for the composer/classical tab) Genre (for genres)
 +
 
  
 
The Library settings page allows you to add or remove folders containing music to be indexed by Kazoo Server and made available to Kazoo for playing on your DS.
 
The Library settings page allows you to add or remove folders containing music to be indexed by Kazoo Server and made available to Kazoo for playing on your DS.
  
Clicking the 'ADD' button brings up a dialog which allows you to select a folder to add.  Once Kazoo Server 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.
+
* Clicking the 'ADD' button brings up a dialog which allows you to select a folder to add.  Once Kazoo Server 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 Kazoo Server is running under will appear in the drive letters dropdown within this Dialog (on Mac, these will appear as /Volumes/XXX, On the QNAP this will appear as /SHARE/CACHEDEV1_DATA...).
  
Any network drives mapped by the user account Kazoo Server is running under will appear in the drive letters dropdown within this Dialog (on Mac, these will appear as /Volumes/XXX, On the QNAP this will appear as /SHARE/CACHEDEV1_DATA...).
+
* 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 Kazoo Server when its contents change.
  
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 Kazoo Server when its contents change.
+
* To get a Report of the scan press the [[File:KazzoServer-ScanReport.png]] button. This will show you what has been ignored and what has been added to the Kazoo server.
  
Within the Library settings page, you can also edit the default label used for various artists in compilation albums.
+
* 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.
+
* Clicking the 'BACK' button will take you back to the main settings page.
  
 
Note: The Kazoo Server does not support WAV files
 
Note: The Kazoo Server does not support WAV files
Line 185: Line 223:
  
 
== iTunes ==
 
== iTunes ==
 +
{{Info:KazooServer-iTunes}}
  
[[Image(wiki:MediaServerImages:KazooServerITunes.png,title=iTunes,link="",align=center, 600px)]]
+
== Media Apps ==
 
 
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. If there us no "iTunes Music Library.xml" go into the iTunes Preferences > Advanced and enable the "Share the iTunes Library XML with other applications"
 
 
 
 
 
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 == #MediaApps
 
  
[[Image(wiki:MediaServerImages:KazooServerMediaApps.png,title=Media Apps,link="",align=center, 600px)]]
+
[[Image:KazooServerMediaApps.png| 600px]]
  
 
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.   
 
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 [[Image(wiki:MediaServerImages:KazooServerRefreshButton.png,title=Refresh button,link="", 25px)]].
+
These will refresh periodically but can also be manually refreshed by pressing the refresh button [[Image:KazooServerRefreshButton.png| 25px]].
  
 
Individual apps can be enabled and disabled via the On / Off switch next to that app.
 
Individual apps can be enabled and disabled via the On / Off switch next to that app.
Line 224: Line 249:
 
Streaming service logins and current login status can be configured in the gateway settings UI.
 
Streaming service logins and current login status can be configured in the gateway settings UI.
  
[[Image(wiki:KazooServerManual:service configuration.png,title=Gateway settings,link="",align=center, 600px)]]
+
[[Image:GATEWAYserviceConfiguration.png|900px]]
  
 +
== FAQ ==
 +
====How do I rescan the Music?====
 +
:If you go into the <font style="color:blue"><b>Configure Kazoo Server > Library</b></font> you will find a [[Image:KazooServerRefreshButton.png| 25px]] button.<br>
 +
:Pressing this refresh button [[Image:KazooServerRefreshButton.png| 25px]] to manually refresh your library contents.
  
== Troubleshooting ==
 
  
=== After QNAP firmware upgrade Kazoo Server no longer works ===
 
In 2017 QNAP have changed their x86 operating systems from 32bit to 64bit (QTS 4.3 onwards). <br>
 
Update Kazoo Server to the 64bit version to get it working again. [http://oss.linn.co.uk/trac/wiki/DownloadKazooServer ..Qnap_x86_64.qpkg]
 
  
 +
====How do I get Multi-Disc albums to show as one album?====
 +
<b>Criteria</b>
 +
 +
*<u>The important point is double check that the Meta data within each track has the <q><b><i>disc</i></b></q> number.<br></U>
 +
* All tracks of this multi-disc album should be in to the <u>same folder</u> of your NAS/PC/MAC. <br>
 +
Check the above has been done and finally, go into Kazoo > Library and do a rescan (as above)<br>.
 +
After this is complete your multi-disc album will now show as one album
  
If you already had QTS 4.3, or later and the QNAP update was firmware 5.4.1.6 (13th Feb 2018), Kazoo Server does not work. This because QNAP have removed MONO from their libraries. The solution is to upgrade to Kazoo Server 4.9.1 or higher. This can downloaded from [http://oss.linn.co.uk/trac/wiki/DownloadKazooServer http://OSS.Linn.co.uk]
+
== Troubleshooting ==
 
+
Check <u> [[FAQ-General_Issues#Kazoo_Server_issues|Kazoo Server issues]]</u>
 
+
<!--{{Issues:Kazoo Server}}--->
=== Arists incorrect on compilation Album ===
 
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 Kazoo Server listings.
 
 
 
=== No iTunes coverart ===
 
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 [http://docs.linn.co.uk/wiki/index.php/Media_Applications Linn Docs] for instructions to add this.
 
 
 
=== No Album coverart and when I select the music it does not play ===
 
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 the correct Network is defined. (If you change the PC/MAC/QNAP to a different LAN/Network you need to tell it to connect to the new network settings.)
 
 
 
=== Kazoo Server on my MAC keeps disappearing ===
 
* Check the within the MAC OSX System preferences - Energy Saver - Computer sleep is set to Never.
 
 
 
=== I can no longer find my iTunes library ===
 
* If you have just installed iTunes11 and Kazoo Server 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.
 
 
 
=== I cannot play any of my iTunes Music ===
 
* Kazoo Server cannot share iTunes Music that resides in the iCloud (iTunes Match). iCloud Music can only be accessed by Apple devices.
 
 
 
=== Kazoo Server with Kazoo UI ===
 
At present the (16th July 2014) ONLY the Kazoo Server LIBRARY can be seen on the Kazoo UI. The iTunes and Media apps functions are not available at this time with the Kazoo UI.
 
 
 
If the Kazoo Server cannot be seen in Kazoo UI then use Konfig and check that
 
1. the correct network has been selected on Kazoo Server &
 
1. The LIBRARY function is enabled. (If this disabled then there are no functions for the Kazoo UI to use so it is not listed)
 
 
 
All Kazoo Server functions can be used with the Kinsky UI.
 
=== After QNAP firmware update Kazoo Server does not work ===
 
In 2017 QNAP have changed their x86 operating systems from 32bit to 64bit (QTS 4.3 onwards). <br>
 
Update Kazoo Server to the 64bit version to get it working again. [http://oss.linn.co.uk/trac/wiki/DownloadKazooServer ..Qnap_x86_64.qpkg]
 
 
 
=== Kazoo Server fails to start on Windows when running Bizmodeller iHomeserver application ===
 
 
 
* There is a known issue with Kazoo Server 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 Kazoo Server service manually after restarting Windows.
 
 
 
=== Kazoo Server fails to start on a MAC ===
 
If this is a first installation of the Kazoo Server you will have to Reboot the MAC and after Reboot run KONFIG to set it up.
 
If Kazoo Server does not show up in Konfig then go into '''FINDER''' - '''User''' >  '''Shared''' > '''Kazoo Server''' and email a copy of Userlog.txt and KazooServer.crash (if it exists) to the Linn Helpline.
 
 
 
 
 
=== 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 Kazoo Server is started on the first user logon.
 
 
 
If you do not log-out of this user and only SWITCH to another user this can cause issue in file/folder permissions.
 
 
 
If you are going to edit the Kazoo Server 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.
 
 
 
=== Music library keep disappearing from the Music listing ===
 
If the Music is USB drive connected to the PC/MAC this drive may be going into sleep mode, Kazoo Server can no longer see or get access to this music because the drive has gone into sleep. This can normally be fixed in Windows and by going into the power saving options. However some USB drives will still go to sleep of their own accord. There are some apps to drive and keep the hard-drives alive, for example:
 
 
 
For the PC have a look at [[http://keepalivehd.codeplex.com/ Keep Alive]]
 
 
 
For MAC have a look at [[http://www.macupdate.com/app/mac/31158/keep-drive-spinning Keep Drive spinning]]
 
 
 
=== QNAP Kazoo Server settings do not survive a reboot or QNAP gives error messages relating to running out of ramdisk space ===
 
 
 
Both of these seemingly unrelated issues are caused by QNAP attempting to store your home folder in ram instead of on a physical hard drive.
 
To fix, go into QNAP, navigate to the Privilege Settings | User section. Press the Home Folder button and enable this and ensure that the drop down selects a volume (not device).
 
 
 
 
 
=== QNAP fails to install Kazoo Server ===
 
Some NAS drives require you can to install Kazoo (it does need Optware IPKG installed first, otherwise it will fail.
 
 
 
Check the processor in the NAS is supported by the Kazoo server version. (Marvell CPUs are not supported, ARM x19 processors are presently in Beta release)
 
 
 
 
 
=== Kazoo Server does not automatically add new Music files ===
 
On a PC/MAC, check in the Kazoo Server settings that "Enable watching local file system changes" is turned ON. This will continuously check selected folders for any changes and additions, then add them to the Kazoo Server.
 
On a QNAP you can turn on the "Enable watching local file system changes", but due to the QNAP operating system this will scan all of the time. We advise that this is turned off and you go into the Library option and press the Rescan button.
 
 
 
 
 
=== Kazoo Server can be seen but will not Play any Music ===
 
If the Kazoo Server device has changed to a different network. You will have to change/check the Network configuration in Preferences. (This is only set and an IP range and will not clear and set for a new IP address range)
 
 
 
 
 
=== WAV file support ===
 
The Kazoo Server does not support WAV files (like many UPnP Media server). This is because the metadata locations are inconsistent in different variants of WAV files and this can cause issue reading the correct metadata.
 
 
 
=== To clear all setting to Default ===
 
 
 
==== QNAP ====
 
On the QNAP use, stop the Kazoo Server, the use the QNAP '''File Station''' to delete the Options.XML file.
 
 
 
Note: you may have to go into the File Station - Settings and enable: "Show hidden folders on NAS" to see the .config folder
 
 
 
[[Image(http://docs.linn.co.uk/wiki/images/d/db/QNAP_Kazoo_Server.png, 750px)]]
 
 
 
 
 
==== MAC OS X High Sierra ====
 
* Stop the Kazoo Server, (click on the Kazoo Server icon and STOP KAZOO SERVER)
 
 
 
* Go into '''FINDER''' > '''Go to Folder''' and type '''/Users/Shared'''
 
 
 
* In this folder  delete '''KazooServer''' folder within this folder
 
 
 
* Now reboot you Mac.
 
 
 
* After reboot you will have to re-enter all of you locations etc.
 

Latest revision as of 08:53, 18 November 2024

KazooServerOverview.png

Due to constantly changing Windows/Max & QNAP security changes, Kazoo Server is no longer maintained. There will be no future releases.

Kazoo Server for Mac, Windows and QNAP

Introduction

Kazoo Server provides the ability to browse and playback music on a Linn DS or UPnP media renderer. Kazoo Server allows a UPnP control point, such as Kazoo, 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

Supported formats include MP3, FLAC, MP4, AIFF, Ogg FLAC, & Ogg Vorbis. Note:

  • The Kazoo Server does not support WAV files due to poor tagging.
  • Untagged files are not listed in the Kazoo Server tree

Version History

Check HERE for details of Kazoo Server versions.

Installation

System Requirements

Mac

  • Mac OS X from OS X 10.11 - El Capitan
  • 32 or 64-bit hardware

Windows

  • Windows 8 / 10 / 11
  • 32 or 64-bit hardware

QNAP

Beta V4.11.32 for QNAP
QNAP x86 64bit
QNAP ARM 64bit


  • Intel-x86 64bit based CPU
Kazoo Server V4.10.1 onwards will ONLY work with QNAP firmware QTS 4.4.1 onwards
  • Intel-x86 64bit based CPU (with QTS 4.4.1 onwards)
Recommend at least 4GB of RAM installed on these QNAP NAS
For example
TS-x51 Series, TS-x51+ Series, TS-x51A Series, TS-x53B Series, TS-x53A Series, TS-x53U Series
TS-251, TS-253A, TS-259 Pro, TS-269L, Pro II, TS-451, TS-459 Pro II, TS-469L, TS-651, TS-851
QNAP Models may change and this information was correct at the time of writing
  • Intel-x86 64bit based CPU (with upto QTS 4.3.5)
  • Some QNAPs using Intel X86 based CPU have come to End-Of-Life support. These intel-x86 QNAP NAS listed below, only have firmware up to QTS 4.26.
QTS firmware V4.26 is no longer supported by Kazoo Server.
The latest version of Kazoo Server available for QTS 4.26 and earlier is V4.8.5 QNAP x86 (32bit)
For example
TS-239 Pro, TS-239 Pro II, TS-239 Pro II+, TS-259 Pro, TS-259 Pro+, TS-439 Pro II,
TS-459 Pro, TS-459U-RP+/SP+, TS-439 Pro II+, TS-459 Pro II, TS-459 Pro+, TS-459U-RP/SP, SS-439-Pro
QNAP Models may change and this information was correct at the time of writing


  • ARM 64bit based CPU support
For example
TS-269L, TS-230
For example
TS-119P II,TS-119P +,TS-119, TS-219P, TS-219, TS-219P II, TS-219P+, TS-221, TS-419U II, TS-419P, TS-419U II, TS-439U-RP/SP
TS-419P II, TS-419P+, TS-419U+, TS-419U,SS-439-Pro
QNAP Models may change and this information was correct at the time of writing
For example
TS-131, TS-231 ,TS-231+, TS-431, TS-431+
Note TS-231P2, TS-431P TS-131K... uses an Alpine CPU that is not supported at this time.
QNAP Models may change and this information was correct at the time of writing
For example
TS-128, TS-131P, TS-231P
Note TS-128A/228A uses a different CPU that is not supported at this time
QNAP Models may change and this information was correct at the time of writing

Installing

Mac

1. Download the .dmg file from this DOWNLOAD LINK
2. Double click the downloaded .dmg file
3. Double click the !InstallerKazooServer.pkg file contained within the window which pops up with the dmg contents
In OSX CATALINA you will need to give authorisation to install. To do this go into System Preferences > Security & Privacy" and allow thi sApp to install.
4.Follow the on screen instructions in the installer program

Windows

  1. Download the installer using this DOWNLOAD LINK .
  2. Double click the downloaded .exe file
  3. Follow the on screen instructions in the installer program

QNAP

Instructions to install

1. Download the Kazoo Server .qpkg file
2. Login to the QNAP web interface
3. Click the "Control Panel" icon
4. Select "Privilege Settings" --> "Users" and click the "Home Folder" button
5. Select the "Enable home folder for all users" tick box and choose a disk volume in the drop down men
6. Click the "App Center" icon
7. Click the "All Apps" tab
8. For x86 QNAP running QTS 4.2.6 and earlier (such as TS 239), Click and Install the QMONO package from HERE (5.4.1.6 version) or HERE, select Older versions and look from 5.4.1.6.0 for TS-NASX86
9. Select Settings and click the "Install Manually" button
10. "Browse.." to the location you have downloaded KazooServer .qpkg file
11. Click on "Install"
12. After the installation completes click the "ON/OFF" button on the KazooServer icon to enable the application.
12 Then Reboot the QNAP

Uninstalling

Mac

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

Windows

  1. Open the Windows Control Panel and double click "Programs and Features"
  2. Select "KazooServer" in the list of programs and click the "Uninstall" button
  3. Follow the on screen instructions in the uninstall window

QNAP

  1. Login to the QNAP web interface
  2. Click the "App Center" icon
  3. Hover over the KazooServer icon and click on "More..."
  4. Click the "Remove" button

Updating

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

KazooServerUpdateComplete.png

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 Kazoo Server 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, Kazoo Server 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.

KazooServerUpdateDialog.png

Running Kazoo Server

After installation, Kazoo Server 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 Kazoo Server is logged out, Kazoo Server will attempt to find another logged in user and run using the account of that user.

If you wish Kazoo Server 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, Kazoo Server will run as the local system and does not require a user to be logged in.

Configuring Kazoo Server

After installation of Kazoo Server, one of the following icons will appear in the system tray 25px)

The colour of this icon is an indicator of the current state that Kazoo Server is in. A green icon indicates that Kazoo Server is started and not currently refreshing any of its content. An amber icon indicates that Kazoo Server is started but one or more of its components is currently refreshing. Lastly, a red icon implies that either Kazoo Server itself is stopped or else none of its components are presently enabled. Clicking this system tray icon will bring up a context menu which has two items in it.  !Start/Stop Kazoo Server toggles the server between started and stopped states. If the server is started, then clicking Configure Kazoo Server will open a configuration window with the main settings page.

If running on Windows Home Server or QNAP, the system tray icon is not available. You should ensure that you have also downloaded Konfig. When you run Konfig, Kazoo Server will appear in the device list under the configuration tab. Clicking on the Kazoo Server 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 KazooServerSetupButton.png configuration button takes you to a configuration page for each section.

Help

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

Preferences

KazooServerSettingsScreen.png

The KazooServerSetupButton.png preferences button opens the preferences page.

Here, you can choose which network to run Kazoo Server 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 Kazoo Server when updates become available.

Note: This IP address range is static and will have to be reset if used on a different LAN

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

Library

KazooServerLibrary.png

The Library uses the default "tags" and cannot be changed. This is to try and keep Kazoo Server setup simple without undue complication:

The dedicated Tags in Linn Kazoo & Linn App are
Title
Artist
Album
Composer (for the composer/classical tab) Genre (for genres)


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

  • Clicking the 'ADD' button brings up a dialog which allows you to select a folder to add. Once Kazoo Server 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 Kazoo Server is running under will appear in the drive letters dropdown within this Dialog (on Mac, these will appear as /Volumes/XXX, On the QNAP this will appear as /SHARE/CACHEDEV1_DATA...).
  • 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 Kazoo Server when its contents change.
  • To get a Report of the scan press the KazzoServer-ScanReport.png button. This will show you what has been ignored and what has been added to the Kazoo server.
  • 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.

Note: The Kazoo Server does not support WAV files

Removable Devices

This will allow to to select which removable devices (such as USB drives) are visible in the Kazoo Server.

iTunes

KazooServerITunes.png

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.
If there us no "iTunes Music Library.xml" go into the iTunes Preferences > Advanced and enable the "Share the iTunes Library XML with other applications"'

Note
  • In Apple Music this "iTunes Music Library.xml" does not exist, you have to create this manually.
To do this:
1. Go into Apple Music File > LIbrary,
2. Select EXPORT LIBRARY and
Windows: Create a file called "iTunes Music Library.xml" in the . Libraries > Music > iTunes folder
OSX: Create a file called "iTunes Music Library.xml" in the . Libraries > Music > iTunes folder


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

KazooServerMediaApps.png

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 KazooServerRefreshButton.png.

Individual apps can be enabled and disabled via the On / Off switch next to that app.

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

Kazoo Server in Kazoo

Kazoo Server appears as a media server in the Music page of Kazoo.

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


Gateway API

This is an interface to allow control apps, such as the Linn Control 4 module and Linn Crestron module, can control the Linn DS/DSM's and UPnP Media Servers in this network. Streaming service logins and current login status can be configured in the gateway settings UI.

GATEWAYserviceConfiguration.png

FAQ

How do I rescan the Music?

If you go into the Configure Kazoo Server > Library you will find a KazooServerRefreshButton.png button.
Pressing this refresh button KazooServerRefreshButton.png to manually refresh your library contents.


How do I get Multi-Disc albums to show as one album?

Criteria

*The important point is double check that the Meta data within each track has the disc number.
* All tracks of this multi-disc album should be in to the same folder of your NAS/PC/MAC.
Check the above has been done and finally, go into Kazoo > Library and do a rescan (as above)
.

After this is complete your multi-disc album will now show as one album

Troubleshooting

Check Kazoo Server issues