NAME

playumidi - play standard midi-file format 0/1 for FreeBSD USB-MIDI device (support Multi-Byte Language Text version)

SYNOPSIS

playumidi -[d0123rqvhlt] file

DESCRIPTION

"playumidi" is the "SIMPLE" MIDI file player for USB MIDI device on FreeBSD.
This software is able to direct control for FreeBSD-umidi device(/dev/umidi*.*) in the "uaudio" driver. Therefore, You don't need to use the "/dev/sequencer" device or the other software when listening the MIDI-file music.
And, Support for auto-judge MIDI-file XG/GS/GM mode & auto add the Tone-Generator ReSet code when the ReSet code isn't exist in a MIDI-file.

OPTIONS

The following options are available

-d device_name: Set the USB MIDI device name (Device Number & Port Number is auto-search) (If you want to use the "/dev/umidi0.0" device, you set "-d umidi". Don't set the Device Number & Port Number("0.0") )
playumidi use the midi device that the device directory is "/dev/<device_name>DeviceNumber.Number".
DEFAULT: "umidi"
-0 device_fullname: playumidi use the indicate device as the port-0 midi device.
Can't use the "-d"option same time. (When use both "-d" option and "-0/1/2/3"option, playumidi terminate process)
DEFAULT: "umidiX.0" (X is serarched by playumidi from 0 to 15.)
-1 device_fullname: playumidi use the indicate device as the port-1 midi device.
Can't use the "-d"option same time. (When use both "-d" option and "-0/1/2/3"option, playumidi terminate process)
DEFAULT: "umidiX.1" (X is serarched by playumidi from 0 to 15.)
-2 device_fullname: playumidi use the indicate device as the port-2 midi device.
Can't use the "-d"option same time. (When use both "-d" option and "-0/1/2/3"option, playumidi terminate process)
DEFAULT: "umidiX.2" (X is serarched by playumidi from 0 to 15.)
-3 device_fullname: playumidi use the indicate device as the port-3 midi device.
Can't use the "-d"option same time. (When use both "-d" option and "-0/1/2/3"option, playumidi terminate process)
DEFAULT: "umidiX.3" (X is serarched by playumidi from 0 to 15.)
-r: Disable Auto-Insert XG/GS/GM Reset code.
-q: Quiet Mode : Don't output the Meta-Event Text to the terminal stdout.
-v: Verbose Mode : Output the playumidi running status.
-h: Output Command-Line Help Message (Usage)
-l language_code: Setting the Text Language-Code of the MIDI-File MetaEvent TextCode.
The parameter "language_code" of Option -l is abilityto specify a value that is displayed in the command "iconv -l"
DEFAULT: SHIFT_JISX0213 (Japanese)
-t language_code: Setting the Output Text Language-Code for Terminal.
The parameter "language_code" of Option -t is abilityto specify a value that is displayed in the command "iconv -l"
DEFAULT: The string of the back than the "." of the environment variable LANG. If isn't setting the LANG variable, the default value is "EUC-JP".

PLAYING OPERATION

The following Playing-Operation are available

Ctrl + C Key: Stop playing music & Terminate playumidi.

NOTICE

playumidi directly opens, writes midi-event data, and closes the /dev/<usb-midi device>.
So, it is necessary to grant the R/W privileges(666) to /dev/<usb-midi device> before use playumidi.
Please see the README for details.

AUTHORS

Koine Yuusuke (koinec@users.sourceforge.jp)

LICENSE

playumidi presented by the "2-clause FreeBSD License".