Skip to content

Troubleshooting

Jump to bottom
C. Rubin edited this page Jan 8, 2020 · 1 revision

Table of Contents

I have OpenJDK 8 installed and I can't run CherryRenderer.

  • Unlike Oracle's JDK/JRE, OpenJDK 8 does not include JavaFX by default. You would have to install OpenJFX 8 manually based on your distro's package manager, or manually build OpenJFX 8 following these instructions.
  • On Ubuntu/Debian based distros, you can install OpenJFX 8 with the following:
sudo apt install openjfx=8u161-b12-1ubuntu2 libopenjfx-java=8u161-b12-1ubuntu2 libopenjfx-jni=8u161-b12-1ubuntu2
sudo apt-mark hold libopenjfx-java libopenjfx-jni openjfx
  • I blame Oracle for making everyone's lives harder post license change.

I have a VLC installation, but CherryRenderer doesn't detect it as a valid libVLC directory.

  • The most common cause of this issue is that your Java and VLC installations are in different architectures. 32-bit programs can't access 64-bit native libraries and vice versa.
  • On Windows, the default Java installation is 32-bit while the default VLC installation is 64-bit. Annoying, I know. Blame Oracle.
  • You can check your Java architecture by running java -version in a terminal.
    • A 32-bit version of Java will output something along the lines of:
    java version "1.8.0_201"
Java(TM) SE Runtime Environment (build 1.8.0_201-b09)
Java HotSpot(TM) Client VM (build 25.201-b09, mixed mode, sharing)
    • A 64-bit version of Java will output something along the lines of:
    java version "1.8.0_202"
Java(TM) SE Runtime Environment (build 1.8.0_202-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)
    • Note the absence of 64-Bit in the 32-bit version of Java.

Some of the buttons are turning into white boxes.

  • This is a JavaFX rendering issue that occurs on certain systems.
  • Try disabling hardware acceleration via Menu - Preferences - Interface.
  • However, do note that disabling hardware acceleration may slow down UI rendering significantly in older systems. Use with care.
Clone this wiki locally