ruby-mpris 0.1.0

data/COPYING

@@ -0,0 +1,56 @@
+ruby-mpris is copyrighted free software by Nicholas J Humfrey <njh@aelius.com>.
+You can redistribute it and/or modify it under either the terms of the GPL
+version 2 (see the file GPL), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or binary form,
+     provided that you do at least ONE of the following:
+
+       a) distribute the binaries and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     file LEGAL.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.

data/NEWS

@@ -0,0 +1,2 @@
+Version 0.1.0 (2008-04-27)
+  * Initial Release.

data/README

@@ -0,0 +1,35 @@
+== ruby-mpris
+
+The ruby-mpris gem allows you to control media players that follow the MPRIS specification.
+
+RubyForge Project Page  http://rubyforge.org/projects/mpris/
+
+== Dependancies
+
+ruby-dbus performs all the hard work behind the scenes. You can download it from: http://trac.luon.net/ruby-dbus/
+
+== Installing
+
+You may get the latest stable version from Rubyforge. Source gems are also available.
+
+  $ gem install mpris
+
+=== Loading ruby-mpris gem Itself
+
+You have installed the gem already, yeah?
+
+ require 'rubygems'
+ require 'mpris'
+
+
+== Resources
+
+http://www.mpris.org
+
+== Contact
+
+Author::     Nicholas J Humfrey
+Email::      njh@aelius.com 
+Home Page::  http://www.aelius.com/njh/
+License::    Distributes under the same terms as Ruby
+

data/Rakefile

