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 in fullscreen. To fix this, set the window mode to Windowed in the settings.
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!
You should only see this error when attemping to the build the project from source. Using a JDK other than 21 causes this error. Download JDK 21 from Azul Zulu.
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 may remedy this issue.
Nevertheless, try updating your computer's graphics drivers. If the issue persists, try running the app on a different computer.
Window can't be resized
The app doesn't support resizing the window. However, the window size is adjustable in the graphics configuration when the window mode is Windowed. To fill the screen, set the window mode to Borderless fullscreen or Fullscreen.
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.
The screen goes black, then closes
This issue may be caused by antialiasing settings on macOS. Your graphics card may not support the antialiasing settings used by the app. Try turning off antialiasing in the graphics configuration.
The camera moves on its own, or the app crashes with a gamepad connected
Earlier versions of the app always read input from connected gamepads, which could make the camera drift or spin, or crash the app on startup with some controllers. Gamepad input is now off by default. If you have turned on Gamepad input and see these problems, turn it off in the settings.
A recording resolution isn't available
While recording, the app shows the performance in a window the same size as the video, so it only offers resolutions that fit on your screen. To record at a larger resolution, use a larger monitor.
Gervill sometimes chooses the wrong sounds
Gervill sometimes chooses the wrong sounds for instruments. This is a known issue with Gervill, the default MIDI device. To fix this, use a different MIDI device.