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
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request