home | help 
playumidi(1)		     General Commands Manual		    playumidi(1)

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  de-
     vice(/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  std-
	    out.

     -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  de-
     vice> 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".

								    playumidi(1)
home | help