NAME itunes.pl - Perform operations on iTunes tracks. SYNOPSIS itunes.pl [--help] [--library] [--current-playlist] [--playlist name] [--all-playlists] [--create-playlist [name]] [--delete-playlist [name]] [--current-track] [--selected-tracks] [--all-tracks] [--find string] [--visible-find string] [--find-artist string] [--find-album string] [--find-composer string] [--find-song-name string] [--print-info format] [--play-found] [--add-to-playlist [name]] [--set-artist string] [--set-album string] [--set-bpm number] [--set-comment string] [--set-composer string] [--set-disc-count number] [--set-disc-number number] [--set-enabled] [--set-disabled] [--set-eq string] [--set-genre string] [--set-grouping string] [--set-name string] [--set-play-count number] [--set-rating number] [--set-skip-count number] [--set-track-count number] [--set-track-number number] [--set-volume-adjustment string] [--set-year number] [--volume number] [--volume-down [number]] [--volume-up [number]] [--mute] [--unmute] [--scan-to number] [--scan-backwards [number]] [--scan-forwards [number]] [--next-track] [--pause] [--play] [--play-file name] [--play-pause] [--previous-track] [--stop] [--add-file name] [--open-url url] [--goto-music-store-home-page] [--update-ipod] [--quit] DESCRIPTION Allows control of iTunes for Windows via a command line. It provides all basic media controls such as play, pause, stop, next/previous track, and volume adjustment. In addition, you can search for tracks in any given playlist and perform operations on them, or retrieve information regarding them. You can also add tracks to the library, sync your iPod, and perform a variety of other operations. OPTIONS Program Commands These commands affect the script itself. --help Display program help. Playlist Selection Commands These commands select one or more playlists to perform other operations on. More than one can be issued to select multiple playlists. --library Operation will include the entire iTunes library. Used by default unless other libraries are selected. --current-playlist Operation will include the current playlist. --playlist name Operation will include the named playlist. (This option can occur more than once.) --all-playlists Operation will include all playlists. --create-playlist [name] Create a playlist with the specified name and include it in the operation. (This option can occur more than once.) --delete-playlist [name] Delete the playlist with the specified name. (This option can occur more than once.) Track Selection Commands These commands select one or more tracks to perform other operations on. More than one can be issued to select multiple tracks. --current-track Operation will inclue the current track. --selected-tracks Operation will include the selected tracks. --all-tracks Operation will include all tracks in the specified playlist(s). --find string Operation will include all tracks in the specified playlist(s) where any field matches the specified string. (This option can occur more than once.) --visible-find string Operation will include all tracks in the specified playlist(s) where any visible field matches the specified string. (This option can occur more than once.) --find-artist string Operation will include all tracks in the specified playlist(s) where the artist matches the specified string. (This option can occur more than once.) --find-album string Operation will include all tracks in the specified playlist(s) where the album matches the specified string. (This option can occur more than once.) --find-composer string Operation will include all tracks in the specified playlist(s) where the artist matches the specified string. (This option can occur more than once.) --find-song-name string Operation will include all tracks in the specified playlist(s) where the artist matches the specified string. (This option can occur more than once.) Commands for Specified Tracks These commands affect tracks selected as a result of the above commands. --print-info format For each track, print information in the given format. If the following strings appear in the given format, they will be replaced with the corresponding track information: "%a": artist "%e": encoding "%A": album "%b": BPM "%c": composer "%C": comment "%d": disc number "%D": disc count "%E": Enabled status ("enabled" or "disabled") "%l": location (file name/URL) "%p": play count "%q": equalizer "%g": genre "%G": grouping "%n": name (title) "%r": rating "%s": skip count "%t": track number "%T": track count "%v": volume adjustment "%y": year "%%": percent sign --play-found Play the first of the selected tracks. --add-to-playlist name Add the selected tracks to the given playlist. (This option can occur more than once.) --set-artist string Set the artist for each track. --set-album string Set the album for each track. --set-bpm number Set the beats per minute for each track. --set-comment string Set the comment for each track. --set-composer string Set the composer for each track. --set-disc-count number Set the disc count for each track. --set-disc-number number Set the disc number for each track. --set-enabled Enable the check box for each track. --set-disabled Disable the check box for each track. --set-eq string Set the equalizer preset for each track. --set-genre string Set the genre for each track. --set-grouping string Set the grouping for each track. --set-name string Set the name (title) for each track. --set-play-count number Set the play count for each track. --set-rating number Set the rating for each track. Valid values are 0 through 5. --set-skip-count number Set the skip count for each track. --set-track-count number For each track, set the number of tracks on its album. --set-track-number number For each track, set its album track number. --set-volume-adjustment string Set the volume adjustment for each track. --set-year number Set the year of publication for each track. General Commands These commands affect iTunes itself, rather than the specified playlists or tracks. --volume number Set the volume to [number] percentage points. --volume-down [number] Decrease the volume by [number] percentage points (default 10). --volume-up [number] Increase the volume by [number] percentage points (default 10). --mute Mute the audio. --unmute Unmute the audio. --scan-to number Scan to an offset [number] seconds within the current track. --scan-backwards [number] Scan backwards [number] seconds within the current track (default 10). --scan-forwards [number] Scan forwards [number] seconds within the current track (default 10). --next-track Go to the next track. --pause Pause playback. --play Play the current song. --play-file name Play the specified file or folder. --play-pause If currently paused, begin playing. If currently playing, pause playback. --previous-track Go to the previous track. --stop Stop playback. --add-file name Add the specified file or folder to the library. --open-url url Open the given URL. --goto-music-store-home-page Go to the Music Store. --update-ipod Update the iPod. --quit Exit iTunes. EXAMPLES itunes.pl --all-tracks --print-info "%l" > library.m3u itunes.pl --playlist "Party Shuffle" --all-tracks --play-found itunes.pl --add-file "C:\content\Nine Inch Nails" LICENSE This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Please see the LICENSE.txt file for the full license. AUTHOR Copyright 2004-2006 Jay McGavren, chicgeekaz@hotmail.com