@@ -0,0 +1,87 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+NAME = "ruby-mpris"
+VERS = "0.1.0"
+CLEAN.include ['pkg', 'rdoc']
+
+Gem::manage_gems
+
+spec = Gem::Specification.new do |s|
+  s.name              = NAME
+  s.version           = VERS
+  s.author            = "Nicholas J Humfrey"
+  s.email             = "njh@aelius.com"
+  s.homepage          = "http://mpris.rubyforge.org"
+  s.platform          = Gem::Platform::RUBY
+  s.summary           = "A library to control MPRIS based Media Players" 
+  s.rubyforge_project = "mpris" 
+  s.description       = "The mpris gem allows you to control media players that follow the MPRIS specification."
+  s.files             = FileList["Rakefile", "lib/mpris.rb", "lib/mpris/*", "examples/*"]
+  s.require_path      = "lib"
+  
+  # rdoc
+  s.has_rdoc          = true
+  s.extra_rdoc_files  = ["README", "NEWS", "COPYING"]
+  
+  # Dependencies
+  #s.add_dependency "ruby-dbus"   - sadly ruby-dbus isn't avilable as a gem
+  s.add_dependency "rake"
+end
+
+desc "Default: package up the gem."
+task :default => :package
+
+task :build_package => [:repackage]
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = false
+  pkg.need_tar = true
+  pkg.gem_spec = spec
+end
+
+desc "Run :package and install the resulting .gem"
+task :install => :package do
+  sh %{sudo gem install --local pkg/#{NAME}-#{VERS}.gem}
+end
+
+desc "Run :clean and uninstall the .gem"
+task :uninstall => :clean do
+  sh %{sudo gem uninstall #{NAME}}
+end
+
+
+
+## Testing
+#desc "Run all the specification tests"
+#Rake::TestTask.new(:spec) do |t|
+#  t.warning = true
+#  t.verbose = true
+#  t.pattern = 'spec/*_spec.rb'
+#end
+  
+desc "Check the syntax of all ruby files"
+task :check_syntax do
+  `find . -name "*.rb" |xargs -n1 ruby -c |grep -v "Syntax OK"`
+  puts "* Done"
+end
+
+
+
+## Documentation
+desc "Generate documentation for the library"
+Rake::RDocTask.new("rdoc") { |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = "ruby-mpris Documentation"
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.main = "README"
+  rdoc.rdoc_files.include("README", "NEWS", "COPYING", "lib/mpris.rb", "lib/mpris/*.rb")
+}
+
+desc "Upload rdoc to rubyforge"
+task :upload_rdoc => [:rdoc] do
+  sh %{/usr/bin/scp -r -p rdoc/* mpris.rubyforge.org:/var/www/gforge-projects/mpris}
+end

data/examples/capabilities_test.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby
+#
+# Script to display the cababilites of the media player.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+  
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'mpris'
+
+
+mpris = Mpris.new
+puts "Checking capabilites:"
+puts " can_go_next?: #{mpris.player.can_go_next?}"
+puts " can_go_prev?: #{mpris.player.can_go_prev?}"
+puts " can_pause?: #{mpris.player.can_pause?}"
+puts " can_play?: #{mpris.player.can_play?}"
+puts " can_seek?: #{mpris.player.can_seek?}"
+puts " can_provide_metadata?: #{mpris.player.can_provide_metadata?}"
+puts " has_tracklist?: #{mpris.player.has_tracklist?}"

data/examples/identify.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby
+#
+# Script to display name of the media player and supported MPRIS API version.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'mpris'
+
+
+mpris = Mpris.new
+puts "Identity: #{mpris.identity}"
+puts "MPRIS API Version: #{mpris.mpris_version}"

data/examples/metadata.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby
+#
+# Script to display the metadata hash for the currently playing track.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'mpris'
+require 'pp'
+
+mpris = Mpris.new
+pp mpris.player.metadata

data/examples/play_track.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby
+#
+# Script to immediately start playing a track in the media player.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'mpris'
+
+raise "Usage: play_track.rb <filename>" unless (ARGV.size == 1)
+
+mpris = Mpris.new
+mpris.tracklist.add_track( ARGV[0], true )

data/examples/playerkeys.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby
+#
+# Interactive console script to control the media player.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'rubygems'
+require 'highline'
+require 'mpris'
+
+
+mpris = Mpris.new
+
+puts "p:play space:pause s:stop [:prev ]:next q:quit"
+puts "+:volume_up -:volume_down x:exit"
+
+begin
+  c = HighLine::SystemExtensions::get_character
+
+  case c
+    when 112 then
+      puts "Play"
+      mpris.player.play
+    when 113 then
+      puts "Quit"
+      mpris.quit
+    when 32 then
+      puts "Pause"
+      mpris.player.pause
+    when 115 then
+      puts "Stop"
+      mpris.player.stop
+    when 91 then
+      puts "Previous"
+      mpris.player.previous
+    when 93 then
+      puts "Next"
+      mpris.player.next
+    when 43 then
+      vol = mpris.player.volume+5
+      puts "Volume Up (#{vol})"
+      mpris.player.volume = vol
+    when 45 then
+      vol = mpris.player.volume-5
+      puts "Volume Down (#{vol})"
+      mpris.player.volume = vol
+    when 114 then
+      repeat = !mpris.player.repeat
+      puts "Repeat=#{repeat}"
+      mpris.player.repeat = repeat
+    else
+      puts "Unhandled key press: #{c}"
+   end
+    
+end until (c == 120)

data/examples/status_test.rb

@@ -0,0 +1,57 @@
+#!/usr/bin/ruby
+#
+# Script to test the repeat/loop/random getters and setters.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'mpris'
+
+
+mpris = Mpris.new
+
+
+puts "Enabling looping."
+mpris.tracklist.loop = true
+puts " Looping status: #{mpris.tracklist.loop}"
+
+puts "Disabling looping."
+mpris.tracklist.loop = false
+puts " Looping status: #{mpris.tracklist.loop}"
+
+puts "Enabling random."
+mpris.tracklist.random = true
+puts " Random status: #{mpris.tracklist.random}"
+
+puts "Disabling random."
+mpris.tracklist.random = false
+puts " Random status: #{mpris.tracklist.random}"
+
+puts "Enabling repeating."
+mpris.player.repeat = true
+puts " Looping status: #{mpris.player.repeat}"
+
+puts "Disabling repeating."
+mpris.player.repeat = false
+puts " Looping status: #{mpris.player.repeat}"
+
+
+puts "Stopping playback..."
+mpris.player.stop
+puts " Mpris::Player::STOPPED: #{Mpris::Player::STOPPED}"
+puts " Playback status: #{mpris.player.status}"
+
+puts "Starting playback..."
+mpris.player.play
+puts " Mpris::Player::PLAYING: #{Mpris::Player::PLAYING}"
+puts " Playback status: #{mpris.player.status}"
+
+# Current crashes VLC:
+#puts "Pausing playback..."
+#mpris.player.pause
+#puts " Mpris::Player::PAUSED: #{Mpris::Player::PAUSED}"
+#puts " Playback status: #{mpris.player.status}"

data/examples/tracklist.rb

@@ -0,0 +1,42 @@
+#!/usr/bin/ruby
+#
+# Script to display the URI, artist and title for the tracks on the tracklist.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'mpris'
+
+mpris = Mpris.new
+
+# Get the number of tracks on the tracklist
+len = mpris.tracklist.length
+if (len <= 0)
+  puts "There are no tracks on the tracklist."
+
+else 
+
+  # Get the number of the currently playing track
+  current = mpris.tracklist.current_track
+  
+  i=0
+  while (i<len) do
+  
+    # Print asterisk next to currently playing track
+    if (i==current)
+      print "* "
+    else
+      print "  "
+    end
+    
+    # There is a bug in VLC, which makes tracklist start at 1
+    meta = mpris.tracklist.metadata(i+1)
+    puts "#{i}: #{meta['URI']} (#{meta['artist']} - #{meta['title']})"
+    i+=1
+  end
+
+end

data/examples/volume_test.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby
+#
+# Script to test getting/setting the playback volume of the media player.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+$:.unshift File.dirname(__FILE__)+'/../lib'
+
+require 'mpris'
+
+
+mpris = Mpris.new
+
+# Test to set and get the playback volume of the media player
+for vol_in in 0..150
+  mpris.player.volume = vol_in
+  vol_out = mpris.player.volume
+  puts "Setting volume to: #{vol_in}, got back: #{vol_out}."
+end

data/lib/mpris/player.rb

@@ -0,0 +1,166 @@
+#!/usr/bin/ruby
+#
+# MPRIS is the Media Player Remote Interfacing Specification.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+class Mpris
+
+  # This class represents the player itself.
+  class Player
+  
+    PLAYING = 0
+    PAUSED = 1
+    STOPPED = 2
+    
+    # A player object should only be created directly by its parent Mpris
+    def initialize( service, parent ) #:nodoc:
+      @service = service
+      @parent = parent
+    
+      # Check the service implements the MediaPlayer interface
+      object = @service.object("/Player")
+      object.introspect
+      unless object.has_iface? Mpris::MPRIS_INTERFACE
+        raise(Mpris::InterfaceNotImplementedException, 
+          "#{service_name} does not implement the MediaPlayer interface on /.")
+      end
+      @interface = object[Mpris::MPRIS_INTERFACE]
+    end
+    
+    
+    # Goes to the next item in the TrackList.
+    def next
+      @interface.Next
+    end
+    
+    # Goes to the previous item in the TrackList.
+    def previous
+      @interface.Prev
+    end
+    
+    # If playing�: pause. If paused�: unpause.
+    def pause
+      @interface.Pause
+    end
+    
+    # Stop playback.
+    def stop
+      @interface.Stop
+    end
+    
+    # If playing�: rewind to the beginning of current track, else�: start playing.
+    def play
+      @interface.Play
+    end
+    
+    # Gives all metadata available for the current item.
+    # Metadata is returned as key,values pairs in a Hash.
+    def metadata
+      return @interface.GetMetadata.first
+    end
+    
+    # Toggle the current track repeat.
+    # true to repeat the current track, false to stop repeating.
+    def repeat=(bool)
+      @interface.Repeat(bool)
+    end
+    
+    # Returns the current repeat status.
+    #
+    #  true: repeat the current element.
+    #  false: go to the next element once the current has finished playing.
+    def repeat
+      # Thrid integer in array is repeat status
+      return @interface.GetStatus.first[2] == 1
+    end
+    
+    # Return the playing status of "Media Player".
+    # Mpris::Player::PLAYING / Mpris::Player::PAUSED / Mpris::Player::STOPPED
+    def status
+      return @interface.GetStatus.first[0]
+    end
+    
+    # Check if there is a next track, or at least something that equals to it 
+    # (that is, the remote can call the 'Next' method on the interface, and 
+    # expect something to happen.
+    def can_go_next?
+      return capability(0)
+    end
+    
+    # Check if there is a previous track.
+    def can_go_prev?
+      return capability(1)
+    end
+    
+    # Check if it is possible to pause. This might not always be possible, 
+    # and is a hint for frontends as to what to indicate.
+    def can_pause?
+      return capability(2)
+    end
+    
+    # Whether playback can currently be started. This might not be the case 
+    # if e.g. the playlist is empty in a player, or similar conditions.
+    def can_play?
+      return capability(3)
+    end
+    
+    # Whether seeking is possible with the currently played stream.
+    def can_seek?
+      return capability(4)
+    end
+    
+    # Whether metadata can be acquired for the currently played stream/source.
+    def can_provide_metadata?
+      return capability(5)
+    end
+    
+    # Whether the media player can hold a list of several items.
+    def has_tracklist?
+      return capability(6)
+    end
+    
+    # Sets the volume (argument must be in [0;100])
+    def volume=(vol)
+      vol = vol.to_i
+      raise(ArgumentError,"Volume cannot be negative") if (vol<0)
+      @interface.VolumeSet(vol)
+    end
+    
+    # Returns the current volume (must be in [0;100])
+    def volume
+      return @interface.VolumeGet.first
+    end
+    
+    # Sets the playing position (argument must be in [0;<track_length>] 
+    # in milliseconds)
+    def position=(time)
+      time = time.to_i
+      raise(ArgumentError,"Position cannot be negative") if (time<0)
+      @interface.PositionSet(time)
+    end
+    
+    # Returns the playing position (will be [0;<track_length>] in milliseconds).
+    def position
+      return @interface.PositionGet.first
+    end
+  
+    private
+
+    # Hack so that tracklist can access our interface
+    def interface
+      return @interface
+    end
+    
+    # Return the specified bit value from the capabilties bitfield
+    def capability(bit)
+      # FIXME: cache capabilities (for a short period)
+      return ((@interface.GetCaps.first >> bit) & 0x01) == 0x01
+    end
+
+  end
+
+end

data/lib/mpris/tracklist.rb

@@ -0,0 +1,100 @@
+#!/usr/bin/ruby
+#
+# MPRIS is the Media Player Remote Interfacing Specification.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+class Mpris
+
+  # This class represents the Media Player's tracklist.
+  #
+  # Note that if player.has_tracklist? is false, the methods described below
+  # will be implemented as no-ops, except metadata (which is valid only if given 
+  # argument is 0), current_track (which always returns 0), 
+  # length (which will return 0 or 1), and add_track.
+  #
+  class TrackList
+  
+    # A tracklist object should only be created directly by its parent Mpris
+    def initialize( service, parent ) #:nodoc:
+      @service = service
+      @parent = parent
+    
+      # Check the service implements the MediaPlayer interface
+      object = @service.object("/TrackList")
+      object.introspect
+      unless object.has_iface? Mpris::MPRIS_INTERFACE
+        raise(Mpris::InterfaceNotImplementedException, 
+          "#{service_name} does not implement the MediaPlayer interface on /.")
+      end
+      @interface = object[Mpris::MPRIS_INTERFACE]
+    end
+    
+    # Gives all metadata available for item at given position in the TrackList, counting from 0.
+    # 
+    # Metadata is returned as key,values pairs in a Hash
+    #
+    # The pos argument is the position in the TrackList of the item of which the metadata is requested.
+    def metadata(pos)
+      return @interface.GetMetadata(pos).first
+    end
+  
+    # Return the position of current URI in the TrackList The return value is zero-based, 
+    # so the position of the first URI in the TrackList is 0. The behavior of this method is 
+    # unspecified if there are zero items in the TrackList.
+    def current_track
+      return @interface.GetCurrentTrack.first
+    end
+  
+    # Returns the number of items in the TrackList.
+    def length
+      return @interface.GetLength.first
+    end
+  
+    # Appends an URI in the TrackList.
+    #
+    # Returns 0 if successful
+    def add_track(uri,play_immediately=false)
+      @interface.AddTrack(uri,play_immediately)
+    end
+  
+    # Removes an URI from the TrackList.
+    #
+    # pos is the position in the tracklist of the item to remove.
+    def delete_track(pos)
+      @interface.DeleteTrack(pos)
+    end
+  
+    # Set the tracklist looping status. true to loop, false to stop looping.
+    def loop=(bool)
+      @interface.SetLoop(bool)
+    end
+    
+    # Returns tracklist looping status.
+    def loop
+      # Hack to get the player interface
+      player_iface = @parent.player.send(:interface)
+      # Fourth integrer in array is the looping status
+      return player_iface.GetStatus.first[3] #== 1
+    end
+  
+    # Set the tracklist shuffle / random status. It may or may not play tracks only once.
+    # true to play randomly / shuffle tracklist, false to play normally / reorder tracklist.
+    def random=(bool)
+      @interface.SetRandom(bool)
+    end
+    
+    # Returns the tracklist shuffle / random status.
+    def random
+      # Hack to get the player interface
+      player_iface = @parent.player.send(:interface)
+      # Second integrer in array is the random status
+      return player_iface.GetStatus.first[1] #== 1
+    end
+
+  end
+
+end

data/lib/mpris.rb

@@ -0,0 +1,106 @@
+#!/usr/bin/ruby
+#
+# MPRIS is the Media Player Remote Interfacing Specification.
+#
+# Author::    Nicholas J Humfrey  (mailto:njh@aelius.com)
+# Copyright:: Copyright (c) 2008 Nicholas J Humfrey
+# License::   Distributes under the same terms as Ruby
+#
+
+require 'dbus'
+require 'mpris/player'
+require 'mpris/tracklist'
+
+
+# This is the base MPRIS class. It creates the #Player and #Tracklist objects 
+# automatically, which are accessible via the attribute readers.
+class Mpris
+  attr_reader :player
+  attr_reader :tracklist
+
+  MPRIS_SERVICE_PREFIX = 'org.mpris'
+  MPRIS_INTERFACE = 'org.freedesktop.MediaPlayer'
+  
+  # Create a new Mpris instance. 
+  # By default it will return the first MPRIS enabled player found 
+  # on the Session Bus.
+  #
+  # The dbus_address parameter can be use to specify a different dbus, for 
+  # example 'unix:path=/var/run/dbus_socket'.
+  #
+  # The service_name parameter can be used to specify a specifc MediaPlayer,
+  # for example 'org.mpris.vlc'.
+  def initialize( dbus_address=nil, service_name=nil )
+
+    # FIXME: support passing in a dbus object, instead of a dbus address
+    if dbus_address.nil?
+      # Use the default session bus
+      @dbus = DBus::SessionBus.instance
+    else
+      @dbus = DBus::Connection.new(dbus_address)
+      @dbus.connect
+      #self.send_hello
+    end
+    
+    # Look for service name, if one isn't given
+    if service_name.nil?
+      service_names = @dbus.proxy.ListNames[0]
+      service_names.each { |n|
+        if (n =~ /^org.mpris/)
+          service_name = n
+          break
+        end
+      }
+      
+      # Did we find one?
+      if service_name.nil?
+        raise( ServiceNotFoundException, "No MPRIS service found on D-Bus." )
+      end
+    end
+    
+    # Get the service
+    @service = @dbus.service(service_name)
+    
+    # Check the service implements the MediaPlayer interface
+    root_object = @service.object("/")
+    root_object.introspect
+    unless root_object.has_iface? MPRIS_INTERFACE
+      raise(InterfaceNotImplementedException, 
+        "#{service_name} does not implement the MediaPlayer interface on /." )
+    end
+    @interface = root_object[MPRIS_INTERFACE]
+    
+    # Create the player object
+    @player = Mpris::Player.new(@service, self)
+    
+    # Create a tracklist object
+    @tracklist = Mpris::TrackList.new(@service, self)
+  end
+
+  # Identify the "media player" as in "VLC 0.9.0", "bmpx 0.34.9", "Audacious 1.4.0" ...
+  #
+  # Returns a string containing the media player identification.
+  def identity
+    return @interface.Identity
+  end
+  
+  # Makes the "Media Player" exit.
+  def quit
+    @interface.Quit
+  end
+  
+  # Returns the version of the MPRIS spec being implemented as major.major
+  def mpris_version
+    return @interface.MprisVersion.first.join('.')
+  end
+ 
+ 
+  # Exception raised if no Mpris service is found on the D-Bus.
+  class ServiceNotFoundException < Exception
+  end
+ 
+  # Exception raised if MediaPlayer interface isn't implemented.
+  class InterfaceNotImplementedException < Exception
+  end
+
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: ruby-mpris
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Nicholas J Humfrey
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-04-27 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: The mpris gem allows you to control media players that follow the MPRIS specification.
+email: njh@aelius.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- NEWS
+- COPYING
+files: 
+- Rakefile
+- lib/mpris.rb
+- lib/mpris/player.rb
+- lib/mpris/tracklist.rb
+- examples/capabilities_test.rb
+- examples/identify.rb
+- examples/metadata.rb
+- examples/play_track.rb
+- examples/playerkeys.rb
+- examples/status_test.rb
+- examples/tracklist.rb
+- examples/volume_test.rb
+- README
+- NEWS
+- COPYING
+has_rdoc: true
+homepage: http://mpris.rubyforge.org
+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: mpris
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: A library to control MPRIS based Media Players
+test_files: []
+