vitunes 0.0.3

data/.gitignore

@@ -0,0 +1,11 @@
+.DS_Store
+*.swp
+*~.nib
+build/
+*.pbxuser
+*.perspective
+*.perspectivev3
+*.mode1v3
+*.mode2v3
+xcuserdata
+src/

data/NOTES

@@ -0,0 +1,216 @@
+
+should put a max results limit
+
+
+we need to keep the tracks recently foudn in the search list in memory?
+
+Then that means keeping the process alive in memory. But we can also
+just run the search again and find the track by index.
+
+Tried Macruby but it is too hard to get either multithreaded DRb or
+sinatra working
+
+Vimscript can remember the last command send to system() and just append
+an index number to it
+
+Store lists like in Vmail
+Put databaseID off screen and use it to look up anything
+
+
+https://bitbucket.org/kamitchell/itunesbridged
+
+https://github.com/mislav/itunes/blame/master/itunes.rb
+
+https://github.com/mislav/itunes
+
+  ITunesManager.app.run
+
+  # start playing at the beginning
+  ITunesManager.music.playOnce(false)
+
+  ITunesManager.player_state  #=> :playing
+
+  ITunesManager.app.playpause
+  ITunesManager.player_state  #=> :paused
+
+  track = ITunesManager.current_track
+
+  # for more properties, see iTunes.h under "@interface iTunesTrack"
+  track.name
+  track.artist
+  track.album
+
+  # playlist management
+  favorites = ITunesManager.find_or_create_playlist 'Favorites'
+
+  track = ITunesManager.music.fileTracks.first
+  favorites << track
+
+  favorites.add ITunesManager.music.search('daft punk')
+  favorites.add ITunesManager.music.search('pendulum', :artists)
+  favorites.add ITunesManager.music.search('easy rider', :albums)
+
+
+
+[choi spartan~/p/vitunes]$ /Users/choi/projects/vitunes/build/Release/vitunes search rush
+2011-06-30 02:08:59.516 vitunes[68007:903] args: (
+    "/Users/choi/projects/vitunes/build/Release/vitunes",
+    search,
+    rush
+)
+1746 P56/Brushstroking Fingerstyle Blues Guitar Arnie Berle and Mark Galbo (1993) Religious
+1400 Cold Fire Counterparts Rush (2004) Rock
+1402 Mystic Rhythms Retrospective, Vol. 2 (1981-1987) Rush (1997) Rock
+1404 The Big Money Rush: Spirit of Radio - Greatest Hits 1974-1987 Rush (2003) Rock
+[choi spartan~/p/vitunes]$ /Users/choi/projects/vitunes/build/Release/vitunes playTrackID 1404
+2011-06-30 02:09:09.536 vitunes[68010:903] args: (
+    "/Users/choi/projects/vitunes/build/Release/vitunes",
+    playTrackID,
+    1404
+)
+2011-06-30 02:09:09.646 vitunes[68010:903] playing track: The Big Money
+[choi spartan~/p/vitunes]$ fg
+vim vitunes.rb
+
+[1]+  Stopped                 vim vitunes.rb
+
+
+------------------------------------------------------------------------
+getting all artists in applescript
+
+tell application "iTunes"
+   set myList to get artist of (every track of library playlist 1 whose
+   artist is not missing value)
+   end tell
+   set oldDelim to AppleScript's text item delimiters
+   set AppleScript's text item delimiters to ASCII character 10
+   set allArtists to myList as text
+   set AppleScript's text item delimiters to oldDelim
+   do shell script "echo " & (quoted form of allArtists) & " | sort -u "
+
+
+** BUILD SUCCEEDED **
+
+[choi spartan~/p/vitunes]$ /Users/choi/projects/vitunes/build/Release/vitunes match "artist == 'U2'"
+2011-06-30 02:35:27.146 vitunes[68774:903] tracks: (
+    "Beautiful Day",
+    "Stuck In A Moment You Can't Get Out Of",
+    Elevation,
+    "Walk On",
+    Kite,
+    "In A Little While",
+    "Wild Honey",
+    "Peace On Earth",
+    "When I Look At The World",
+    "New York",
+    Grace,
+    "Pride (In The Name Of Love)",
+    "With Or Without You",
+    "Even Better Than the Real Thing",
+    "Mysterious Ways",
+    "Electrical Storm (William Orbit Mix)",
+    One,
+    "Stay (Faraway, so Close!)",
+    "Zoo Station",
+    Magnificent,
+    Always
+)
+
+
+
+Use contains instead of LIKE
+
+tell application "iTunes"
+   set myList to get artist of (every track of library playlist 1 whose artist is not missing value)
+end tell
+set oldDelim to AppleScript's text item delimiters
+set AppleScript's text item delimiters to ASCII character 10
+set allArtists to myList as text
+set AppleScript's text item delimiters to oldDelim
+do shell script "echo " & (quoted form of allArtists) & " | sort -u "
+
+
+
+------------------------------------------------------------------------
+Thu Jun 30 07:44:42 EDT 2011
+
+
+Don't do any playlist management (writing) for the first release. Stick
+to navigation, search, playing
+
+
+Let user use Mac stop key? No, what if this is via remote?
+
+
+Some commands
+
+playTrackID 1423
+itunes playpause
+itunes currentPlaylist => prints current playlist name
+predicate "name contains 'love'"
+itunes currentTrack => print current track with smae formatting for
+  listed tracks
+
+playPlaylist Purchased
+playlistTracks Purchased
+
+group artist
+group name
+# NOT group year because year involves int, not NSString
+
+------------------------------------------------------------------------
+
+TODO
+- maybe show iTunesPlaylist properties:
+  - duration (total length of playlist in secs)
+  - shuffle BOOL
+  - songRepeat (a constant)
+  - time <= MM:SS
+
+Try adding a track to a playlist (LATER)
+
+Try creating a playlist (LATER)
+
+Rename command line tool itunes-unix since it is general
+
+UI playOnce a track
+play a playlist
+forward and next (already ready to bind to vimscript)
+
+DO IN LATER RELEASE:
+create a playlist
+move tracks to a playlist
+
+  Stick with search, navigation and playing functions for first release.
+  Release earlier this way. The simpler function set is useful enough.
+
+TODO -- all on Vim side
+
+artists, genre, album --> these will open Vim autocomplete dropdown
+selectors
+
+choose an item from the completion window, then we show the standard
+tracks list 
+
+- tracks list will either be a playlist, a search result, or a predicate
+  filter (e.g. all tracks with artist == or album ==
+
+
+------------------------------------------------------------------------
+
+- select a track to play. if IN playlist, start playing continuously
+
+TODO 
+- documentation - ruby command in gem
+- screenshots
+
+------------------------------------------------------------------------
+LATER
+
+- use sortTitle -- not urgent
+- handle case of missing Track (not on disk); e.g. ATB
+- remove from playlist
+- put last seen Playlist on top of Playlist drop down
+- compile vitunes tool and put in bin/
+
+

data/README.markdown

@@ -0,0 +1,65 @@
+# ViTunes
+
+ViTunes lets you control and navigate iTunes from the comfort of Vim.
+
+## Prerequisites
+
+* Ruby 1.8.6 or higher (developed on Ruby 1.9.2)
+* OS X (tested on Snow Leopard 10.6)
+* Vim 7.2 or higher (tested on Vim 7.3)
+
+## Install
+
+    gem install vitunes
+
+    vitunes-install
+
+`vitunes-install` installs a Vim plugin into your ~/.vim/plugin
+directory. 
+
+## How to use it 
+
+### General commands
+
+* `,i` invoke or dismiss ViTunes (if not, it might be `\i` on your system)
+* `?` show help and commands
+
+### Navigation
+
+* `,s` search iTunes library by search query
+* `,p` select playlist
+* `,a` select artist
+* `,g` select genre
+* `,A` select album
+* `ENTER` start playing a track under cursor
+
+The query and selection drop downs make Vim autocompletion. Start typing
+the first few letters of what you want. For example, if you want to jump
+to all artists that start with the letter 'P', type 'P' and you'll see
+the drop down items update.
+
+`CTRL-p` and `CTRL-n` let you navigate the matches. Press `ENTER` to select
+one.
+
+Press `ENTER` or `ESC` to exit drop down selection mode.
+
+### Volume Control
+
+* `+` louder
+* `-` softer
+* `=` softer
+
+### Playhead
+
+* `SPACEBAR` play/pause
+* `>` next track
+* `<` previous track
+* `.` show current track and playlist, if any
+
+### Copying tracks
+
+* `,c` copy track(s) to a playlist
+
+To copy tracks, put the cursor on a track or select a range of tracks,
+and then hit `,c` to select a playlist to copy them to. The tracks will be
+added to the end of the playlist.

data/Rakefile

@@ -0,0 +1,69 @@
+require 'rake'
+require 'rake/testtask'
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), 'lib')
+
+desc "release and build and push new website"
+task :push => [:release, :web]
+
+desc "Bumps version number up one and git commits"
+task :bump do
+  basefile = "lib/vitunes/version.rb"
+  file = File.read(basefile)
+  oldver = file[/VERSION = '(\d.\d.\d)'/, 1]
+  newver_i = oldver.gsub(".", '').to_i + 1
+  newver = ("%.3d" % newver_i).split(//).join('.')
+  puts oldver
+  puts newver
+  puts "Bumping version: #{oldver} => #{newver}"
+  newfile = file.gsub("VERSION = '#{oldver}'", "VERSION = '#{newver}'") 
+  File.open(basefile, 'w') {|f| f.write newfile}
+  `git commit -am 'Bump'`
+end
+
+desc "build and push website"
+task :web => :build_webpage do
+  puts "Building and pushing website"
+  Dir.chdir "../project-webpages" do
+    `scp out/vitunes.html zoe2@instantwatcher.com:~/danielchoi.com/public/software/`
+    `rsync -avz out/images-vitunes zoe2@instantwatcher.com:~/danielchoi.com/public/software/`
+    `rsync -avz out/stylesheets zoe2@instantwatcher.com:~/danielchoi.com/public/software/`
+    `rsync -avz out/lightbox2 zoe2@instantwatcher.com:~/danielchoi.com/public/software/`
+  end
+  `open http://danielchoi.com/software/vitunes.html`
+end
+
+desc "build webpage"
+task :build_webpage do
+  `cp README.markdown ../project-webpages/src/vitunes.README.markdown`
+  Dir.chdir "../project-webpages" do
+    puts `ruby gen.rb vitunes #{Vmail::VERSION}`
+    #`open out/vitunes.html`
+  end
+end
+
+
+desc "git push and rake release bumped version"
+task :bumped do
+  puts `git push && rake release`
+  Rake::Task["web"].execute
+end
+
+desc "Run tests"
+task :test do 
+  $:.unshift File.expand_path("test")
+  require 'test_helper'
+  Dir.chdir("test") do 
+    Dir['*_test.rb'].each do |x|
+      puts "requiring #{x}"
+      require x
+    end
+  end
+
+  MiniTest::Unit.autorun
+end
+
+task :default => :test
+

data/bin/vitunes

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+begin
+  require 'vitunes'
+rescue LoadError
+  require 'rubygems'
+  require 'vitunes'
+end
+
+ViTunes.install_vim_plugin

data/bin/vitunes-help

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'vitunes'
+rescue LoadError
+  require 'rubygems'
+  require 'vitunes'
+end
+
+
+puts ViTunes.help

data/bin/vitunes-install

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+begin
+  require 'vitunes'
+rescue LoadError
+  require 'rubygems'
+  require 'vitunes'
+end
+
+ViTunes.install_vim_plugin