Installing jOrgan on Puppy Linux

From jOrgan Wiki v1.25.1
Jump to: navigation, search

This Tutorial presents an extensive step by step procedure for installing jOrgan on Puppy Linux. Don't be put off by the length of the tutorial, I am taking you through almost every single mouse click or 'Enter' press that needs to happen. Please note that this tutorial was written for Puppy Linux version 5.1.1 with jOrgan 3.11.1, it will be updated for Puppy 5.2 and jOrgan 3.12 once Puppy 5.2 is released.

There will also soon be a jOrgan Pup available for Puppy Linux 5.2 which will have everything pre-installed.

If you have any questions of comments you can email me at ggoode [dot] sa [at] gmail [dot] com

Installing Puppy Linux and the Required Software

  1. Download the Puppy 5.1.1 CD Image from
  2. Burn the ISO image to CD using your favourite CD burning app.
  3. Boot your computer using the CD
  4. Once Puppy 5.1.1 has booted, use the Universal Installer (Menu -> Setup -> Puppy universal installer) to either install Puppy Linux to your Hard Drive OR to a USB Memory Stick [if you need more info on this step let me know].
  5. Reboot using the install that you have just created
  6. Configure the Puppy Package Manager to use the Ubuntu Lucid Repositories
    1. Start the Puppy Package Manager (menu -> Setup -> Setup Puppy -> Puppy Package Manager
    2. Click on 'Configure package manager'
    3. Select the three Ubuntu-Lucid-xxxx repositories
    4. Click on OK
    5. Click on 'Exit Package Manger'
  7. Connect to the Internet
  8. Click on the 'connect' icon on the desktop (this will load the Internet Connection Wizard)
  9. Select your network interface
  10. Enter whatever network passwords, etc are needed and click on Connect if needed.
  11. As I only ever connect to the internet to intall new software I don't enable the firewall, but I do set the SNS (simple network setup)as the default network setup tool)
  12. Use Puppy Package Manager to install Jave JRE, Qjackctl, and Qsynth
    1. Restart Puppy Package Manager
      1. Type 'qjackCtl' into the search box
      2. Click once on the 'qjackCtl' Package in the list returned - this will run you through the install sequence.
      3. It will tell you that there are unmet dependencies, so click on the 'Examine dependencies' button to let it add the dependencies for you
      4. Click on the 'Download and install all selected packages' button
      5. The installer will prompt you on where to download the packages from, I use the default.
      6. Click on the 'Download packages button
      7. The installer will also eventually say that it has installed the package and ask you if you want to trim the fat - I usually do....
      8. The installer will then report on any missing dependencies...if you're missing perlapi that is fine, we're not going to need it
    2. Once qjackctl is installed, do a search for qsynth and follow the same sequence as set above to install Qsynth and all its dependencies (this is so that jOrgan can also use libfluidsynth, and I use Qsynth for testing and other things).
    3. Do a search for 'jre' and follow the same sequence as a above to install Java runtime environment
  13. Once all of these are installed - exit the Puppy Package Manager
  14. Download and install the jOrgan DEB
    1. Click on the 'browser' icon on the desktop (If this is the first time that you have opened the browser you will be asked to choose and install the browser of your choice - I use firefox)
    2. Navigate to
    3. Select 'Save' from the download dialogue screen
    4. Save the DEB to the root folder (default) and click OK
    5. Open the File Browser (click on the 'file' icon on the desktop)
    6. Click once on the downloaded jorgan_3.11.1_i386.deb package
    7. Click on OK
    8. The installer will then report a successful installation - click OK (it will now do the menu refresh)
  15. Check that things have installed and are working
    1. Menu -> Multimedia -> Multimedia should show JACK Control, Qsynth, and jOrgan (no icon)
    2. Click on the jOrgan icon to start jOrgan (it may bring up an error that it is 'Unable to open file "%f" - this is safe to ignore)
    3. Update fluidsynth and libfluidsynth to version 1.1.2
    4. Open your Internet Browser and navigate to:
    5. Select 'Save' from the download dialogue screen
    6. Save the DEB to the root folder (default) and click OK
    7. Then navigate to:
    8. Select 'Save' from the download dialogue screen
    9. Save the DEB to the root folder (default) and click OK
    10. Open the File Browser (click on the 'file' icon on the desktop)
    11. Click once on the downloaded DEB packages and follow the install steps as you did with the jorgan DEB file.
    12. Provide the required link to
      1. Open the file Browser
      2. Navigate to /usr/lib
      3. Locate the file and Right Click on it
      4. Select File '' -> Link
      5. Delete the 2.1.1 from the end of the and add the 3 (to make it
      6. Click on 'Symlink'
      7. You can now close the file browser.

Configuring Virtual Midi Devices

  1. Configure the Virtual MIDI Ports (you may not need these, but they do come in handy)
    1. Open the text editor (click on the 'text' icon on the desktop)
    2. Enter the following three lines of commands:
      1. modprobe -r snd-usb-audio
      2. modprobe snd-virmidi
      3. modprobe snd-usb-audio
    3. Save the file to the Startup folder
      1. File -> Save As -> Enter 'startup' as the saved file name
      2. Click on the 'Browse for other folders' button and browse to /root/Startup
      3. Click on the 'Save' button
    4. Set the Permissions on the new 'startup' file
      1. Open the File Browser and navigate to the Startup folder
      2. Right click on the 'startup' file and select File 'startup' -> Permissions
      3. Click on 'Yes'
    5. Run the startup file by clicking once on it (it will be run every time that you reboot your computer - we're just manually starting it here instead of rebooting)

Configure Jack Control

  1. Start JACK Control (Multimedia -> Multimedia -> JACK Control)
  2. Click on the Setup button
  3. Select the "Misc" tab in the top menu bar
  4. Select the "Start Jack audio server on application startup" option
  5. Select the "Enable system tray icon" option
  6. Now select the "Settings" tab in the top menu bar
  7. Click on the 'Realtime' checkbox to select it
  8. Set your 'Frames/Period' to 512
  9. Set your 'Sample Rate' option to 44100
  10. Set your Periods/Buffer to 4
  11. Set the 'Timeout' option to "5000"
  12. Change the 'Audio' option to "Playback only"
  13. Click on the 'SAVE' button on the top right hand side of the Settings screen
  14. Click 'OK' (this closes the SETUP window)
  15. Now click on the 'START' button (the window should now indicate that Jack audio server has started)

[This assumes that your soundcard is configured correctly and will work at 44100hz - some do not, so if you run into problems here, let me know]

[Optional: You can add 'qjackctl' to your startup file so that Jack Control starts automatically on re-boot]

Running your first jOrgan Disposition

  1. Download the ZIP file of the jOrgan organ model that you want to play (these steps assume you will be using a fluidsynth based model, usually indicated by a 'FS' somewhere in the name of the organ model)[if you're downloading a RAR file you will need to decompress it on another computer for now, I'll be adding the steps to include RAR support at a later stage]
  2. Unzip the organ contents of the model file into your 'my-documents' folder (I have a sub-folder called jorgan3.11.1, you might like to do the same)
    1. Click on the saved ZIP file to open it with XArchive
    2. Click on the 'Extract' button (select OK to select all files)
    3. Click on 'Choose' and navigate to /root/my-documents/jorgan311.1/
    4. Use the 'Create Folder' button if you need to create a new folder
    5. Click on 'Open'
    6. Then click on Ok
    7. Close XArchive
  3. Make sure that your JACK audio server has started and is running Ok
  4. Start jOrgan
  5. Load the organ model disposition file
    1. Click on File -> Open
    2. Navigate to /root/my-documents/jorgan3.11.1/(organfolder) [where (organfolder) is the organ that you downloaded and unzipped]
  6. Customize the organ to your MIDI setup
    1. if the Customize Wizard did not start automatically, click on File -> Customize...
    2. If your MIDI keyboards and pedalboard show up in the Device drop down menus, then configure the keyboard elements to them. If they do not, then use the virmidi ports that we created for this purpose (I always use the virtual MIDI ports as my MIDI setup changes due to different experiments that I do)
    3. Configure the MIDI channels as per your MIDI setup
    4. Click on Next, Next, Finished
  7. Configure the fluidsynth elements to use Jack
    1. Enter Construct Organ mode (click on the set square/ruler/pencil icon)
    2. Locate the fluidsynth elements (they have the same icon as Qsynth - an orange tear shape (and they will likely have a red x on them too)
    3. Click on the first fluidsynth element to select it
    4. In the Audio Driver property select 'jack' from the drop down
    5. Select the next fluidsynth element and do the same, etc for the rest of the fluidsynth elements
    6. Select any other element close the fluidsynth elements (taking the selection off the fluidsynth element, which allows jOrgan to load start fluidsynth and load the soundfont)
    7. The red x's on the element's icons should be gone [if not, contact me]
    8. Exit Construct Organ mode by click in the square/ruler/pencil icon again
  8. If you selected a virtual MIDI port in the manual Device selection, you will now need to connect your USB keyboard to the virtual MIDI port using the Jack Control ALSA connections panel.
    1. Right Click on the Jack Control icon on the bottom right hand side of the Menu bar
    2. Select 'Connections' from the menu
    3. Click on the ALSA tab at the top of the Connections window
    4. Select your MIDI keyboard device on the left column and the Virmidi Port you configured in jOrgan in the right column
    5. Click on the Connect button
    6. Do the same for all the keyboards/virtual midi ports configured
    7. Right Click on the Jack Control icon again and select the Connections window to close it

Now you should be ready to play the organ....

Advanced Topic: Convolution Reverb.... jConvolver with the Jc-Gui frontend

  1. Use Puppy Package Manager to install jconvolver (and as it is a command line tool only it will not show up on the menu).
    1. Open Puppy Package Manager (Setup -> Setup Puppy -> Puppy Package Manager)
    2. Do a search for 'jconvolver'
    3. Install jconvolver and jconvolver-config-files - using the same sequence as described in the first section of these install and configure steps. Remember to use the 'Examine dependencies' button when installing jconvolver so that all the software dependencies are installed as well.
  2. Download and install Jc-Gui, the graphical front-end that makes jconvolver easier to use.
    1. Download Jc-Gui from (save it to /root as before)
    2. Click on the DEB to install it
  3. Download some free convolution reverbs to use with jconvolver - I would suggest creating a 'reverbs' folder in your my-documents and saving the wav files there...
    2. Magnuskerk Anloo (high resolution 2 channel stereo IR)
  4. Once all that is installed, with the jack audio server running, start Jc-Gui (Multimedia -> Multimedia -> Jc-Gui)
  5. Click on 'jconvolver settings' (this will open the jConv Settings window, you may need to drag the window to the center of your screen)
  6. Click on the 'Open file' icon (the folder image)
  7. Navigate to your reverb wav files and select one by clicking on it
  8. Click on Open (the folder icon) [if your text is white on the light blue background, just look closely at the screen to see the text]
  9. Wait for the wav file to be loaded. You should now see it in the preview window.
  10. Don't worry about the other buttons and dials, those are for tweaking the reverb
  11. Click on Ok to close the Jconv Settings window
  12. Now click on the 'run jconvolver' button
  13. After a few seconds (or a little longer with the older computers) the 'run jconvolver' button should turn bright green, indicating that jconvolver is loaded and running
  14. Take note of the wet/dry slider above the four dials above the buttons that we have used

Now we need to connect the output of the fluidsynth soundfonts to the reverb, and connect the reverb to the speaker outputs. We will do this in the Jack Control Audio Connections tab:

  1. Right Click on the Jack Control icon on the bottom right hand side of the Menu bar
  2. Select 'Connections' from the menu
  3. Click on the 'Audio' tab at the top of the Connections window if it is not displayed by default
  4. Select a jOrgan fluidsynth jack output from the left hand side, then select the jconvjc port on the right hand side and click on the Connect button
  5. Do the same for all the other fluidsynth ports that you want connected to the reverb
  6. Now select the 'jconvjc' port on the left hand side and select the 'system' port on the right hand side, and click on the Connect button to connect them [This connects the fluidsynth outputs to the jconvolver input stream, and the jconvolver output to your speakers]

Now play the organ, and use the wet/dry slider mentioned above to get the right about of reverb mixed in to the audio stream.

Advanced Topic: Using Jack Control's Patchbay

  1. Right click on the Jack Control icon on the right hand side of the Menu bar and select 'Connections'
  2. In the Connect Panel, select the ALSA tab and make all the MIDI connections that you need
  3. Test these connections in jOrgan to make sure everything is working
  4. If you are using an external reverb (Jc-Gui or Jack-Rack), then click on the Audio tab and make all the audio connections needed.
  5. Test to make sure that everything is connected as you need it to be
  6. Right click on the Jack Control icon on the Menu bar again and select 'Connections' again to close the Connections window
  7. Now right click on the Jack Control icon again and select 'Patchbay'
  8. In the Patchbay Panel, click on the 'New button'. This should open a dialogue box asking if you want to create a patchbay definition snapshot of the actual client connections
  9. Click on 'Yes'. This should automatically replicate your connections in the Patchbay
  10. If the Save button is not enabled, remove a MIDI or Audio device from the patchbay that is not being used (for example, MIDI-Thru)
  11. Once the 'Save' button has been enabled, click on 'Save'
  12. Enter a name for this patchbay in the File name box
  13. Click on 'Save' within the file dialogue screen
  14. Click on 'Activate' back in the Patchbay window
  15. Close the Patchbay screen by right clicking on the Jack Control icon and selecting 'Patchbay'
  16. Now open the 'Setup' screen by right clicking on the Jack Control icon and selecting 'Setup'.
  17. Click on the 'Options' tab and make sure that the 'Activate Patchbay persistence' check box has been enabled and that your patchbay file is listed in the patchbay drop down.
  18. Click on the 'Settings' tab of the Jack Control Setup window and Save your setup (If the 'Save' button is not activated then de-select and re-select the 'Realtime' check box and the Save button will activate).
  19. Close the Setup window

For more information and other options on how to use the Patchbay, see

Now you won't have to keep connecting your MIDI keyboards to the Virmidi Ports each time you re-boot your computer :)

Contacting Me

If you have any questions of comments you can email me, GrahamG, at ggoode [dot] sa [at] gmail [dot] com