Poster of Linux kernelThe best gift for a Linux geek
MIDISTREAM

MIDISTREAM

Section: User Commands (1) Updated: July 2010
Local index Up
 

NAME

midistream - Streams MIDI notes and controls over RTP  

SYNOPSIS

midistream

 

DESCRIPTION

Can be used as a sender or a receiver. Can also list available ALSA MIDI ports.

Creates a MIDI RTP stream between two hosts, uni or bi-directionnal.  

OPTIONS

--version
show program's version number and exit
-h, --help
show this help message and exit
-a ADDRESS, --address=ADDRESS
Specify the address of the peer (mandatory)
-l, --list-devices
Show a complete list of midi devices
-s SENDING_PORT, --sending-port=SENDING_PORT
Select the sending port. Must be used the --inputdevice option.
-r RECEIVING_PORT, --receiving-port=RECEIVING_PORT
Select the listening port. Must be used the --outputdevice option.
-o OUTPUT_DEVICE, --output-device=OUTPUT_DEVICE
Select a midi output device. (sink) Must be used with the --receiving-port option.
-i INPUT_DEVICE, --input-device=INPUT_DEVICE
Select a midi input device. (source) Must be used with the --sending-port option.
-L LATENCY, --latency=LATENCY
Specify the latency (in ms) of the midi out device (default is 20)
-b JITTER_BUFFER, --jitter-buffer=JITTER_BUFFER
Specify the jitter buffer size in ms (default is 10)
-k, --safe-keyboard
Take care of note ON/OFF alternating, useful if several notes in a ms (experimental)
-j, --disable-recovery-journal
DISABLE recovery journal (journal provide note recovery when a packet is lost, so at your own risks!)
-f, --follow-standard
Take care of MIDI standard (ex: omni on) in recovery journal (experimental)
-v, --verbose
Enables a verbose output

Example: midistream -a 10.0.1.29 -r 44000 -s 44000 -i 1 -o 0 This command creates a bi-directional connection with 10.0.1.29 on port 44000, midi device 1 is the source for sending data, and all received data are sent to midi device 0. Caution: If the stream is bi-directionnal receiving port and sending port must be equal.  

EXAMPLES

Let say we want to stream MIDI data from host 10.10.10.80 to host 10.10.10.65. We first need to plug our input MIDI device on the first computer, and to choose an output MIDI device on the second computer. We can list the MIDI devices on each computer using the following command:


  midistream --list-devices

This way, you know the number of the MIDI device to use on each host. The next step is to know the IP address of each host. The ifconfig command can help you with that. Finally, start the sender on the first computer, and the receiver on the second.

On the first host, start the sender:


  midistream -a 10.10.10.65 -i 3 -s 10000 -v

On the second host, start the receiver:


  midistream -a 10.10.10.80 -o 0 -r 10000 -v  

AUTHOR

Antoine Collet <antoine.collet@gmail.com> Alexandre Quessy <alexandre@quessy.net> Tristan Matthews <tristan@sat.qc.ca>  

REPORTING BUGS

http://svn.sat.qc.ca/trac/scenic  

COPYRIGHT

Scenic Copyright (C) 2008 Society for Arts and Technology (SAT) http://www.sat.qc.ca All rights reserved.

This file is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

Scenic is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Scenic. If not, see <http://www.gnu.org/licenses/>.  

SEE ALSO

scenic(1), milhouse(1), firereset(1), dc-ctl(1), jack-info(1), /usr/share/scenic/docbook


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
AUTHOR
REPORTING BUGS
COPYRIGHT
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:23:53 GMT, April 16, 2011