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
. 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:
- Visit the Java Archive Downloads for Java SE 11.
- 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.
Extract the downloaded file to a folder on your computer. If you are unsure how to do this, perform an internet search.
- You will need to create an Oracle account to download the file.
Running the build
Once you have the JDK and the
.jar file, you are ready to run it!
- Using your computer's file explorer, move the previously downloaded
.jar file to the
bin folder located within the extracted JDK folder.
- Open your computer's terminal/command prompt.
Within your terminal/command prompt, navigate to the
- On Windows, press the Start Button, then search for "cmd".
- On MacOs and Linux, open the search, then search for "Terminal".
bin folder in the JDK folder.
Run the build.
- Use the
cd command, for example:
Edit the path used in the above example to the actual path of the folder on your computer.
- 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
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.