Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arirusso/midi-message
Ruby MIDI message objects
https://github.com/arirusso/midi-message
midi midi-messages music parsing ruby sysex-messages
Last synced: about 1 month ago
JSON representation
Ruby MIDI message objects
- Host: GitHub
- URL: https://github.com/arirusso/midi-message
- Owner: arirusso
- License: other
- Created: 2011-04-20T00:42:04.000Z (over 13 years ago)
- Default Branch: main
- Last Pushed: 2022-02-22T02:37:18.000Z (almost 3 years ago)
- Last Synced: 2024-04-24T13:17:53.050Z (8 months ago)
- Topics: midi, midi-messages, music, parsing, ruby, sysex-messages
- Language: Ruby
- Homepage:
- Size: 220 KB
- Stars: 19
- Watchers: 5
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MIDI Message
Ruby MIDI message objects
## Features
* Flexible API to accommodate various sources and destinations of MIDI data
* Simple approach to System Exclusive data and devices
* [YAML dictionary of MIDI constants](https://github.com/arirusso/midi-message/blob/master/lib/midi.yml)
## Install
`gem install midi-message`
Or if you're using Bundler, add this to your Gemfile
`gem "midi-message"`
## Usage
```ruby
require "midi-message"
```
#### Basic Messages
There are a few ways to create a new MIDI message. Here are some examples
```ruby
MIDIMessage::NoteOn.new(0, 64, 64)
MIDIMessage::NoteOn["E4"].new(0, 100)
MIDIMessage.with(:channel => 0, :velocity => 100) { note_on("E4") }
```
Those expressions all evaluate to the same object
```ruby
#
```
#### SysEx Messages
As with any kind of message, you can begin with raw data
```ruby
MIDIMessage::SystemExclusive.new(0xF0, 0x41, 0x10, 0x42, 0x12, 0x40, 0x00, 0x7F, 0x00, 0x41, 0xF7)
```
Or in a more object oriented way
```ruby
synth = SystemExclusive::Node.new(0x41, :model_id => 0x42, :device_id => 0x10)
SystemExclusive::Command.new([0x40, 0x7F, 0x00], 0x00, :node => synth)
```
A Node represents a device that you're sending a message to (eg. your Yamaha DX7 is a Node). Sysex messages can either be a Command or Request
You can use the Node to instantiate a message
```ruby
synth.command([0x40, 0x7F, 0x00], 0x00)
```
One way or another, you will wind up with a pair of objects like this
```ruby
#>
```
#### Parsing
The parse method will take any valid message data and return the object representation
```ruby
MIDIMessage.parse(0x90, 0x40, 0x40)
#
MIDIMessage.parse(0xF0, 0x41, 0x10, 0x42, 0x12, 0x40, 0x00, 0x7F, 0x00, 0x41, 0xF7)
#
```
Check out [nibbler](http://github.com/arirusso/nibbler) for more advanced parsing
## Documentation
* [rdoc](http://rubydoc.info/github/arirusso/midi-message)
## Author
* [Ari Russo](http://github.com/arirusso)
## License
Apache 2.0, See the file LICENSE
Copyright (c) 2011-2015 [Ari Russo](http://arirusso.com)