Usage(English) - playumidi Wiki - playumidi

playumidi - Usage(English)

NAME

playumidi - play standard midi-file format 0/1 for FreeBSD USB-MIDI device

SYNOPSIS

playumidi [option] 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.

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.(DEBUG mode)"
• -h
  • Output Command-Line Help Message (Usage)
• -l language_code
  • Setting the Text Language-Code of the MIDI-File MetaEvent TextCode.
  • This option is enabled only when you build by giving the "-DWITH_ICONV" to make command.
  • The parameter "language_code" of Option -l & -t 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.
  • This option is enabled only when you build by giving the "-DWITH_ICONV" to make command.
  • The parameter "language_code" of Option -l & -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".

The following Playing-Operation are available

• "Ctrl + C" Key
  • Stop playing music & Terminate playumidi.

AUTHORS

Koine Yuusuke ([e-mail])

LICENSE

playumidi presented by the "FreeBSD License".

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY Koine Yuusuke(koinec) ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL Koine Yuusuke(koinec) OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.