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 after the target operating system and the beginning of the GitHub commit hash.
Obtaining Java 17
You need the Java 17 JDK to run the .jar
file. From Amazon Corretto , download an archive (i.e., not an installer). Extract it to a folder on your computer.
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 thebin
folder located within the extracted JDK folder. - 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".
- 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-17.0.05_windows-x64_bin\jdk-17.0.05\bin"
Edit the path used in the this example to the actual path of the folder on your computer. - 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
View the documentation for more information on how to run midis2jam2.