Details

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