Installation on Debian/Ubuntu linux

System Requirements

If your PC doesn’t meet these system requirements, the Inguz processor probably won’t work.

  • PC running Debian or Ubuntu (or probably other Debian-type distributions)
  • At least 2GHz CPU processor;
  • At least 512MB RAM memory;
  • At least 10GB free disk space.

The most important thing is to have a fast CPU.  NAS devices or other low-power processors won’t be fast enough.  Although this has only been tested on x86, it should work well on x64 and other architectures including multiprocessor systems.

Things To Do First

Before you install the Inguz plugin and processor:

  • Install SlimServer version 6.1 or later. (You probably did this already).
  • Install Mono version 1.2 or later.

Mono version 1.1.13 might already be installed.  The filter processor will not work with this older version; you’ll need to uninstall or upgrade Mono first.  To check, type mono -V at a terminal prompt.

It should be possible to install with apt-get, but I haven’t worked out how; the “official packages” site (http://pkg-mono.alioth.debian.org/) seems to be quite out of date.  The latest mono version may be in the experimental or testing repositories.  Alternatively a build for edgy is apparently available here.

One easy way to install version 1.2 is from ftp://www.go-mono.com/archive/1.2.2.1/linux-installer/1/mono-1.2.2.1_1-installer.bin.  By default, this installs into /opt/mono-1.2.2.1/, but if you already had an older version of Mono installed you should instead install in /usr.  Note that since this doesn’t use the official packages, it may break dependencies where other applictions depend on Mono.

Be sure to install as root.  If you install Mono with a non-root login, it won’t work properly with SlimServer.

Finally, check again that mono -V shows version 1.2 or greater.

Installing the Plugin

The plugin is the “user interface”: it lets you control filter functions from the Squeezebox remote control. To install:

  • Download the plugin.
  • Unzip in the SlimServer Plugins directory.
    You should end up with a folder /usr/share/slimserver/Plugins/InguzEQ containing the plugin file Plugin.pm and a few other supporting files.
  • Set this folder’s owner to ”slimserver” (chown slimserver /usr/share/slimserver/Plugins/InguzEQ/)
  • Make a folder /usr/share/InguzEQ/, and set its owner to “slimserver” (chown slimserver /usr/share/InguzEQ/).
  • Restart SlimServer.  (/etc/init.d/slimserver restart)
  • From the SlimServer web interface, select Server Settings -> Plugins. Verify that the “EQ” plugin is checked.
  • From the SlimServer web interface, select Player Settings -> Menus. Verify that the “Plugins” menu or the “EQ” plugin are active.
  • Using the remote control, select the “EQ” menu (under Plugins). You will see a message indicating that SlimServer must be restarted.
  • Restart SlimServer a second time.

Installing the Filter Processor

The filter processor is the “engine”: it processes audio files as they are played, and sends the processed audio to your Squeezebox or Transporter. To install the processor:

Mono needs a working directory, but seemingly can’t make this itself for the slimserver user, so: (as root):

  • mkdir /usr/share/slimserver/.wapi
  • chown slimserver /usr/share/slimserver/.wapi 

Test the install (as root) by

  • /usr/sbin/InguzDSP
    • You should see: Usage: InguzDSP -id clientID […etc…]
  • cat /usr/share/InguzEQ/log.txt
    • You should see some text in the log file.
  • chmod 666 /usr/share/InguzEQ/log.txt
    • otherwise slimserver won’t be able to write to the log later!

Configuring File Types

After installing the plugin and the filter processor, you need to configure SlimServer to use them for particular types of audio files. You can choose to only process certain files (FLAC, or MP3, for example), but you’ll usually want to set this configuration to process every type of audio.

To playback MP3 files with InguzDSP, you will need to install LAME.  Follow the LAME instructions on the Slim Wiki.

From the SlimServer web interface, select Server Settings -> File Types. Check all the boxes which have “InguzDSP” in the decoder listing, and uncheck everything else.

Finally, restart SlimServer again.

Running

Now the plugin and filter processor are installed, you should be able to play music.  From the remote control, you can configure the plugin and change equalization settings.

More detail about using the remote control can be found here.

For room correction, you need to create and install room correction filters.

After playing the first track, check that there’s a file log.txt in the folder /usr/share/InguzEQ/. This is the filter processor’s log file, and you should read it occasionally to check that the filter processor is working properly. More detail about the log file can be found here.

 

inguz audio / Installation / Installation on Debian/Ubuntu linux © 2008