Click here to Skip to main content
Click here to Skip to main content

Controlling iTunes through COM

, 14 Jul 2004
Rate this:
Please Sign up or sign in to vote.
An example of how to utilize COM in C# through a system tray application that controls iTunes

Introduction

Apple's iTunes is a powerful audio library manager and player now available for both Windows and Mac. Its feature set is endless and expanding, and, thankfully, through COM, third-party developers can access a good portion of this, even through the .NET Framework and its interop capabilities.

I have built a simple demo application to demonstrate a variety of the features that are available using the iTunes COM interface. This application, by no means, represents the full power of the interface, but is designed to show the different capabilities. Apple's developer web site has an SDK for the complete COM interface.

My application is a system tray utility for controlling iTunes easily and displaying the currently play track. It calls methods, changes properties, and receives events all through COM. It implements the basic functionality of playing, pausing, stopping and changing the currently playing track as well as popping up a window when the track changes.

Instantiating the iTunes Application

In order to access the features that iTunes has to offer, you must first add a reference to the iTunes COM Library to your project. Right click on your project in the Solution Explorer, choose "Add Reference...". Select the COM tab and find the "iTunes 1.1 Type Library", click "Select" and finally click "OK". You will now see "iTunesLib" under your References list for that project.

Next, in any files that you want to communicate with iTunes in, add the following directive:

using iTunesLib;

In order to control iTunes you must create a new instance if the controlling interface. This interface allows your program to communicate with and control (and be controlled by) and already open instance of iTunes.

private myiTunes = new iTunesAppClass();

Using this myiTunes member, you can access functions like Play(), Pause(), Stop(), and Quit(). If for some reason iTunes is closed and your application continues to try and communicate with it, a COMException will be thrown.

Receiving Events from iTunes

The myiTunes member also allows access to certain events like when a new track starts playing, when the current one stops, etc. To specify a new event handler for one of these events, iTunesLib uses the same delegate model that all other events in C# use:

// Add Event Handler
myiTunes.OnPlayerPlayEvent += new _IiTunesEvents_OnPlayerPlayEventEventHandler(
    myiTunes_OnPlayerPlayEvent);

// Event Handler
protected void myiTunes_OnPlayerPlayEvent(object iTrack)
{
...
}

The iTrack parameter provides information about the currently playing track, but in order to get at this information, we must first cast the iTrack into an IITTrack variable.

string myArtist, myName;

IITTrack myTrack = (IITTrack) iTrack;
myArtist = myTrack.Artist;
myName = myTrack.Name;

This is by no means all of the information available in the IITTrack interface. More information is available in Apple's documentation.

Conclusion

I hope that I have merely whetted you appetite in terms of what can be done with controlling Apple's powerful audio application, iTunes. The possibilities are endless: you can batch convert your media to a different format, organize and manage playlists, and batch rename tracks, among other things. Consult Apple's SDK for more information. It is vague in terms of examples, however it contains information about all of the interfaces, what they do, and what members and functions are accessible through each.

Furthermore, I hope I have introduced you to the idea of COM (component object module) and its potentials within your own work. Whether utilizing other COM components functionality or creating your own COM components, I think you will find that it can be endlessly useful, under the right circumstances.

System Requirements

This software is known to work with the following configuration:

  • Microsoft Windows XP SP1 or later
  • Microsoft .NET Framework 1.1
  • Apple iTunes 4.6

The software may possibly work under different configurations, but this has not be verified to date.

Known Issues

  • AnimateWindow WinAPI function does not work properly for fading in the popup display.
  • Popup window timer does not reset when track is changed while popup is showing.

History

  • 07/14/2004 - Article Released

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Adam Durity

United States United States
No Biography provided
Follow on   Twitter

Comments and Discussions

 
QuestionItunes backup control PinmemberBeniwal0125-Sep-13 1:14 
QuestionHow Do I Search The Itune Library? Pinmembercworkman2972922-Jul-09 20:55 
Generalstreaming track from iPod to PC PinmemberHalid Niyaz23-Aug-06 6:29 
GeneralPopup window timer does not reset when track is changed while popup is showing. Pinmemberzelig26-May-06 7:49 
GeneralEvent handling Pinmemberdark_omen23-Mar-06 14:43 
I tried using the eventhamdler and it didnt work. I was trying to update a label, like in the example, using pretty much the same code.
This is what I used to set up the EventHandler
iApp.OnPlayerPlayEvent += new _IiTunesEvents_OnPlayerPlayEventEventHandler(iApp_OnPlayerPlayEvent);
 
then this is the eventhandler i used:
private void iApp_OnPlayerPlayEvent(object iTrack)
{
songTitle = ((IITTrack)iTrack).Name;
songArtist = ((IITTrack)iTrack).Artist;
songAlbum = ((IITTrack)iTrack).Album;
SongName.Text = songTitle;
TrackArtist.Text = songArtist;
TrackAlbum.Text = songAlbum;
this.Refresh();
}
 
But when the song changes it doesn't update the information. Does anybody have a solution?
Thanks
AnswerRe: Event handling Pinmemberndphuong16-Sep-06 22:08 
AnswerRe: Event handling PinmemberChiser9910-Nov-06 13:02 
GeneralUsing with .NET 2.0 Framework PinmemberShawn McCartt23-Jan-06 15:31 
GeneralNot working PinmemberLudo de la Pena10-Mar-06 9:15 
GeneralRe: Not working ? PinmemberLudo de la Pena10-Mar-06 9:44 
GeneralManaging multiple invocations of the COM interop PinmemberDrew Noakes21-Jan-06 11:58 
GeneralRe: Managing multiple invocations of the COM interop PinmemberMember 235878828-Aug-08 4:24 
GeneralRe: Managing multiple invocations of the COM interop PinmemberDrew Noakes28-Aug-08 6:08 
QuestionHide iTunes Pinmembertayspen11-Nov-05 10:35 
QuestionMusic Folder PinmemberTraPpeur29-Sep-05 9:49 
AnswerRe: Music Folder PinmemberAdam Durity13-Oct-05 18:53 
GeneralRe: Music Folder PinmemberTraPpeur14-Oct-05 1:37 
GeneralRe: Music Folder PinmemberErikpro8-May-07 23:43 
GeneralAdding Tracks to iTunes Pinmembersindhoor5-Jun-05 5:25 
GeneralItunes COM Events Pinmemberzx2c425-Mar-05 15:12 
AnswerRe: Itunes COM Events PinmemberpVALIUM2-Nov-07 1:37 
GeneralRe: Itunes COM Events Pinmemberpardillojuegos2-Jul-12 5:35 
GeneralReceiving Events from iTunes PinsussMatt Berube6-Sep-04 9:52 
GeneralRe: Receiving Events from iTunes Pinmemberzx2c426-Mar-05 7:26 
AnswerRe: Receiving Events from iTunes PinmemberMatt Berube4-Dec-05 6:08 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.1411028.1 | Last Updated 15 Jul 2004
Article Copyright 2004 by Adam Durity
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid