0.02
No commit activity in last 3 years
No release in over 3 years
iTunes client with high level API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 0.7.1
~> 0.6.0
~> 1.0.3
~> 2.6.1
~> 4.3.1
~> 0.10.1
~> 10.3.2
~> 0.9.4
~> 3.1.0
~> 0.9.0
 Project Readme

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