Home News About Products Installation Java Licensing Support Manuals Guides Links Trello Boards Contact and Newsletter
Installation Instructions

It's all done in two simple steps. If you have any queries or problems during installation then please email support@xfactory-librarians.co.uk.

Step 1 - Do you have Java on your Computer?

Before being able to run an x.factory librarian you will need Version 11 of the Java Run Time Environment (JRE), or a later compatible release, installed on your computer. JRE 11 is now the minimum JRE version for the latest releases.

Please note that if you are using ex.factory, knonos.facory or motif.factory with large sample files, or are using any x.factory librarian with a very large database then you may need to tweak the Java Memory configuration to avoid running out of memory. Details on how to adjust this configuration is given in the online help of the application or the PDF user manual.

Step 2 - Installing an x.factory Librarian

For each x.factory librarian, there are three downloads that you can select from, depending on your computer type.

  1. Windows
  2. Macintosh OSX
  3. Linux
  4. Other Operating Systems

IMPORTANT NOTE: When using ex.factory and connecting to an EX5, you MUST always use the EX5's MIDI A Input Port. Further details are given in the PDF User Manual

Windows Platforms

The Librarians have been tested with 64 bit JRE 8 on PCs with Windows 10 64 bit.

I am no longer testing on 32 bit PC OS and JRE as I no longer have such a system.

I think the only issue you might have trying to run on a 32 bit system is that the application launcher (the PC executable) might not launch. In that case you should still be able to run the Java application directly by double clicking on the Jar file in Windows Explorer or by launching it from the command line.

All the launcher is doing is wrapping the JAR file so that you have more of a PC experience, so you do not lose much by running the JAR file directly.

Download and run the PC installer, which contains everything you need in a single file. This installer also checks to see if you have Java, and it will direct you to this site's Java Page if you do not have a compatible version of Java on your computer. Installation is pretty simple, just follow the installer prompts which take you through a fairly standard installation sequence, which is self explanatory

This installer will also set up start menu and desktop short cuts for the x.factory librarian.

To delete a librarian, simply delete the directory that it was installed in. All application data, if you wish to remove, is stored in a folder called xfactory.librarians under your user data folder.

On a PC running Vista and above, the data folder can be found at:

OS Drive:\Users\Your User Name\xfactory.librarians

For example, on my PC, with the operating system on drive C, with my user name of Derek, the data folder can be found under:



On Mac Running OSX, the data folder can be found at:

OS Drive/Users/Your User Name/xfactory.librarians

For example, on my Mac, with the operating system on drive MacintoshHD, with my user name of Derek, the data folder can be found under:


Windows Notes.

IMPORTANT NOTE: If you are using ex.factory, there is an issue on Windows 7, which blocks the reception of SYSEX Bulk Dump data when the source synth is also sending MIDI Clock data, which the EX5 sends by default on the EX5 MIDI A Output port.

More information is given in the ex.factory PDF manual, but essentially, you either need to:

IMPORTANT NOTE: If you are using sy.factory, please be aware that Windows 7 (and above) MIDI support seems to be causing problems with MIDI data transfers of large amounts of data, such as sequencer data. Please see the sy.factory User Manual for more details.

When running on Windows Vista and above:

  1. Select the x.factory installer, right click over it and click "Run as Administrator" if you have that option.
  2. When you start the installation, you will be asked if you want the installation to go ahead.
  3. At the end of the installation (at least on my Windows installationss), you may get a prompt asking you if the installation succeeded. I don't know why I get that, but the installation on my systems always succeeds.
  4. If you wish to remove an x.factory application, Windows does not appear to allow the uninstaller to remove the installed items, so you may well need to delete the installed files manually. The installer does not (currently) create any registry entries, so it's quite safe to delete the installation in this manner if you need to.

Macintosh OSX

The Librarians have been tested on an iMac running OSX 10.15 (Catalina) with 64 bit JRE 11.

To install an x.factory Librarian, simply download the relevant Java installer and execute it.

The installer sets up an OSX application bundle in the Applications directory. Whilst you are free to change the name of the installation directory for it to work as expected, you need to keep the installation pathname ending with ".app".

Installing MIDI Extensions for Mac OSX

If you wish to use the MIDI support provided on Mac OSX, then a Java MIDI Service Provider extension is required.

The extensions provide MacOS X Java programs access to all CoreMIDI devices

An extension is required because, historically, the Java implementation on OS X is not able to access external MIDI devices. Apple/Oracle claim to have fixed the external MIDI device access problem in its Java implementation. However, it appears that only "simple" MIDI messages are now supported. SYSEX data transfer (essential for transferring synth data) is not supported.

The x.factory Librarians now embed CoreMIDI4J in their application packages, so you no longer need to download and install it separately. However, if you still require an SPI for other Java MIDI software then you will need to ensure that you have the latest compatible version of CoreMIDI4J, as if an SPI is installed in the /Library/Java/Extensions folder then this will override the version of CoreMIDI4J embedded in an x.factory librarian.

If you are not using any other Java software that requires MIDI access, it is best to remove any existing version of CoreMIDI4J from the /Library/Java/Extensions folder so that an x.factory Librarian can access the CoreMIDI4J version embedded in its package. That way you can ensure that an x.factory Librarian is always using the latest compatible version of CoreMIDI4J.

An x.factory Librarian will warn you if it detects an earlier version of CoreMIDI4J. It will still function, but will not benefit from recent CoreMIDI4J bug fixes or enhancements.

If you need to retain a version of CoreMIDI4J in the /Library/Java/Extensions folder then you can always download the latest version of CoreMIDI4J.jar from  CoreMIDI4J Releases

Once you have downloaded CoreMIDI4J.jar it needs to be copied to the /Library/Java/Extensions folder. You will need to provide administrator permissions to copy the files.

Once installed, when running the librarians and selecting the MIDI ports to use, select the ports prefixed with CoreMIDI4J -. For example my Edirol UA-25 interface that I use for testing on OS X is listed as CoreMIDI4J - UA-25. The latest version of an x.factory Librarian will only list CoreMIDI4J devices.

Linux Platforms

Download the tar.gz file for the application in question and extract the file locally

Double click on the install.sh file and select the option to run it, which will run the Wizard based installer.

Other Platforms

At present the installers only support PC, Mac OSX and Linux. Please email support@xfactory-librarians.co.uk if you are interested in running on other platforms that support Java and are willing to help me test installers.

Privacy Policy