itunes-command 1.4-universal-darwin-9

data/bin/itunes-command

@@ -0,0 +1,3 @@
+#!/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby
+require 'itunes-command'
+ItunesCommand.run ARGV

data/itunes-command.rb

@@ -0,0 +1,416 @@
+#!/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby
+
+# If the shebang line doesn't point to your OS X installation of ruby, find it
+# and correct the path above.
+#
+# itunes-command.rb
+#
+# Requirements: 
+#
+#   OS X Leopard
+#
+# Instructions: 
+#
+#   Save this file as 'itunes-command.rb' or whatever else you wish to call it.
+#
+#   Run it with either:
+#
+#     ruby itunes-command.rb
+#
+#   or 
+#
+#     ./itunes-command.rb 
+#
+#   or itunes-command.rb
+#
+#   The 2nd and 3rd options assume that you made the file executable with 
+#
+#     chmod u+x itunes-command.rb
+#
+#   The 3d options also assumes that itunes-command.rb is on your PATH.
+#
+# Author: Daniel Choi
+# Location: Cambridge, MA
+# Affiliation: http://betahouse.org
+# Email: dhchoi@gmail.com
+# Project Homepage: http://danielchoi.com/software/itunes-command.html
+#
+# License: MIT
+#
+# Copyright (c) 2008 Daniel Choi
+#
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without
+# restriction, including without limitation the rights to use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following
+# conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+
+require 'rubygems' 
+$:.unshift File.dirname(__FILE__)
+require 'readline'
+require 'osx/cocoa'
+OSX.require_framework 'ScriptingBridge'
+
+class ITunes
+  QUEUE_PLAYLIST = 'itunes-command'
+  def initialize
+    @app = OSX::SBApplication.applicationWithBundleIdentifier("com.apple.iTunes")
+  end
+
+  # Delegate all other methods to the SBAppliation object for iTunes
+  def method_missing(message, *args)
+    @app.send(message, *args)
+  end
+
+  def party_shuffle
+    playlists.detect {|x| x.name == "Party Shuffle"}
+  end
+
+  def playlists
+    @app.sources.first.playlists
+  end
+
+  def playlist_by_name(name)
+    playlists.detect {|p| p.name == name}
+  end
+
+  def library
+    playlists.first
+  end
+
+  def artists(playlist=library)
+    return {} if playlist.tracks.empty?
+    artists = playlist.tracks.arrayByApplyingSelector("artist").select {|x| x.to_s =~ /\w/}
+    # count tracks per artist, which is represented to number of occurrences
+    artist = Hash.new(0)
+    artists.each do |name|
+      artist[name.to_s] += 1
+    end
+    artist
+  end
+
+  # Pass in a string to get matching tracks. Pass in an integer to search by 
+  # databaseID
+  def find_track(query)
+    if query.is_a?(String)
+      library.searchFor_only(query, nil)
+    elsif query.is_a?(Integer) # lookup by databaseID
+      predicate = OSX::NSPredicate.predicateWithFormat("databaseID == #{query}")
+      # assume that only one track matches, and return it
+      library.tracks.filteredArrayUsingPredicate(predicate).first
+    end
+  end
+
+  def find_tracks(track_ids)
+    predicate = OSX::NSPredicate.predicateWithFormat("databaseID IN {%s}" % track_ids.join(','))
+    library.tracks.filteredArrayUsingPredicate(predicate)
+  end
+
+  def add_track_to_playlist(track, playlist)
+    if playlist.is_a?(String)
+      playlist = playlist_by_name(playlist)
+    end
+    track = track.duplicateTo(playlist)
+    #    The following does not work:
+    #    arg1 = OSX::NSArray.arrayWithArray([track])
+    #    puts arg1.class
+    #    puts playlist.class
+    #    puts @app.add_to_(arg1, playlist)
+  end
+
+  def add_tracks_to_playlist(tracks, playlist, credit=nil)
+    if playlist.is_a?(String)
+      playlist = playlist_by_name(playlist)
+    end
+    if tracks.is_a?(Array) # need to convert Ruby array into NSArray
+      tracks = OSX::NSArray.arrayWithArray(tracks)
+    end
+    tracks.makeObjectsPerformSelector_withObject("setEnabled:", 1)
+    if credit
+      tracks.makeObjectsPerformSelector_withObject("setComment:", credit)
+    end
+    # Note the colon in the selector string
+    tracks.makeObjectsPerformSelector_withObject("duplicateTo:", playlist)
+    # enable all tracks - does not work
+  end
+
+  def remove_track_from_playlist(track, playlist)
+    # looks dangerous!
+    return
+    track.delete
+  end
+
+  def create_playlist(name)
+    return if playlist_by_name(name) 
+    props = {:name => name}
+    playlist = @app.classForScriptingClass("playlist").alloc.initWithProperties(props)
+    playlists.insertObject_atIndex(playlist, 0)
+    playlist
+  end
+
+  # makes sure the queue playlist is selected. importance for pause/play, skip,
+  # etc.
+  def select_queue_playlist
+    browserWindows.first.view = queue
+  end
+
+  # This is the playlist that itunes-rails uses
+  def queue
+    playlist_by_name(QUEUE_PLAYLIST) || create_playlist(QUEUE_PLAYLIST)
+  end
+
+  def queue_track(track)
+    add_track_to_playlist(track, queue)
+  end
+
+  def queue_tracks(tracks,credit=nil)
+    add_tracks_to_playlist(tracks, queue, credit)
+  end
+
+  def clear_queue
+    queue.tracks.removeAllObjects
+  end
+
+end
+class ItunesCommand 
+  VERSION = '1.3'
+  attr_accessor :playlist_mode
+  def initialize
+    @i = ITunes.new
+    @playlists = []
+    @tracks = []
+    @playlist_mode = false
+  end
+
+  def parse(method, *args)
+    self.send method, args
+  end
+
+  def search(string=nil)
+    unless string
+      puts "Please enter a search string"
+      return
+    end
+    @tracks = @i.find_track(string)
+    print_names(@tracks)
+  end
+
+  def search_artist(string=nil)
+    unless string
+      puts "Please enter a search string"
+      return
+    end
+    @tracks = @i.find_track(string)
+    print_names(@tracks)
+  end
+
+  def print_names(items)
+    items =  Array(items)
+    rows = []
+    items.each_with_index do |t, i|
+      begin
+        puts("%2d %s : %s" % [i, t.artist, t.name])
+      rescue
+      end
+    end
+    items
+  end
+
+  def play(index)
+    if @tracks.empty?
+      puts "No tracks in buffer yet. Try searching."
+      return
+    end
+    track = @tracks[index.to_i]
+    puts "Playing '#{track.name}' by #{track.artist} from #{track.album}"
+    track.playOnce(1)
+  end
+
+  def stop
+    @i.stop
+  end
+
+  def volume(level=nil)
+    unless level
+      puts "The volume is #{@i.soundVolume} out of 100"
+      return
+    end
+    @i.soundVolume = level
+    puts "The volume set to #{@i.soundVolume} out of 100"
+  end
+
+  def +(steps=10)
+    @i.soundVolume = @i.soundVolume + steps.to_i
+    volume
+  end
+
+  def -(steps=10)
+    @i.soundVolume = @i.soundVolume - steps.to_i
+    volume
+  end
+
+  def playlists
+    @playlist_mode = true
+    puts "Showing playlists"
+    playlists = @i.playlists
+    playlists.each_with_index do |p,i|
+      puts("%2d %s" % [i, p.name])
+    end
+  end
+
+  def select_playlist(index)
+    @current_playlist = @i.playlists[index.to_i]
+    # show tracks
+    @tracks = @current_playlist.tracks
+    print_names(@tracks)
+    @playlist_mode = false
+  end
+
+  def playlist(index)
+    @playlists ||= playlists
+    puts @playlists[index].name
+  end
+
+  def queue(index)
+    @i.queue_track(track=@tracks[index.to_i])
+    puts "Added #{track.name} to the queue"
+  end
+
+  def show_queue
+    if @i.queue.tracks.empty?
+      puts "The queue is empty"
+      return
+    end
+    state = `osascript -e 'tell application "iTunes" to player state as string'`.strip
+    if state != 'stopped'
+      current_track_index = `osascript -e 'tell application "iTunes" to index of current track as string'`.to_i
+    else
+      current_track_index = nil
+    end
+    @i.queue.tracks.each_with_index do |t, i|
+      if current_track_index && current_track_index - 1 == i
+        puts "%s : %s <--- currently playing" % [t.artist, t.name]
+      else
+        puts "%s : %s" % [t.artist, t.name]
+      end
+    end
+  end
+
+  def clear_queue
+    @i.clear_queue
+    puts "Cleared queue"
+  end
+
+  def start_queue
+    @i.stop
+    @i.queue.playOnce(1)
+    track = @i.currentTrack
+    puts "Playing '#{track.name}' by #{track.artist} from #{track.album}"
+  end
+
+  def skip
+    @i.nextTrack
+    track = @i.currentTrack
+    puts "Playing '#{track.name}' by #{track.artist} from #{track.album}"
+  end
+
+  def artists
+    rows = []
+    (@artists=@i.artists).keys.sort_by {|x| x.downcase}.each_with_index  do |k, i|
+      rows << ("%s (%s tracks)" % [k, @artists[k]])
+    end
+    pager(rows)
+  end
+
+  def pager(rows)
+    out = rows.join("\n")
+    IO.popen("less", "w") do |less|
+      less.puts out
+      less.close_write
+    end
+  end
+
+  HELP = <<END
+  itunes-command
+
+  Commands:
+
+  q                   quit
+  h                   show commands
+  s <string>          searches for tracks matching <string>
+  <track number>      plays a track (assumes you've done a search and got results)
+  a                   lists all artists in the library
+  v                   show the current volume level
+  v <level>           sets the volume level (1-100)
+  + <increment>       increases the volume by <increment>; default is 10 steps
+  - <increment>       decreases the volume by <increment>; default is 10 steps
+  x                   stop
+  p                   shows all playlists 
+  <playlist number>   shows all the tracks in a playlist
+  l                   list all tracks in the queue (which will play tracks in succession)
+  n <track number>    put a track in the queue
+  c                   clear the queue
+  g                   start playing tracks in the queue
+  k                   skip to next track in queue
+END
+
+  COMMANDS = { 's' => :search, 
+  'x' => :stop , 'play' => :play, 'v' => :volume, 'a' => :artists, '+' => :+, '-' => '-',
+  'p' => :playlists, 'select_playlist' => :select_playlist, 'l' => :show_queue, 'n' => :queue, 
+  'c' => :clear_queue, 'g' => 'start_queue', 'k' => 'skip'}
+
+  def self.run(argv=ARGV)
+    i = ItunesCommand.new
+    puts HELP
+    loop do
+      command = Readline.readline(">> ").chomp
+      if command =~ /^q/
+        exit
+      elsif command =~ /^h/
+        puts HELP
+        next
+      end
+      args = command.split(' ')
+      if args.first =~ /\d+/
+        if i.playlist_mode
+          args.unshift 'select_playlist'
+        else
+          args.unshift 'play'
+        end
+      end
+      method = COMMANDS[args.shift]
+      if method.nil?
+        puts "Sorry, I don't recognize that command."
+        next
+      end
+      begin
+        args.empty? ? i.send(method) : i.send(method, args.join(' '))
+      rescue ArgumentError
+        puts "Invalid command."
+      end
+    end
+
+  end
+
+end
+
+
+if __FILE__ == $0
+  ItunesCommand.run ARGV
+end
+

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification 
+name: itunes-command
+version: !ruby/object:Gem::Version 
+  version: "1.4"
+platform: universal-darwin-9
+authors: 
+- Daniel Choi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-17 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Search, queue, and play iTunes tracks from the command line.
+email: dhchoi@gmail.com
+executables: 
+- itunes-command
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- itunes-command.rb
+has_rdoc: false
+homepage: http://cesareborgia.com/software/itunes-command/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Search and play iTunes tracks from the command line
+test_files: []
+