hearken 0.0.1 → 0.0.2

data/.gitignore

@@ -1,4 +1,5 @@
 *.gem
+*song
 .bundle
 Gemfile.lock
 pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.2@hearken --create

data/Gemfile

@@ -1,4 +1,2 @@
-source "http://rubygems.org"
-
-# Specify your gem's dependencies in hearken.gemspec
-gemspec
+source 'http://rubygems.org'
+gemspec

data/README.rdoc

@@ -0,0 +1,48 @@
+= Hearken
+
+This is a command line shell for queuing and playing music tracks.
+
+It also extracts id3 tags from audio files for faster search.
+
+This will eventually be platform independent but at this stage has only been used on mac os x
+
+= Usage
+
+Here you sit expectantly in front of a computer at the command line.
+
+== Install
+
+    gem install hearken
+
+== Dependencies
+
+Tags are currently extracted using ffmpeg.  On mac os x, this can be installed easily using brew:
+
+    brew install ffmpeg
+
+== Indexing tracks
+
+    hearken index DIRECTORY
+
+Will create a track index at ~/.music.  Note that this might take a while the first time you run it.
+
+Subsequent runs will only query tags for new or modified files so should be fairly fast.
+
+== Console
+
+    hearken console
+
+== Commands
+
+    ?
+
+will list all commands
+
+    ? <command>
+
+will describe the use and purpose of a particular command
+
+= Future plans for world domination
+
+* Get working on linux
+* Get working on windows

data/Rakefile

@@ -1 +1,6 @@
 require 'bundler/gem_tasks'
+
+desc 'execute specifications'
+task :test do
+  sh 'bundle exec rspec spec'
+end

data/bin/hearken

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$: << File.dirname(__FILE__)+'/../lib'
+
+require 'hearken/cli'
+
+Hearken::Cli.start

data/hearken.gemspec

@@ -23,4 +23,13 @@ EOF
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
+
+  s.add_dependency 'thor', '~>0'
+  s.add_dependency 'splat', '~>0'
+  s.add_dependency 'shell_shock', '~>0'
+  s.add_dependency 'simple_scrobbler', '~> 0'
+  s.add_dependency 'rainbow', '~> 1'
+
+  s.add_development_dependency 'rake', '~>0'
+  s.add_development_dependency 'rspec', '~>2'
 end

data/lib/hearken.rb

@@ -1,5 +1 @@
-require "hearken/version"
-
-module Hearken
-  # Your code goes here...
-end
+require 'hearken/version'

data/lib/hearken/cli.rb

@@ -0,0 +1,24 @@
+require 'thor'
+
+require 'hearken/version'
+require 'hearken/indexing'
+require 'hearken/console'
+
+module Hearken
+  class Cli < Thor
+    desc 'version', 'Prints the current version'
+    def version
+      puts "Current version is "+Hearken::VERSION
+    end
+
+    desc 'index DIRECTORY', 'Reindexes a music collection'
+    def index directory
+      Hearken::Indexing::Indexer.new(directory).execute
+    end
+
+    desc 'console', 'Enters console for queuing and playing tracks'
+    def console
+      Hearken::Console.new.push
+    end
+  end
+end

data/lib/hearken/command.rb

@@ -0,0 +1,35 @@
+module Hearken
+  module Command
+    attr_reader :usage, :help
+
+    def self.included cls
+      cls.extend ClassMethods
+    end
+
+    def self.load name, *args
+      require "hearken/command/#{name}"
+      classname = name.to_s.split('_').map{|s|s.capitalize}.join
+      Hearken::Command.const_get(classname).new *args
+    end
+
+    def initialize player
+      @player = player
+      @usage = ''
+      @help = ''
+    end
+
+    module ClassMethods
+      def usage usage
+        define_method(:usage) { usage }
+      end
+
+      def help help
+        define_method(:help) { help }
+      end
+
+      def execute &block
+        define_method :execute, block
+      end
+    end
+  end
+end

data/lib/hearken/command/enqueue.rb

