No announcement yet.

iTunes DAAP plugin - User Guide

This topic is closed.
This is a sticky topic.
  • Filter
  • Time
  • Show
Clear All
new posts

    iTunes DAAP plugin - User Guide


    System Requirements:

    This plugin is for HS3 or HS3PRO. It works with both Windows and Linux versions.


    For Windows:
    This plugin needs the Apple Bonjour service to run on your HomeSeer machine. If you have installed iTunes (or most of other Apple software), it should already be installed.
    If it isn't, you can download it from the following links:
    64bits version:
    32bits version:

    For Linux:
    The equivalent to Bonjour for Linux is avahi, so the avahi-daemon package needs to be installed and running on your system. To do so, ssh into your Linux controller then enter the following commands:
    sudo apt-get update
    sudo apt-get install avahi-daemon

    Plugin Installation:
    Download and install from the updater, or download package from the Beta Testing thread and follow instructions to install.

    Plugin Configuration:
    Go to the iTunes DAAP config page and start the pairing process by clicking the "Pair with iTunes" button.
    • Open the iTunes instance you want to control
    • Click on the small button that should have appeared next to the media type selector (see screenshot below).

    Click image for larger version

Name:	pairing_button.png
Views:	1
Size:	39.2 KB
ID:	1209900
    • Enter any 4 digits code (1234 for example)

    Click image for larger version

Name:	pairing_entercode.png
Views:	1
Size:	27.6 KB
ID:	1209901
    • If everything is ok, you should see a success message like on the screenshot below. If you don't, make sure your HomeSeer machine can be reach on port 4555
    • Click the "Done" button in iTunes and in the config page

    Click image for larger version

Name:	pairing_success.png
Views:	1
Size:	29.1 KB
ID:	1209902
    Last edited by spud; August 15, 2016, 02:57 PM.


    On first run the plugin will automatically create some iTunes devices which allow you to:
    • get information on what's currently playing: Artist, Track, Album, Genre, Cover
    • have some control on your iTunes instance: Play, Pause, volume, shuffle, repeat, etc...

    Click image for larger versionName:	itunesdaapdevices.jpgViews:	1Size:	128.8 KBID:	1170422

    Web player

    From Plug-ins > iTunes DAAP > Player, you have access to a web user interface which allows you to browse your iTunes library, select a track to play, control master volume and airplay speakers volume, etc... basically all operations you can do from the iTunes UI.

    Click image for larger versionName:	itunesdaapplayer.jpgViews:	1Size:	64.7 KBID:	1170423
    Click image for larger versionName:	speakers.jpgViews:	2Size:	55.6 KBID:	1170424


    You can use the iTunes devices to trigger HS events, for example if you want to turn the lights off when iTunes start playing something, and turn them on when it is paused or stopped, you can do so by creating some events like on the screenshot below:

    Click image for larger versionName:	triggers.jpgViews:	1Size:	98.6 KBID:	1170425


    You can use the iTunes devices to perform some iTunes actions, the same way we did for triggers. For example if you want to use the Kinect plugin to add a voice command to turn the music on, you could do so by configuring an event like below:

    Click image for larger versionName:	actions.jpgViews:	1Size:	35.8 KBID:	1170426

    You can also use the specific iTunes DAAP actions for example to play a Playlist:

    Click image for larger versionName:	playplaylist.jpgViews:	2Size:	29.2 KBID:	1170993

    The available actions are:
    • Play Playlist
    • Play Artist
    • Play Album
    • Play Radio
    • Play iTunes Radio
    • Clear Queue
    Last edited by spud; March 11, 2019, 07:43 AM.


      Multiple instances and Remote instances


      You can control as many iTunes instances as you want by starting new instances of the plugin. To do so, click on the + button from the PLUG-INS > Manage page:

      Click image for larger version

Name:	start_instance.jpg
Views:	1
Size:	40.5 KB
ID:	1171099

      Enter a name for your instance, submit, and then enable it.
      This will create some new links in the PLUG-INS > iTunesDAAP menu, allowing you to configure and control a new iTunes instance.
      Go to the "Config - <your_instance> " page and start the pairing process as explained in the plugin configuration section at the begining of this user guide.

      Click image for larger version

Name:	instance_menu.jpg
Views:	1
Size:	86.8 KB
ID:	1171098

      Starting a new instance of the plugin will also create a whole new set of iTunes DAAP devices, a new iTunes DAAP Action category, and a new Player page.


      To run the plugin remotely, you first need to install it on your HS machine (but you don't have to enable it) so that HS doesn't complain about licensing issue when you start your remote instances.

      • copy HSPI_ITUNES_DAAP.exe, and all the dll from bin/iTunesDAAP/ to a directory on your remote computer
      • copy HomeSeerAPI.dll, HSCF.dll and Scheduler.dll from your HS3 directory to the same remote directory
      • open a command prompt on your remote computer
      • cd to the directory, then type HSPI_ITUNES_DAAP.exe server=<ip_of_your_hs_machine> instance=<instance_name>

      where instance_name can be anything you want but only alpha numeric characters.
      Last edited by spud; March 26, 2014, 10:35 AM.