vitunes-10.5 0.4.8

data/.gitignore

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

data/MIT-LICENSE.txt

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Daniel Choi, http://danielchoi.com/software/
+
+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.
+

data/NOTES

@@ -0,0 +1,246 @@
+
+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/
+
+
+
+------------------------------------------------------------------------
+Fri Jul  1 17:03:25 EDT 2011
+
+found out about this project
+http://freshmeat.net/projects/vitunes
+- last change jan 2011
+
+Also
+http://www.vim.org/scripts/script.php?script_id=523
+
+An old applescript 
+http://www-personal.umich.edu/~apape/Post/itunescli/itunes
+
+
+Sat Jul  2 16:26:56 EDT 2011
+
+TODO: you can't add tracks to some playlists ; give user some indication
+
+
+
+------------------------------------------------------------------------
+Tue Jul  5 13:03:42 EDT 2011
+
+
+Coverage
+
+http://osxdaily.com/2011/07/05/command-line-tunes-player-vitunes/
+http://www.macworld.com/article/160936/2011/07/vitunes.html
+

data/README.markdown

@@ -0,0 +1,195 @@
+# ViTunes
+
+ViTunes lets you control and navigate iTunes from the comfort of Vim.
+
+[screenshots]
+
+Benefits:
+
+* Control iTunes without leaving Vim, where one is probably in a state of productive bliss
+* Avoid using the mouse or trackpad; keystrokes get you there faster
+* Zen-minimalist textual UI works better on small screens than iTunes' bulky, multi-paned GUI
+* Control iTunes from another computer over ssh, across the room or across the world
+* Let multiple people control one instance of iTunes over ssh ([how][multi]) 
+* Control iTunes from a GNU/Linux client computer over ssh 
+
+[multi]:https://github.com/danchoi/vitunes/wiki
+
+ViTunes is pronounced vee-eye-tunes.
+
+If you're looking for `vitunes` for MPlayer by Ryan Flannery, click [here](http://freshmeat.net/projects/vitunes).
+
+## 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.  If
+you don't want to install the Vim plugin and just want to run `vitunes` as a
+stand-alone program, just run `gem install vitunes` and skip `vitunes-install`.
+
+If you get an error message saying that vitunes-install is missing, then you
+probably have a `PATH` issue. Try one of these workarounds:
+
+* Put the directory where Rubygems installs executables on your `PATH`
+* Try installing with `sudo gem install vitunes && vitunes-install`
+
+To upgrade ViTunes to a newer version, just repeat the installation procedure.
+
+## How to use it 
+
+For all the commands below, the mapleader is just assumed to be a `,`. If your
+mapleader is `\` or something else, use that instead.
+
+
+### Starting ViTunes
+
+You can run ViTunes in two ways:
+
+* within Vim with `,i` or `,I` 
+* from the command line with the `vitunes` command
+
+### General commands
+
+* `,i` invoke or dismiss ViTunes 
+* `,I` invoke ViTunes and go full screen with it
+* `,?` show help and commands
+
+`,I` is useful if you want to launch immediately into ViTunes after starting Vim.
+
+### 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
+
+Playlist, artist, genre, and album navigation (but not search) use make use of
+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. This autocompletion is
+case-sensitive.
+
+`CTRL-p` and `CTRL-n` let you navigate the drop-down matches. Press `ENTER` to select
+one.
+
+More advanced autocompletion tips:
+
+* `CTRL-e` closes the match list and lets you continue typing
+* `CTRL-u`: when the match list is active, cycles forward through the match
+  list and what you've typed so far; when the match list is inactive, erases
+  what you've typed.
+* both `TAB` and `CTRL-x CTRL-u` reactivates autocompletion if it's gone away
+* `CTRL-y` selects the highlighted match without triggering ENTER
+
+To exit the autocompletion or search query mode, press `ENTER` when the query
+line is blank, or try `ESC` then `q`. 
+
+### Volume Control
+
+* `+` louder
+* `-` softer
+* `=` louder
+
+### Playhead
+
+* `SPACEBAR` play/pause
+* `>` next track in ViTunesBuffer
+* `<` previous track in ViTunesBuffer
+* `>>` next track in iTunes current playlist
+* `<<` previous track in iTunes current playlist
+* `.` show current track and playlist, if any
+
+One thing to note: if you start playing a track that you've gotten to by going
+through the playlist dropdown, iTunes will play in continuous mode, where the
+next track in the playlist will automatically start playing after the current
+one ends.
+
+But if you start playing a track you found some other way (e.g. via search
+query), iTunes will stop playing after that track ends.
+
+If you want to use ViTunes to find and queue a bunch of tracks and have them play 
+in automatic succession, use the next feature...
+
+### Copying and deleting tracks
+
+* `,c` copy track(s) to a playlist
+* `BACKSPACE` deletes track(s) from the 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.
+
+If this target playlist is already playing, you can keep queuing tracks to it
+and let the mix play out automatically.
+
+To delete tracks from a playlist, put the cursor on a track or select a range
+of tracks, and then hit `BACKSPACE` (the Apple delete key) to remove them from
+the playlist that you are looking at. 
+
+### Managing playlists
+
+* `,P` goes to the current playlist, if there is one
+* `:NewPlaylist [new playlist name]` creates a new playlist
+
+### Tips
+
+If you want to see your entire library in a Vim buffer, load the `Library`
+playlist. It may take a few seconds to load your entire iTunes library. But
+once it's loaded you'll be able to page through it at blazing speed and play
+any tracks you want. The list will be sorted by artist.
+
+If you have cheap Linux netbooks, they make good ViTunes controllers.  I
+control the iTunes on my Mac Mini from two Linux Asus 1015PEM netbooks that I
+move around the apartment.
+
+### History and future
+
+I've been interested in designing alternative user interfaces to iTunes since
+2008, when I was working out of the creative hacker cooperative [Betahouse](http://betahouse.org/).  
+
+* My first experiment was [itunes-rails](http://code.google.com/p/itunes-rails/). 
+* My second experiment was [itunes-command](http://danielchoi.com/software/itunes-command.html).
+* ViTunes is the third experiment.
+
+If you run a coffeeshop or coworking space where you'd like to let people use a
+common iTunes library like a jukebox, **please let me know**, because I'm
+interested in making something convenient for this kind of environment.  This
+will probably require interaction via mobile devices.
+
+### Buy more music, support the ViTunes project
+
+* `,z` opens Amazon's MP3 Store in your web browser 
+
+At no additional cost to you, Amazon will give the ViTunes developer a small
+referral bonus (around 6%) when you buy MP3s via `,z`.  Thank you for your support!
+
+
+## Bug reports and feature requests
+
+Please submit these at either of these places:
+
+* <https://github.com/danchoi/vitunes/issues>
+* <http://groups.google.com/group/vitunes-users>
+
+## About the developer
+
+My name is Daniel Choi. I specialize in Ruby, Rails, MySQL, PostgreSQL, and iOS
+development. I am based in Cambridge, Massachusetts, USA, and the little
+software company I run with Hoony Youn is called [Kaja Software](http://kajasoftware.com). 
+
+* Company Email: info@kajasoftware.com
+* Twitter: [@danchoi][twitter] 
+* Personal Email: dhchoi@gmail.com  
+* My Homepage: <http://danielchoi.com/software>
+
+[twitter]:http://twitter.com/#!/danchoi
+
+

data/Rakefile

@@ -0,0 +1,70 @@
+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`
+  `cp coverage.markdown ../project-webpages/src/vitunes.coverage.markdown`
+  Dir.chdir "../project-webpages" do
+    puts `ruby gen.rb vitunes #{ViTunes::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/TODO

@@ -0,0 +1,4 @@
+TODO 
+- for true ssh integration, allow user to specify vitunes command as a
+  ssh user@host '/path/to/vitunes-objc' 
+

data/bin/vitunes

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+begin
+  require 'vitunes'
+rescue LoadError
+  require 'rubygems'
+  require 'vitunes'
+end
+
+vimscript_file = File.join(File.dirname(__FILE__), '..', 'lib', 'vitunes.vim')
+exec("vim -S #{vimscript_file} -c ':call ViTunes()' -c ':only'")

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

data/coverage.markdown

@@ -0,0 +1,5 @@
+* [Hacker News](http://news.ycombinator.com/item?id=2836883)
+* [Macworld](http://www.macworld.com/article/160936/2011/07/vitunes.html)
+* [OSXDaily](http://osxdaily.com/2011/07/05/command-line-tunes-player-vitunes/)
+* [One Thing Well](http://onethingwell.org/post/7341797630/vitunes)
+* [tweets](http://twitter.com/#!/search/vitunes)