@@ -0,0 +1,12 @@
+require 'hearken/range_expander'
+require 'hearken/command'
+
+class Hearken::Command::Enqueue
+  include Hearken::Command
+  usage '*<id>'
+  help 'enqueues the list of songs with the specified ids'
+  execute do |text|
+    @expander ||= Hearken::RangeExpander.new
+    @expander.expand(text).each {|id| @player.enqueue id }
+  end
+end

data/lib/hearken/command/flush.rb

@@ -0,0 +1,7 @@
+require 'hearken/command'
+
+class Hearken::Command::Flush
+  include Hearken::Command
+  help 'flushes the current queue'
+  execute {|ignored| loop { break unless @player.dequeue } }
+end

data/lib/hearken/command/list.rb

@@ -0,0 +1,29 @@
+require 'hearken/command'
+
+class Hearken::Command::List
+  include Hearken::Command
+  usage '*<word>'
+  help <<EOF
+lists the contents of the track queue
+these results can optionally be filtered by specified words
+when playing, approximate times for each track will be displayed
+EOF
+  execute do |text|
+    @terms = text.split(/\W/)
+    current = @player.current
+    if current
+      next_start_time = Time.at current.started
+      show next_start_time, current
+    end
+    next_start_time += current.time.to_i if next_start_time && current.time
+    @player.each do |track|
+      show next_start_time, track
+      next_start_time += track.time.to_i if next_start_time && track.time
+    end
+  end
+
+  def show time, track
+    return unless @terms.empty? or @terms.all? {|term| track.search_string.include? term }
+    puts time ? "#{time.to_s.foreground(:blue)}\n\t#{track}" : track
+  end
+end

data/lib/hearken/command/recent.rb

@@ -0,0 +1,31 @@
+require 'hearken/command'
+
+class Hearken::Command::Recent
+  include Hearken::Command
+  usage '<count>'
+  help 'lists the specified number of recently added albums'
+  execute do |text|
+    @player.library.reload unless @player.library.tracks
+    maximum, current_album, tracks, total_count = text.to_i, nil, [], 0
+    @player.library.tracks.reverse.each do |track|
+      unless current_album
+        current_album = track.album
+        tracks = [track]
+        next
+      end
+      if current_album==track.album
+        tracks << track
+      else
+        puts "#{current_album} - #{extract_artist tracks} - #{tracks.size} tracks (#{tracks.last.search_id}-#{tracks.first.search_id})"
+        current_album = track.album
+        tracks = [track]
+        total_count += 1
+      end
+      break if total_count >= maximum
+    end
+  end
+private
+  def extract_artist tracks
+    tracks.map{|t| t.artist}.uniq.size == 1 ? tracks.first.artist : 'various artists'
+  end
+end

data/lib/hearken/command/reload.rb

@@ -0,0 +1,7 @@
+require 'hearken/command'
+
+class Hearken::Command::Reload
+  include Hearken::Command
+  help 'reloads the contents of the music library for fast searching'
+  execute {|ignored| @player.library.reload }
+end

data/lib/hearken/command/restart.rb

@@ -0,0 +1,7 @@
+require 'hearken/command'
+
+class Hearken::Command::Restart
+  include Hearken::Command
+  help 'stops and restarts the player (which will kill the current track)'
+  execute {|ignored| @player.restart }
+end

data/lib/hearken/command/scrobbling.rb

@@ -0,0 +1,14 @@
+require 'hearken/command'
+
+class Hearken::Command::Scrobbling
+  include Hearken::Command
+  usage '<on|off>'
+  help 'turns interaction with lastfm on or off'
+  execute do |text|
+    scrobbling = (text == 'on')
+    return if @player.scrobbling == scrobbling
+    puts scrobbling ? 'Turning scrobbling on' : 'Turning scrobbling off'
+    @player.scrobbling = scrobbling
+    @player.restart
+  end
+end

data/lib/hearken/command/search.rb

