Running experimental builds

This page shows you how to run experimental builds of midis2jam2. You can use experimental builds to test features of midis2jam2 that are currently in development. Because these features are in development, they are prone to bugs and subject to change.

Obtaining an experimental build

To begin, you need a .jar file of the build you want to run. You can download them from a couple of places:

• The builds page — Download a build by clicking the "Download JAR" link, then selecting the appropriate file for your operating system.
• Pre-releases from the GitHub releases page — select the appropriate file for your operating system under the "assets" dropdown.

Once you have downloaded the build, you will have a file that might be named something like midis2jam2-linux-61e31ca7.jar. The file is named by the target operating system and the beginning of the GitHub commit hash.

Obtaining Java 11

You need the Java 11 JDK to run the .jar file. Follow these steps to obtain it:

1. Visit the Java Archive Downloads for Java SE 11.
2. Download the Compressed Archive version for your operating system. For example, if you are running Windows, you'll need to download the file labeled jdk-11.0.15_windows-x64_bin.zip. While in theory any version of the JDK 11 should work, 11.0.15 is known to work.
• You will need to create an Oracle account to download the file.
3. Extract the downloaded file to a folder on your computer. If you are unsure how to do this, perform an internet search.

Running the build

Once you have the JDK and the .jar file, you are ready to run it!

1. Using your computer's file explorer, move the previously downloaded .jar file to the bin folder located within the extracted JDK folder.
2. Open your computer's terminal/command prompt.
• On Windows, press the Start Button, then search for "cmd".
• On MacOs and Linux, open the search, then search for "Terminal".
3. Within your terminal/command prompt, navigate to the bin folder in the JDK folder.
• Use the cd command, for example:
  cd "C:\Users\wysko\Downloads\jdk-11.0.15_windows-x64_bin\jdk-11.0.15\bin"
  Edit the path used in the above example to the actual path of the folder on your computer.
4. Run the build.
• Use this command to run the build. You must change the name used in this example to the actual name of the .jar file you downloaded!
  java -jar midis2jam2-windows-61e31ca7.jar

Troubleshooting

If you are receiving this (or something similar) in your console,
Inconsistency detected by ld.so: dl-lookup.c: 105: check_match: Assertion `version->filename == NULL || ! _dl_name_match_p (version->filename, map)' failed!
you are using the wrong version of Java, likely Java 8. Ensure you are actually running the build with Java 11.