https://github.com/arirusso/mmplayer
Control MPlayer with MIDI
https://github.com/arirusso/mmplayer
Last synced: about 1 year ago
JSON representation
Control MPlayer with MIDI
- Host: GitHub
- URL: https://github.com/arirusso/mmplayer
- Owner: arirusso
- License: other
- Created: 2015-04-21T01:20:09.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-06-08T21:01:29.000Z (about 9 years ago)
- Last Synced: 2025-06-17T10:55:37.280Z (about 1 year ago)
- Language: Ruby
- Size: 74.2 KB
- Stars: 6
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mmplayer
Control [MPlayer](http://en.wikipedia.org/wiki/MPlayer) with MIDI
MPlayer is a free, cross-platform, command-line driven, highly configurable, (often) GUI-less open-source media player.
Enabling MPlayer to be controlled by MIDI opens up a host of possibilities for live video performance, media automation and more
This project provides a Ruby DSL to define realtime interactions between MIDI input and MPlayer
## Install
You'll need to install MPlayer before using this. That can usually be accomplished with a package manager eg `brew install mplayer` depending on what OS you're using.
This project itself can be installed as a Ruby Gem using
`gem install mmplayer`
Or if you're using Bundler, add this to your Gemfile
`gem "mmplayer"`
## Usage
```ruby
require "mmplayer"
@input = UniMIDI::Input.gets
@player = MMPlayer.new(@input, :mplayer_flags => "-fs") do
rx_channel 0
system(:start) { play("1.mov") }
note(1) { play("2.mov") }
note("C2") { play("3.mov") }
cc(1) { |value| volume(:set, value) }
cc(20) { |value| seek(to_percent(value), :percent) }
eof { puts "finished" }
end
@player.start
```
An annotated breakdown of this example can be found [here](https://github.com/arirusso/mmplayer/blob/master/examples/simple.rb)
[The MPlayer Man Page](http://www.mplayerhq.hu/DOCS/man/en/mplayer.1.html#GENERAL%20OPTIONS) has a full list of MPlayer startup flags
All MPlayer runtime commands enabled by the [mplayer-ruby](https://rubygems.org/gems/mplayer-ruby) project are available here too. (eg `seek` and `volume` in the example above). [The RDOC for mplayer-ruby](http://mplayer-ruby.rubyforge.org/mplayer-ruby/index.html) has a full list of runtime commands
## License
Apache 2.0, See LICENSE file
Copyright (c) 2015-2017 [Ari Russo](http://arirusso.com)