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!

  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-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.
  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

View the documentation  for more information on how to run midis2jam2.