How to install Checker on Linux

Post your questions & get help from friendly LibriVoxers
Post Reply
barbara2
Posts: 2336
Joined: June 24th, 2012, 10:28 pm
Location: Australia

Post by barbara2 » April 18th, 2021, 12:46 am

To install this useful utility in Linux,the programmer's advice is succinct:
Download and unzip the file, then run the checker script to start the application.

Some time ago I posted what had worked for me. In case it helps others, I'll repost it. Feel free to annotate or change these steps (I'm not a techie)


1. Go to the Checker page - https://cgjennings.ca/checker.html

2. Click the 'Download for Linux' link

3. Save the compressed file - checker-unix-0.96.tar.gz - to [whatever folder you choose for such Downloads]

3. Extract checker-unix-0.96.tar.gz - you can probably just right click on the file and choose "Extract".

4. The "checker" script that you have to run has been extracted in a folder of the same name along with other files.

5. Open the "checker" script in a text editor and follow the programmer's instructions -
Uncomment the following line .....
(That is, just edit out the # at the beginning of the two lines that begin "INSTALL4J")

5. Open a terminal and as root (su or sudo) give yourself permission to run 'checker' by typing chmod 777 path-to-checker . (I chose the easy option of giving everybody permission to do anything by specifying '777' ).

6. Now - Run checker! You do this by navigating to the folder containing the 'checker' script, opening a command line and typing: ./checker

7. If, like mine, your Java is a recent version, running the checker script will give you the message that:

The version of the JVM must be at least 1.6 and at most 1.8.
Please define INSTALL4J_JAVA_HOME to point to a suitable JVM


In which case, you can google "openjdk-8-jre", download and install it with your package manager,and you will get an earlier JVM (Java Virtual Machine) which will work with Checker. I uninstalled my openjdk-11-jre package first but I don't think that is necessary.

And now you run checker again and all is well!


8. For anybody using the KDE Plasma Desktop Environment, you can add Checker to the application launcher and give it a nice icon:



Right click on the Application Launcher.
Edit applications...
Mark the folder you want it in, e.g. Utilities. Click on New.
Fill in the name you want.
Add the actual command and click on the square next to name to change the icon.
Click Save.


Hope that saves at least one other Librivoxer some time.

Best,

Barbara
Last edited by barbara2 on April 18th, 2021, 5:45 pm, edited 1 time in total.

knotyouraveragejo
LibriVox Admin Team
Posts: 17718
Joined: November 18th, 2006, 4:37 pm

Post by knotyouraveragejo » April 18th, 2021, 9:01 am

Hi Barbara,

Thanks for posting! I've added your instructions to the Checker page in the wiki for future reference.

https://wiki.librivox.org/index.php?title=Checker#Detailed_Instructions_for_installing_Checker_on_Linux
Jo
My Librivox Solos
Books are the carriers of civilization. Without books, history is silent, literature dumb, science crippled, thought and speculation at a standstill. - Barbara Tuchman

schrm
Posts: 3544
Joined: February 10th, 2018, 11:02 am
Location: Austria

Post by schrm » April 20th, 2021, 1:12 am

thank you barbara - and let me tell you: you are a tech savy person :-)

for people, who want to do it very fast and not so perfect, and are using ubuntu xfce or thunar:
1. i downloaded the linux version of checker and openjdk
2. unzipped the checker files into a folder named ***checker
3. rightclick the LV_Tool.tar and in properties, make it executable
4. with rightclicking the LV_Tool.tar file i choose open with open jdk

...and it runs.
as an explanation: i didn't add it to my menue or apps lists, i did not install it.
i just added the folder in thunar to the file structure overview on the left side of the window to have a shortcut.
it is a click more - but all in all, a very fast and easy to do way to use checker without any danger of making a mistake.

(i don't think, that this way of using checker on linux should be published in our wiki. it is just for people like me, who feel a lack of time or have workflow on their machines, where it suits. i am not tech say and honestly don't know about the pros and cons to this. most steps may be the same as barbara wrote)
cheers
wolfi
reader/12275

en: lay down your arms
de: sammlung prosa, das geschlecht der zukunft, hoffmann: sommerfrische, ostseemärchen
dpl: hoffmann*2
solo: na prost!

Post Reply