easy_mplayer 1.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,2 @@
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Brent Sanders
+
+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/README.rdoc

@@ -0,0 +1,17 @@
+= NAME
+
+Easy MPlayer - A wrapper for easy control of mplayer.
+
+= DESCRIPTION
+
+== Install
+
+  gem install easy_mplayer
+
+== Usage
+
+See the scripts in the examples/ directory.
+
+= COPYRIGHT
+
+Copyright (c) 2010 Brent Sanders. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "easy_mplayer"
+    gem.summary = "Wrapper to launch and control MPlayer"
+    gem.description = "A wrapper to manage mplayer, that supports callbacks to easyily support event-driven GUIs"
+    gem.email = "gem-mplayer@thoughtnoise.net"
+    gem.homepage = "http://github.com/pdkl95/easy_mplayer"
+    gem.authors = ["Brent Sanders"]
+    gem.add_runtime_dependency "color_debug_messages", ">= 1.1.2"
+    gem.add_runtime_dependency "facets", ">= 2.8.0"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "easy_mplayer #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/easy_mplayer.gemspec

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{easy_mplayer}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Brent Sanders"]
+  s.date = %q{2010-01-05}
+  s.description = %q{A wrapper to manage mplayer, that supports callbacks to easyily support event-driven GUIs}
+  s.email = %q{gem-mplayer@thoughtnoise.net}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "easy_mplayer.gemspec",
+     "examples/basic.rb",
+     "examples/callbacks.rb",
+     "examples/inherit_class.rb",
+     "examples/minimal.rb",
+     "lib/easy_mplayer.rb",
+     "lib/easy_mplayer/callback.rb",
+     "lib/easy_mplayer/commands.rb",
+     "lib/easy_mplayer/errors.rb",
+     "lib/easy_mplayer/helpers.rb",
+     "lib/easy_mplayer/main.rb",
+     "lib/easy_mplayer/worker.rb"
+  ]
+  s.homepage = %q{http://github.com/pdkl95/easy_mplayer}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Wrapper to launch and control MPlayer}
+  s.test_files = [
+    "examples/minimal.rb",
+     "examples/basic.rb",
+     "examples/inherit_class.rb",
+     "examples/callbacks.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<color_debug_messages>, [">= 1.1.2"])
+      s.add_runtime_dependency(%q<facets>, [">= 2.8.0"])
+    else
+      s.add_dependency(%q<color_debug_messages>, [">= 1.1.2"])
+      s.add_dependency(%q<facets>, [">= 2.8.0"])
+    end
+  else
+    s.add_dependency(%q<color_debug_messages>, [">= 1.1.2"])
+    s.add_dependency(%q<facets>, [">= 2.8.0"])
+  end
+end
+

data/examples/basic.rb

@@ -0,0 +1,66 @@
+#!/bin/env ruby
+
+require 'pathname'
+$LOAD_PATH << File.join(File.dirname(Pathname.new(__FILE__).realpath),'../lib')
+require 'easy_mplayer'
+
+# play a file from the command line
+raise "usage: #{$0} <file>" if ARGV.length != 1
+$file = ARGV[0]
+
+#
+# This walks through some of the basic commands to
+# control already-playing media
+#
+
+def show(msg)
+  puts 'EXAMPLE<basic> ' + msg
+end
+
+def command(msg)
+  show "2"
+  sleep 1
+  show "1"
+  sleep 1
+  show "Command( #{msg} )"
+  yield
+end
+
+show "Create the player object for: #{$file}"
+mplayer = MPlayer.new( :path => $file )
+
+show "Spawning the mplayer process!"
+mplayer.play
+
+# set this true to see various basic commands
+# set it false to see the basic "wait until the file is done" check
+show_basic_commands = true
+
+if show_basic_commands
+  command "pause" do
+    mplayer.pause
+  end
+
+  command "pause (again, to resume)" do
+    mplayer.unpause
+  end
+
+  command "seek to 25%" do
+    mplayer.seek_to_percent 25.0
+  end
+
+  command "seek back to 10%" do
+    mplayer.seek_to_percent 10.0
+  end
+
+  command "stop" do
+    mplayer.stop
+  end
+  
+else
+  show "Waiting for the file to finish..."
+  sleep 1 while mplayer.playing?
+end
+
+
+show "All done!"

data/examples/callbacks.rb

@@ -0,0 +1,98 @@
+#!/bin/env ruby
+
+require 'pathname'
+$LOAD_PATH << File.join(File.dirname(Pathname.new(__FILE__).realpath),'../lib')
+require 'easy_mplayer'
+
+#
+# a more full-featured script, that gives basic pause/ff/rw support,
+# and reports various statistics by the callback mechanism
+#
+
+class MyApp
+  def show(msg)
+    puts 'EXAMPLE<callbacks> ' + msg
+  end
+
+  def process_key(key)
+    case key
+    when 'q', 'Q' then @mplayer.stop
+    when " "      then @mplayer.pause_or_unpause
+    when "\e[A"   then @mplayer.seek_forward(60)     #    UP arrow
+    when "\e[B"   then @mplayer.seek_reverse(60)     #  DOWN arrow
+    when "\e[C"   then @mplayer.seek_forward         # RIGHT arrow
+    when "\e[D"   then @mplayer.seek_reverse         #  LEFT arrow
+    end
+  end
+
+  def read_keys
+    x = IO.select([$stdin], nil, nil, 0.1)
+    return if !x or x.empty?
+    @key ||= ''
+    @key << $stdin.read(1)
+    if @key[0,1] != "\e" or @key.length >= 3
+      process_key(@key)
+      @key = ''
+    end
+  end
+
+  def run!
+    begin
+      @mplayer.play
+      
+      tty_state = `stty -g`
+      system "stty cbreak -echo"  
+      read_keys while @mplayer.running?
+    ensure
+      system "stty #{tty_state}"
+    end
+  end
+  
+  def initialize(file)
+    @mplayer = MPlayer.new( :path => file )
+
+    @mplayer.callback :audio_stats do
+      show "Audio is: "
+      show "  ->    sample_rate: #{@mplayer.stats[:audio_sample_rate]} Hz"
+      show "  -> audio_channels: #{@mplayer.stats[:audio_channels]}"
+      show "  ->   audio_format: #{@mplayer.stats[:audio_format]}"
+      show "  ->      data_rate: #{@mplayer.stats[:audio_data_rate]} kb/s"
+    end
+    
+    @mplayer.callback :video_stats do
+      show "Video is: "
+      show "  -> fourCC: #{@mplayer.stats[:video_fourcc]}"
+      show "  -> x_size: #{@mplayer.stats[:video_x_size]}"
+      show "  -> y_size: #{@mplayer.stats[:video_y_size]}"
+      show "  ->    bpp: #{@mplayer.stats[:video_bpp]}"
+      show "  ->    fps: #{@mplayer.stats[:video_fps]}"
+    end
+
+    @mplayer.callback :position do |position|
+      show "Song position percent: #{position}%"
+    end
+
+    @mplayer.callback :played_seconds do |val|
+      total  = @mplayer.stats[:total_time]
+      show "song position in seconds: #{val} / #{total}"
+    end
+
+    @mplayer.callback :pause, :unpause do |pause_state|
+      show "song state: " + (pause_state ? "PAUSED!" : "RESUMED!")
+    end
+
+    @mplayer.callback :play do
+      show "song started!"
+    end
+
+    @mplayer.callback :stop do
+      show "song ended!"
+      puts "final stats were: #{@mplayer.stats.inspect}"
+    end
+  end
+end
+
+# play a file from the command line
+raise "usage: #{$0} <file>" if ARGV.length != 1
+
+MyApp.new(ARGV[0]).run!

data/examples/inherit_class.rb

@@ -0,0 +1,98 @@
+#!/bin/env ruby
+
+require 'pathname'
+$LOAD_PATH << File.join(File.dirname(Pathname.new(__FILE__).realpath),'../lib')
+require 'easy_mplayer'
+
+#
+# This version derrives directly from the MPlayer class, which makes
+# the adding of callbacks easier.
+#
+
+class MyApp < MPlayer
+  def show(msg)
+    puts 'EXAMPLE<callbacks> ' + msg
+  end
+
+  def process_key(key)
+    case key
+    when 'q', 'Q' then stop
+    when " "      then pause_or_unpause
+    when "\e[A"   then seek_forward(60)     #    UP arrow
+    when "\e[B"   then seek_reverse(60)     #  DOWN arrow
+    when "\e[C"   then seek_forward         # RIGHT arrow
+    when "\e[D"   then seek_reverse         #  LEFT arrow
+    end
+  end
+
+  def read_keys
+    x = IO.select([$stdin], nil, nil, 0.1)
+    return if !x or x.empty?
+    @key ||= ''
+    @key << $stdin.read(1)
+    if @key[0,1] != "\e" or @key.length >= 3
+      process_key(@key)
+      @key = ''
+    end
+  end
+
+  def run!
+    begin
+      play
+      
+      tty_state = `stty -g`
+      system "stty cbreak -echo"  
+      read_keys while running?
+    ensure
+      system "stty #{tty_state}"
+    end
+  end
+  
+  def initialize(file)
+    super( :path => file )
+  end
+  
+  callback :audio_stats do
+    show "Audio is: "
+    show "  ->    sample_rate: #{stats[:audio_sample_rate]} Hz"
+    show "  -> audio_channels: #{stats[:audio_channels]}"
+    show "  ->   audio_format: #{stats[:audio_format]}"
+    show "  ->      data_rate: #{stats[:audio_data_rate]} kb/s"
+  end
+
+  callback :video_stats do
+    show "Video is: "
+    show "  -> fourCC: #{stats[:video_fourcc]}"
+    show "  -> x_size: #{stats[:video_x_size]}"
+    show "  -> y_size: #{stats[:video_y_size]}"
+    show "  ->    bpp: #{stats[:video_bpp]}"
+    show "  ->    fps: #{stats[:video_fps]}"
+  end
+
+  callback :position do |position|
+    show "Song position percent: #{position}%"
+  end
+
+  callback :played_seconds do |val|
+    total  = stats[:total_time]
+    show "song position in seconds: #{val} / #{total}"
+  end
+
+  callback :pause, :unpause do |pause_state|
+    show "song state: " + (pause_state ? "PAUSED!" : "RESUMED!")
+  end
+
+  callback :play do
+    show "song started!"
+  end
+
+  callback :stop do
+    show "song ended!"
+    puts "final stats were: #{stats.inspect}"
+  end
+end
+
+# play a file from the command line
+raise "usage: #{$0} <file>" if ARGV.length != 1
+
+MyApp.new(ARGV[0]).run!

data/examples/minimal.rb

@@ -0,0 +1,15 @@
+#!/bin/env ruby
+
+require 'pathname'
+$LOAD_PATH << File.join(File.dirname(Pathname.new(__FILE__).realpath),'../lib')
+require 'easy_mplayer'
+
+# play a file from the command line
+raise "usage: #{$0} <file>" if ARGV.length != 1
+
+# the absolute minimal script. Just hand over everything
+# to mplayer, blocking until it's over
+mplayer = MPlayer.new( :path => ARGV[0] )
+mplayer.play_to_end
+
+puts "all done!"

data/lib/easy_mplayer.rb

@@ -0,0 +1,17 @@
+require 'color_debug_messages'
+require 'open3'
+require 'facets/kernel/returning'
+require 'facets/kernel/meta_class'
+require 'facets/kernel/meta_def'
+
+class MPlayer
+  include ColorDebugMessages
+end
+
+require 'easy_mplayer/errors'
+require 'easy_mplayer/commands'
+require 'easy_mplayer/callback'
+require 'easy_mplayer/worker'
+require 'easy_mplayer/main'
+require 'easy_mplayer/helpers'
+