Installation

Unzip the contents of the ZIP file into a folder (e.g. C:\Program Files\iTunesBlogger). The DLL goes into the same folder as the EXE. After the first time you run iTunesBlogger, an XML configuration file will be created in the same folder as the EXE. Run the EXE to start iTunesBlogger.

Web Update Settings

To update your web site with song information from iTunes, specify when you'd like iTunesBlogger to update your web site, and what web address iTunesBlogger should post track information to.

Update URL

The Update URL uses wildcards to specify the URL to which track information is posted. It tells iTunesBlogger the address of your script, and what querystring parameters to pass to it. The legal wildcards are: %a - artist %t - track name %b - album title %g - genre %y - track time For example, http://myblog.foo.com/updatesongs.php?a=%a&t=%t will post the artist and track name to an update script at http://myblog.foo.com/updatesongs.php

Update Type

You can choose to have iTunesBlogger post information to your update script whenever the song, album, or artist changes. If you only want to track which albums you listen to, for example, use the "album" option, which will cause update messages to happen only when a track from a new album is played in iTunes.

Enabling Web Update

Once you have configured the Web Update settings, click the "Enable Web Update" checkbox, and click OK to save your settings. iTunesBlogger will start receiving events from iTunes, and sending update messages according to your settings.

Example Update Scripts

We will be releasing more update scripts soon, so stay tuned. We plan on releasing examples for movable type with support being added for many more later.

PHP Example Instructions Updated DotText Instructions

Hotkey Settings

iTunesBlogger allows you to easily paste "Now Playing" text into your favorite applications using a Hotkey combination, giving easy access to the current song to instant messaging and blog updating programs.

Specifying the Hotkey Combination

To specify the Hotkey combination which will copy track information into the clipboard, set the checkboxes of the Alt, Ctrl, and Shift keys, and pick a letter or number. For example, to use Ctrl-Shift-T as your Hotkey, check the Ctrl and Shift checkboxes, leaving the Alt checkbox unchecked, and select T from the dropdown box.

Specifying the text pattern to copy to the clipboard

The text pattern which is copied to the clipboard is specified in the same way as the Web Update URL. Specify your pattern using wildcards. For example, "%t (%a) " will copy "Time (Pink Floyd) " into the clipboard, allowing you to paste it into your current application.

Enabling the Hotkey Combination

Once you have configured the Hotkey settings, click the "Enable Hotkey" checkbox, and click OK to save your settings. iTunesBlogger will start receiving events from iTunes, and responding by copying the track information when you press the Hotkey combination.

Configuration Settings XML File

Your settings are saved to an XML File in the same folder as the iTunesBlogger executable. For this reason, the user you run iTunesBlogger with needs to be able to create and update files in that folder.