Troubleshooting
While the developer has made every effort to make sure the software is working as expected, there are times when things go wrong. This page lists some common problems and their solutions.
Windows Defender/macOS Gatekeeper blocks the installer
Windows Defender and macOS Gatekeeper may block the installer from running. This is because the developer doesn't sign the installer with a trusted certificate. To fix this, follow the instructions below.
Upon "Windows protected your PC," click "More info," then click "Run anyway."
Upon "midis2jam2 can't be opened because Apple cannot check it for malicious software," click "Cancel." Then, open System Preferences and click "Security & Privacy". Click the lock, then click "Open Anyway" next to "midis2jam2 was blocked from use because it is not from an identified developer."
If you don't trust the installer, download and inspect the source code, then build the app. See the build instructions for more information.
Pixel format not accelerated
Failed to create display
LWJGLException: Pixel format not accelerated
Updating graphics drivers usually remedies this error. For an NVIDIA graphics card, download the latest drivers from NVIDIA's website. For an AMD graphics card, download the latest drivers from AMD's website.
This error may also only appear when running the app with fullscreen enabled. To fix this, turn off fullscreen in the settings.
XG files only use keyboard instruments
The app currently only supports General MIDI (GM) instruments. The app doesn't support XG instruments. To fix this, use a program like Anvil Studio to convert the XG instruments to GM instruments.
Inconsistency detected by ld.so
Inconsistency detected by ld.so: dl-lookup.c: 105: check_match: Assertion `version->filename == NULL || ! _dl_name_match_p (version->filename, map)' failed!
Using a JDK other than 17 causes this error. Download JDK 17 from Amazon Corretto.
Current thread is not owner
Uncaught exception thrown in Thread[jME3 Main,6,main]
IllegalMonitorStateException: current thread is not owner
Incompatible graphics drivers cause this error. Your computer may not be compatible with the app.
If your computer has an Intel HD Graphics 3000, follow these instructions, which can remedy this issue.
However, try updating the graphics drivers. If the issue persists, try running the app on a different computer.
Window can't be resized
Some post-processing effects cause the window to be unresizable. However, the window size is adjustable in the graphics configuration.
Special characters aren't displayed correctly
The app may not display some special characters correctly in the performance screen, despite the app displaying them correctly in the launcher. This is a limitation of the graphics library used by the app. The developer plans a fix for this issue for a future release.
Colors are distorted on Apple Silicon
Apple Silicon devices may distort colors. This is a known issue, and the developer plans a fix for a future release.