Wiki

Clone wiki

PLUG / Home

Welcome

Welcome to PLUG project code repository. A Linux software for Fender Mustang amplifiers.

Here you can find newest versions of the program including revisions between major releases. The whole project is on GPLv3 license, so grab source code and change it in any way you want.
Program have all features I wanted it to have so please send me your ideas.
If you are looking for some technical stuff you can find it on page Technicalities.

Installation

Nowadays PLUG is present in repositories of most major Linux distributions so first check if it is present in yours distro. If it is, install it using preferred way for your distribution. If you can't find it you can download ready to use version from here.

Compilation

If you want to compile PLUG yourself, download the latest source code (https://bitbucket.org/piorekf/plug/get/tip.tar.gz) and read on.

Requirements

To build a project and use it you will need Qt4 and libusb-1.0. Both libraries are available also for Windows and Mac OS X so this project should run on all three systems.

Building

To build the code you need to run the following commands in the source directory:

  • qmake plug.pro
  • make
    If both commands finished without errors compilation is finished. Executables name is "plug" so to run the program just type:
  • ./plug

If you are a Mac user and want to build a project for Xcode type:

  • qmake -spec macx-xcode plug.pro

Usage

This program should work with both Mustang I and II. Support for newer Mustangs is coming soon.

After you successfully compile the code and run the program click "Connection"-->"Connect" to connect software to the amplifier. Message "Connected" should appear on the status bar at the bottom of the window. After that buttons will become active.



NOTE for Ubuntu users:
For some reason Ubuntu allows only root to access USB devices of unknown type. To change this and allow users in "plugdev" group to also have access to Mustang amp create file /etc/udev/rules.d/50-mustang.rules containing:

SUBSYSTEM=="usb", ATTRS{idVendor}=="1ed8", ATTRS{idProduct}=="0004", GROUP="plugdev", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1ed8", ATTRS{idProduct}=="0005", GROUP="plugdev", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1ed8", ATTRS{idProduct}=="0006", GROUP="plugdev", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="1ed8", ATTRS{idProduct}=="0007", GROUP="plugdev", MODE="0666"

Now either restart computer or unplug amp and restart udev subsystem with the following command:

sudo service udev restart



Button titled "Amplifier" allows you to choose amplifier model and it's settings. In the amplifier window there is also a button named "Advanced" under which are hidden all the advanced settings of an amplifier.

Effect buttons represents an effect slots. If you want to add an effect:

  • select the slot
  • select the effect
  • set effect options
  • press "Set" button to send effect to an amplifier
    To add an effect after the amplifier just enable the check box at the bottom in the effect window.

To save settings in one of amplifiers memory banks click "File"-->"Save on amplifier". In the newly opened window choose name for your preset and memory bank and click "Save".

To load settings simply click "File"-->"Load from amplifier" choose slot to load and press "Load" button.

Help

Want to help? Have any ideas? Great!
You can:

  • write code and send me patches
  • prepare packages for Linux distributions, I will post them here (if you want)
  • send me some ideas through the issue tracker
  • donate if you like my work
This page and it's content is licensed under CC BY-SA 3.0 Unported license.

Updated