mbaeuerle / Briss-2.0

Briss 2.0 is intended to be a GUI Update for the Briss PDF cropping tool.
GNU General Public License v3.0
484 stars 48 forks source link

How to install it? #67

Closed sypianski closed 1 year ago

sypianski commented 1 year ago

I downloaded the files, I tried clicking on some of them, but the program didn't start. The „Installation” section in the manual is not about installation, but about something else. I've been using Briss 0.9 for years and all I needed to do was to download it and open briss-0.9.jar. There's no such file in Briss 2.0 or I can't see it.

If I need to learn something to run in, could you help me by telling what this skill/action/process is? I don't even know what to put in my search engine. The manual seems to run on an assumption that it's obvious to everyone.

wilkohardenberg commented 1 year ago

I have the same problem: when I follow the instructions I only get error messages for lack of dependencies.

sypianski commented 1 year ago

It’s not the same. I don’t know where to start.

wilkohardenberg commented 1 year ago

Have you tried downloading one of the releases (https://github.com/mbaeuerle/Briss-2.0/releases), instead of going from source (as described in the installation instructions)?

sypianski commented 1 year ago

I downloaded Briss-2.0.zip. I tried clicking on different files after unpacking, but it looks like it's not doing anything.

As for the installation instructions, they say only the following:

Currently Briss 2.0 is in alpha therefore some features are still missing (for example the page skip list). If you want to give it a try you can download the pre release from https://github.com/mbaeuerle/Briss-2.0/releases. There is a version of Briss for Java 8 and one version for any newer version of Java.

As a result I still don't know where to start.

wilkohardenberg commented 1 year ago

as far as I can tell, you need to run the Briss-2.0 file in the bin subfolder in Terminal:

sh Briss-2.0

This starts the interface. I cannot testify whether it actually works, as my file seems to be too big and produces thus another error message. Let me know if it works for you with other files.

cleydyr commented 1 year ago

Hey, @sypianski . What is your operating system and Java version?

sypianski commented 1 year ago

@cleydyr: macOS Ventura 13.3.1 and Java bulid 1.8.0_371-b11

@wilkohardenberg:

LinkageError occurred while loading main class at.laborg.briss.Briss java.lang.UnsupportedClassVersionError: at/laborg/briss/Briss has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 60.0

cleydyr commented 1 year ago

Hey, @sypianski. Are you using the Java 8 release available on the releases page?

sypianski commented 1 year ago

@cleydyr: Yes, I am.

cleydyr commented 1 year ago

Here's what I did on a clean MacOS Ventura 13.3.1 (22E261) running on a Parallels Desktop virtual machine.

Installed Java 8 for Mac OS x64 from the official site:

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)

Downloaded the Java 8 version from the releases page and extracted its contents.

Run ./bin/Briss-2.0 from the Briss-2.0 folder:

WARNING: GL pipe is running in software mode (Renderer ID=0x1020400)
Warning: the font "Times" is not available, so "Lucida Bright" has been substituted, but may have unexpected appearance or behavor. Re-enable the "Times" font to remove this warning.

The program opens with no errors.

On the other hand, if I deliberately use the non-java-8 release, I get this:

Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.UnsupportedClassVersionError: at/laborg/briss/Briss has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0
    at java.lang.ClassLoader.defineClass1(Native Method)
    at java.lang.ClassLoader.defineClass(ClassLoader.java:763)
    at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
    at java.net.URLClassLoader.defineClass(URLClassLoader.java:468)
    at java.net.URLClassLoader.access$100(URLClassLoader.java:74)
    at java.net.URLClassLoader$1.run(URLClassLoader.java:369)
    at java.net.URLClassLoader$1.run(URLClassLoader.java:363)
    at java.security.AccessController.doPrivileged(Native Method)
    at java.net.URLClassLoader.findClass(URLClassLoader.java:362)
    at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
    at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:349)
    at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
    at sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:495)
cleydyr commented 1 year ago

@sypianski . According to this post, it looks like you're trying to run the non-java-8 release with a Java 16 runtime. I'd double-check if you're using Java 8 as the runtime when running the Briss-2.0 script from the command line, as shown in the README file.

mbaeuerle commented 1 year ago

@sypianski please check out a new version here which simplifies things in regards to Java versions. Hopefully there you are able to either run the script or jar either via shell or double click.

mbaeuerle commented 1 year ago

Closing this for now. If there are still issues let us know!

sypianski commented 1 year ago

Oh wow, the new release worked out of the box. Thank you!