itunes-client provides a high level API (like ActiveRecord style) to control your iTunes.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
scripts
spec
.coveralls.yml
.gitignore
.rspec
.ruby-version
.tachikoma.yml
.travis.yml
Gemfile
Guardfile
LICENSE.txt
README.md
Rakefile
itunes-client.gemspec

README.md

itunes-client Build Status Coverage Status

itunes-client provides a high level API (like ActiveRecord style) to control your iTunes.

Installation

Add this line to your application's Gemfile:

gem 'itunes-client'

And then execute:

$ bundle

Or install it yourself as:

$ gem install itunes-client

Supported OS

  • OSX Yosemite
  • OSX Mavericks

Supported Ruby

  • 2.2
  • 2.1
  • 2.0

Usage

require 'itunes-client'
include Itunes

# Add a track to player
track = Itunes::Player.add(path_to_your_sound_file)

# Convert by default encoder
encoded_track = track.convert

# Find all tracks
tracks = Track.find_by(name: "Hello, Goodbye")
# => [#<Itunes::Track:0x007fdd38a1d430 @persistent_id="571B6412CDADBC93", @name="Hello, Goodbye", @album="1", @artist="The Beatles", @track_count="27", @track_number="19">]

track = tracks.first

# Play track
track.play

# Stop track
track.stop

# Control volume
volume = Itunes::Volume

# Decrease and increase the volume
volume.down(20)
volume.down      # default 10
volume.up(20)
volume.up       # default 10

# Mute and unmute the volume
volume.mute
volume.unmute

# Return volume value
volume.value

License

itunes-client is released under the MIT License.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Bitdeli Badge