UMP (Unix Midi Plugin)

UMP is a UNIX Midi plug-in for Netscape Navigator. It enables you to play MIDI files via the WWW. The original UMP is distributed from http://pubweb.bnl.gov/people/hoff/.

This document is installation note to install UMP on TiMidity++.

  1. UMP needs libXpm. You must install libXpm before making UMP. If you don't have libXpm on your system, you can download it from here.
  2. Download and extract TiMidity++ v2.0.0 or later.
  3. Change the current working directory to the top of TiMidity++ package directory.
  4. Make subdirectory `ump' and change the current directory to ump. For example:
    % mkdir ump
    % cd ump
  5. Download the following files.
    - PluginSDK from Netscape (unix-sdk-3.0b5.tar.Z)
    - ump_with_volume.tar.Z (courtesy of Tom Schmidt)
    - timdiffs.tar.Z (by [email protected])
    - ump-patch-1.gz
    - ump-patch-2.gz
    - ump-patch-3.gz (ALSA patch by [email protected])
    - ump-patch-4.gz (For TiMidity++ 2.9.x or later)
  6. Extract archives and apply the patches.
    ump% gzip -cd unix-sdk-3.0b5.tar.Z | tar xvf -
    ump% gzip -cd ump_with_volume.tar.Z | tar xvf -
    ump% gzip -cd timdiffs.tar.Z | tar xvf - plugin_c.c
    ump% gzip -cd ump-patch-1.gz | patch -p1
    ump% gzip -cd ump-patch-2.gz | patch -p1
    ump% gzip -cd ump-patch-3.gz | patch -p1
    ump% gzip -cd ump-patch-4.gz | patch -p1
  7. Copy some SDK template files to current directory. For example, type the following commands:
    ump% cp PluginSDK30b5/include/*.h .
    ump% cp PluginSDK30b5/common/npunix.c .
  8. Change directory to parent, and configure TiMidity++ with `--enable-ump' option. For example:
    ump% cd ..
    % sh configure --enable-ump
    % make clean
    Don't forget to clean out old object files!
  9. Type the following command to make the Makefile:
    % env CONFIG_HEADERS='' CONFIG_FILES=ump/Makefile /bin/sh ./config.status
  10. UMP needs some header files from Motif. If you don't have Motif, you can use the headers from GNU Lesstif. I've prepared header files from lesstif v0.55. You can use lesstif-0.55-include.tar.gz if you don't have Motif header files.
  11. Change directory to ump, and type `make ump'. For example:
    % cd ump
    ump% make ump
  12. Copy ump.so into $MOZILLA_HOME/plugins or $HOME/.netscape/plugins. Then restart Netscape Navigator. Here are sample midi files to use for testing UMP.