Permalink
Browse files

Adding readme

  • Loading branch information...
1 parent 9ab5355 commit beac2606f12d564a869d8236700e968c2747f61f @kgn committed Jun 23, 2011
Showing with 41 additions and 0 deletions.
  1. +41 −0 README.md
View
@@ -0,0 +1,41 @@
+EyeTunes framework
+======
+
+EyeTunes.framework is a Cocoa Framework that abstracts away all the ugly Carbon Apple Events magic and allows you to directly control iTunes from any Cocoa Application.
+
+This is a fork of the orinial [EyeTunes](http://www.liquidx.net/eyetunes/) project with support for iTunes 10 and other updated features.
+
+Features
+------
+
+* Get all references to iTunes playlists, tracks and album art.
+* Set any writable fields that iTunes exposes such as Track name, artwork and much more.
+* Control iTunes and select playlists and tracks by using either track filenames or database ids.
+* Search the iTunes library just like the search box does.
+* Extract persistent ID and fetch tracks using such ids.
+
+Example
+------
+
+To grab an NSImage from the current playing track (say you're implementing some new album art viewier), you can use this simple snippet:
+
+ #import <EyeTunes/EyeTunes.h>
+
+ - (NSImage *)getArtworkOfPlayingSong{
+ EyeTunes *eyetunes = [EyeTunes sharedInstance];
+ ETTrack *currentTrack = [eyetunes currentTrack];
+ if(currentTrack){
+ NSArray *artwork = [currentTrack artwork];
+ if([artwork count]){
+ return [artwork objectAtIndex:0];
+ }
+ }
+ return nil;
+ }
+
+Resources
+------
+
+For instructions on how to use it, please go to the [EyeTunes project page](http://code.google.com/p/eyetunes/).
+
+[Updating EyeTunes for a new version of iTunes](http://inscopeapps.com/blog/updating-eyetunes/).

0 comments on commit beac260

Please sign in to comment.