INSTALLATION:

Sysexy MIDI Librarian is a Perl/Tk program that uses very little disk space,
and can comfortably run out of your home directory instead of being installed
sitewide.  Unless you are creating a DEB or RPM distro package, or a Gentoo-
style ebuild, it is recommended that you run it this way, and an installer is
provided here to set it up for you.  (The installer needs Perl/Tk also.)

Currently, Sysexy runs only on Linux, and has been tested on Gentoo, Debian,
Ubuntu, and Fedora.  Support for FreeBSD and even Windows is possible in the
future.  The installer will complain if you don't have required dependencies,
but to save you time, before you even bother running it, you will need:

* Perl 5.14 or later:
  On Fedora, you may need to install the "perl-core" package to get the full
  environment that Sysexy and most other Perl programs expect, instead of a
  stripped down Perl.

* Perl/Tk
  dev-perl/Tk on Gentoo;
  perl-tk     on Debian/Ubuntu;
  perl-Tk     on Fedora.

* Config::Simple
  dev-perl/Config-Simple on Gentoo;
  libconfig-simple-perl  on Debian/Ubuntu;
  perl-Config-Simple	 on Fedora.

* List::MoreUtils
  dev-perl/List-MoreUtils on Gentoo;
  liblist-moreutils-perl  on Debian/Ubuntu;
  perl-List-MoreUtils	  on Fedora.

* MIDI::ALSA
  This one doesn't seem to be in any distro that I know of, but Sysexy will
  not work without it.  However, you can obtain it from CPAN on the Internet
  by typing (logged in as root, or prefixed by "sudo"):

  cpan MIDI::ALSA

  This will do an automatic fetch of the MIDI::ALSA module from the Internet,
  and will compile it for you.  Some Ubuntu systems do not come with the 'make'
  command by default, so you may need to install the make package first, since
  CPAN will need it.  Also, Debian, Ubuntu, and Fedora machines will all need
  the ALSA headers installed for 'cpan MIDI::ALSA' to work -- libasound2-dev
  on Debian/Ubuntu, or alsa-lib-devel on Fedora.  When you have all of this
  taken care of, run your cpan command, and MIDI::ALSA should install.

* Adobe 100dpi bitmap fonts
  media-fonts/font-adobe-100dpi on Gentoo;
  xfonts-100dpi			on Debian/Ubuntu;
  xorg-x11-fonts-100dpi		on Fedora;

* Miscellaneous X bitmap fonts
  media-fonts/font-misc-misc	on Gentoo;
  provided by same packages as Adobe 100dpi on other distros (see above).

  (You may need to logout and log back in on some Ubuntu systems to make your
  desktop notice the newly installed fonts.)


When you have all these packages installed, run "./install" from this folder,
and the installer should put everything where it will go.  This will certainly
be more automatic in the future if there are proper DEB, RPM, and ebuild distro
packages made for Sysexy and the MIDI::ALSA Perl module.

Also in this directory are the README, which is general usage instructions, and
TECH, which explains the boring details for anyone who's actually interested.
"sysexy.1" is a traditional roff format UNIX manual page, which can either be
installed sitewide (as part of a distro package possibly) or viewed directly
(e.g., "man -l sysexy.1") from the file.