@@ -0,0 +1,25 @@
+require 'hearken/command'
+
+class Hearken::Command::Search
+  include Hearken::Command
+  usage '*<word>'
+  help <<EOF
+searches for tracks containing the specified words (in artist, title or album)
+ids are placed on the clipboard for convenient use with +
+EOF
+  execute do |text|
+    terms = text.split(/\W/)
+    matches = []
+    @player.library.reload unless @player.library.tracks
+    matches = []
+    @player.library.tracks.each do |track|
+      if terms.all? {|term| track.search_string.include? term }
+        puts track
+        matches << track.search_id
+      end
+    end
+    puts "Found #{matches.size} matches (ids have been placed on clipboard)"
+    matches.join(' ').to_clipboard
+    @player.matches = matches
+  end
+end

data/lib/hearken/command/setup_scrobbling.rb

@@ -0,0 +1,7 @@
+require 'hearken/command'
+
+class Hearken::Command::SetupScrobbling
+  include Hearken::Command
+  help 'runs through the steps required to get lastfm scrobbling working'
+  execute {|ignored| @player.scrobbler.setup }
+end

data/lib/hearken/command/show_properties.rb

@@ -0,0 +1,9 @@
+require 'hearken/command'
+require 'pp'
+
+class Hearken::Command::ShowProperties
+  include Hearken::Command
+  usage '<id>'
+  help 'show the track details for a specified id'
+  execute {|id| @player.library.with_track(id.to_i(36)) {|track| pp track } }
+end

data/lib/hearken/command/shuffle.rb

@@ -0,0 +1,13 @@
+require 'hearken/command'
+
+class Hearken::Command::Shuffle
+  include Hearken::Command
+  help 'shuffles the current queue'
+  execute do |ignored=nil|
+    ids = []
+    while id = @player.dequeue
+      ids << id
+    end
+    ids.sort_by { rand }.each {|id| @player.enqueue id }
+  end
+end

data/lib/hearken/command/start.rb

@@ -0,0 +1,7 @@
+require 'hearken/command'
+
+class Hearken::Command::Start
+  include Hearken::Command
+  help 'starts the player'
+  execute {|ignored| @player.start }
+end

data/lib/hearken/command/status.rb

@@ -0,0 +1,7 @@
+require 'hearken/command'
+
+class Hearken::Command::Status
+  include Hearken::Command
+  help 'shows the current player status'
+  execute {|ignored| puts @player.status }
+end

data/lib/hearken/command/stop.rb

@@ -0,0 +1,7 @@
+require 'hearken/command'
+
+class Hearken::Command::Stop
+  include Hearken::Command
+  help 'stops the player'
+  execute {|ignored| @player.stop }
+end

data/lib/hearken/console.rb

@@ -0,0 +1,34 @@
+require 'shell_shock/context'
+
+require 'hearken/player'
+require 'hearken/preferences'
+require 'hearken/command'
+
+require 'yaml'
+
+module Hearken
+  class Console
+    include ShellShock::Context
+
+    def with name, *aliases
+      aliases << name.to_s if aliases.empty?
+      add_command Command.load(name, @player), *aliases
+    end
+
+    def with_all *names
+      names.each {|name| with name}
+    end
+
+    def initialize
+      preferences = Preferences.new
+      @player = Player.new preferences
+      at_exit { @player.stop }
+      @prompt = "hearken > "
+      with :status, "'"
+      with :show_properties, 'show'
+      with :restart, 'next'
+      with :enqueue, '+'
+      with_all *%w{reload search start stop scrobbling shuffle list setup_scrobbling recent flush}
+    end
+  end
+end

data/lib/hearken/debug.rb

@@ -0,0 +1,16 @@
+module Hearken
+  module Debug
+    def debug message
+      if ENV['DEBUG']
+        puts message 
+      end
+    end
+
+    def pause
+      if ENV['DEBUG']
+        puts "Hit enter to continue"
+        gets
+      end
+    end
+  end
+end

data/lib/hearken/indexing.rb

@@ -0,0 +1,7 @@
+module Hearken
+  module Indexing
+    PATH = File.expand_path('~')+'/.music'
+  end
+end
+
+require 'hearken/indexing/indexer'