** playumidi Install Manual **

[Introduction]--------------------------------------------------------------

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


[Requirement]---------------------------------------------------------------

 Please read README text file.


[Install]-------------------------------------------------------------------

 Please execute the following command as root user.

  1. Get playumidi tar-ball from sourceforge.jp & save your pc.

  2. Extract this tar-ball into directory of your choice.
              (Extract directory is called "INSTALL DIR" below).
        "tar xvfz playumidi_0.8.0.tar.gz"

  3. Change current directory to "INSTALL_DIR".
        "cd INSTALL_DIR"

  4. Run the make command as follows.
        "make install && make clean"

     If you want to support the Language-Code other than ASCII, you need to
     give the build-option "-DWITH-ICONV".
        "make -DWITH_ICONV install && make clean"

  Congratulations!!
  It can be used immediately in this!

  Playing MIDI-file by playumidi as follows:
      "playumidi yourmidifile.mid"


[Usage]---------------------------------------------------------------------

 Please read README or "man playumidi" 


[CAUTION!!]-----------------------------------------------------------------

 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.
 But, the FreeBSD umidi-driver (integraed by uaudio driver) is not granted
 permission only of the root-user R/W and others user/group read-only
 (permission 644) at the default.

 Therefore, there is a need to grant permissions to R/W prior to use.
 I will show some examples below.

  * (Example 1) set permissions every use time
        Do the following command as the root user.
        (Of course, can use sudo command also.)
           "chmod -R 755 /dev/umidi*"

  * (Example 2) Set permanently R/W permission for usb-midi device. (FreeBSD 8/9 only)
        Do the following operation as the root user.
        (Of course, can use sudo command also.) 

      1. Append to /etc/devfs.rules the following two lines.
         (Making /etc/devfs.rules when there is not existing this file.)
            ------------------------------------------
            [system=10]
            add path 'umidi*' mode 0666 group wheel
            ------------------------------------------

      2.  Append to /etc/rc.conf the following three lines.
            ------------------------------------------
            devfs_enable="YES"
            ------------------------------------------

      3.  Reboot FreeBSD (shutdown -r now) 


END of INSTALL ************************************************************

