== Synopsis
itch - Control Helper for ITunes - Perform operations on iTunes tracks.
== Usage
itch [--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-track-name string] [--print-info format] [--play-found] [--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-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.
== Examples
Get help:
itch --help
Start up iTunes [if necessary] and begin playing:
itch --play
Find and play a song:
itch --find "mookid" --play-found
Find all songs from an artist, show basic info on them, and play the first found:
itch --find "aphex twin" --print-info "%a - %A - %t - %n" --play-found
== Building from Source
The setup should be fairly standard for anyone familiar with Rake. There are a few external dependencies; see below for links.
Get the source from the project site.
Change into the project directory. Run "rake -T" for a list of targets. You'll need RubyScript2Exe to build a Windows executable, or NSIS to build a Windows installer. Building a gem should work out of the box. "rake" builds an installer and a gem by default.
== See Also
Project Site: http://code.google.com/p/itunes-control/
Nullsoft Scriptable Install System: http://nsis.sourceforge.net/
RubyScript2Exe: http://www.erikveen.dds.nl/rubyscript2exe/index.html
iTunes: http://www.apple.com/itunes/
== Thanks
Thanks to Eden Li and Gary Wright for various Ruby advice and assistance.
== Author
Copyright Jay McGavren, [email protected]
== 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.
== Legal
iTunes is a trademark of Apple Inc.
Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
itch is not endorsed, licensed, or sponsored by Apple Inc or Microsoft Corporation.
itch - Control Helper for ITunes - Perform operations on iTunes tracks.
== Usage
itch [--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-track-name string] [--print-info format] [--play-found] [--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-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.
== Examples
Get help:
itch --help
Start up iTunes [if necessary] and begin playing:
itch --play
Find and play a song:
itch --find "mookid" --play-found
Find all songs from an artist, show basic info on them, and play the first found:
itch --find "aphex twin" --print-info "%a - %A - %t - %n" --play-found
== Building from Source
The setup should be fairly standard for anyone familiar with Rake. There are a few external dependencies; see below for links.
Get the source from the project site.
Change into the project directory. Run "rake -T" for a list of targets. You'll need RubyScript2Exe to build a Windows executable, or NSIS to build a Windows installer. Building a gem should work out of the box. "rake" builds an installer and a gem by default.
== See Also
Project Site: http://code.google.com/p/itunes-control/
Nullsoft Scriptable Install System: http://nsis.sourceforge.net/
RubyScript2Exe: http://www.erikveen.dds.nl/rubyscript2exe/index.html
iTunes: http://www.apple.com/itunes/
== Thanks
Thanks to Eden Li and Gary Wright for various Ruby advice and assistance.
== Author
Copyright Jay McGavren, [email protected]
== 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.
== Legal
iTunes is a trademark of Apple Inc.
Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
itch is not endorsed, licensed, or sponsored by Apple Inc or Microsoft Corporation.