Install(English) - playumidi Wiki - playumidi

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

"playumid" is able to running following environment.

• OS: FreeBSD
• Available /dev/umidi*.* driver Only(integrated uaudio driver)
  • But Can't use /dev/sequencer (midi driver)
• USB-MIDI Device (Support by FreeBSD uaudio driver)
• MIDI Tone generator or Compatible Device
  • e.g. YAMAMA MU1000/2000/128/etc... or Roland SC-88xx
• Depends on libpthread (Usually, libpthread is FreeBSD-default library. So, You don't neet to install this library.)
• Depends on libiconv (However, only if you want to play MIDI files with embedded languages ​​other than English)

Reference Environment:

• FreeBSD 9.1-RELEASE
• uaudio driver (patched by http://lists.freebsd.org/pipermail/freebsd-usb/2012-December/011702.html "Thank you!! for public this patch!")
• YAMAHA MU1000 Tone Generator (Integrated USB)

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 Usage(English) 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 command 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.)

     [devfsrules_common=7]
     add path 'umidi*' mode 0666 group wheel
     

  2. Append to /etc/devfs.rules the following three lines.

     devd_enable="YES"
     devfs_enable="YES"
     devfs_system_ruleset="devfsrules_common"
     

  3. Reboot FreeBSD (shutdown -r now)