jonelo / jacksum-for-linux

Jacksum File Browser Integration on GNU/Linux

Jacksum File Browser Integration on GNU/Linux

The installer script installs Jacksum and HashGarten which allow accessing Jacksum's primary features from the GNU/Linux file browser/file manager's script menu.

System Requirements

• A GNU/Linux or Unix operating system

• A graphical desktop user interface

• bash v3 or later, or zsh

• At least one of the supported file browsers below

• A Java Runtime Environment (JRE) or Java Developement Kit (JDK) with graphical libraries, version 11 or later. Note: a headless OpenJDK is not suitable to run the HashGarten GUI.

• jacksum-3.7.0.jar, HashGarten-0.16.0.jar and flatlaf-3.4.1.jar (all jars are part of the installation tarball)

Supported File Browsers

The installation script has been tested successfully for many file browsers on many systems. If the API has not changed, the script should work with later minor or patch versions as well. See also the head of the installer script for details.

If your preferred file manager is not listed below, chances are high that your file manager supports at least drag & drop, so you could use drag & drop to transfer file/directory-paths from your file manager to the HashGarten GUI where you can process data further, e. g. calculate hashes from file/directory-paths.

File Browser	Tested Versions	API	Comment
Caja	1.12.0 - 1.26.0	Caja	It is the default file manager for the MATE desktop environment. It is a fork of Nautilus version 2.32.
Dolphin	2.2 - 21.12.3	KDE	Default file manager on KDE-powered distributions.
elementary files	6.2.1 - 6.5.2	elementary contracts	"elementary files" is the file manager used by the elementary OS.
GNOME Files (Nautilus)	2.6.1 - 24.6	GNOME	Default file manager for GNOME-powered distributions like Fedora, Ubuntu or Zorin OS.
Konqueror	3.4.1 - 4.4.2	KDE	Konqueror was the file manager for KDE before it was replaced by Dolphin starting with KDE 4.
Krusader	2.7.2	KDE	Krusader is a file manager for KDE.
muCommander	1.3.0	muCommander	muCommander is a cross platform file manager written in Java.
Nemo	1.8.4 - 6.0.2	Nemo	Nemo is Linux Mint's default file manager in Cinnamon desktop edition. It is a fork of Nautilus 3.4.
PCManFM	1.3.2	PCManFM	PCManFM is a file manager for GTK.
PCManFM-Qt	0.17	PCManFM	PCManFM is a Qt port of PCManFM
ROX-Filer	2.5 - 2.24.33	ROX	ROX-Filer is the file manager for the desktop environment "ROX Desktop".
SpaceFM	1.0.6	SpaceFM	SpaceFM is a file manager on Linux.
Thunar	1.0.1 - 1.6.10	Thunar	It is the default choice for Xfce-based distributions.
Xfe	1.37 - 1.43.2	Xfe	X File Explorer (Xfe) is a file manager on Linux.
zzzFM	1.0.7	zzzFM	A file manager for the antiX Linux.

Get started

Download the latest installation script

Go to https://github.com/jonelo/jacksum-fbi-linux/releases and download the .tar.bz2 file.

Extract the installation script

On most GNU/Linux derivates, and on macOS you can enter

$ tar xfvj jacksum*.tar.bz2 ; cd jacksum-file-browser-integration/

On most Unix derivates, such as Sun/Oracle Solaris you can enter

$ bunzip2 < jacksum*.tar.bz2 | tar xfv - ; cd jacksum-file-browser-integration/

Start the installation script

The installation script is an interactive text user interface that allows you to install Jacksum and HashGarten in your file manager. It also allows uninstalling it again safely and completely. You can run the script as often as you want. If a file manager is not detected on your system, it is marked as DISABLED.

FAQs

Where can I file bugs, feature requests, and support requests?

Please go to https://github.com/jonelo/jacksum-fbi-linux/issues

I have installed Krusader, but the installer marked it as DISABLED

On systems without KDE, you need to install both the krusader and the kf5-config package in order to make it work.

The installer marked all entries as DISABLED

Most likely, you are running a non-supported file manager. If you think it should be supported, please file a feature request. Please note that the file browser must support sending highlighted files or directories or selected files or directories to a 3rd party application such as a script.

How do I get the latest Java?

Debian based Linux (e.g. Ubuntu)

$ sudo apt install openjdk-21-jre

You just need to enter /usr/bin/java (or hit Enter) if the jacksum-file-browser-integration.sh asks you for the java command:

$ ./jacksum-file-browser-integration.sh
...
Type the absolute path to "java"
and press "Enter" to continue [/usr/bin/java]: 

Other Linux

You could use the update_jdk script from the bashberries project in order to get a suitable JDK. The following example downloads Temurin 21 (that is the JDK 21 from adoptium), and installs it to /opt/java/jdk_latest:

$ sudo ./update_jdk -s "https://github.com/adoptium/temurin21-binaries/releases/download/jdk-21.0.2%2B13/OpenJDK21U-jdk_x64_linux_hotspot_21.0.2_13.tar.gz" -t jdk /opt/java

You just need to enter /opt/java/jdk_latest/bin/java if the jacksum-file-browser-integration.sh asks you for the java command:

$ ./jacksum-file-browser-integration.sh
...
Type the absolute path to "java"
and press "Enter" to continue [/usr/bin/java]: /opt/java/jdk_latest/bin/java

Further hints

For more information about Jacksum see also https://jacksum.net or https://github.com/jonelo/jacksum

For more information about HashGarten see also https://jacksum.net or https://github.com/jonelo/HashGarten

There are also File Browser Integration scripts available for both Microsoft Windows, see also https://github.com/jonelo/jacksum-fbi-windows, and macOS, see also https://github.com/jonelo/jacksum-fbi-macos

Show your support

Please ⭐️ this repository if this project helped you!

jacksum-for-linux's Issues

Support muCommander

muCommander supports custom commands stored in a file called commands.xml, it is saved under ~/.mucommander on GNU/Linux.

So it is a candidate in order to expand the list of supported file managers for the Jacksum File Browser Integration script.

Add support for both PCManFM and PCManFM-Qt

Add support for both PCManFM and PCManFM-Qt.

See also
https://en.wikipedia.org/wiki/PCMan_File_Manager
https://linuxconfig.org/how-to-extend-pcmanfm-with-custom-actions
https://manual.lubuntu.me/stable/2/2.4/2.4.4/pcmanfm-qt.html#custom-actions

Add support for SpaceFM

Add support for SpaceFM, see also https://github.com/IgnorantGuru/spacefm

Add support for ranger

Add support for ranger, see also https://github.com/ranger/ranger/wiki/Custom-Commands

Add support for the file manager on Elementary OS

Add support for the file manager on Elementary OS, see also
https://elementary.io/ and https://github.com/elementary/files

Minor deployment regression: in the tarball the files should be stored in a directory

The 2.5.0 tarball stores all files in the tarball's root, this is not correct, it should store the files in the folder called jacksum-file-browser-integration. Documentation is correct, the tarball is not. This is a minor deployment regression since the 2.4.0 tarball is correct.

use zenity instead of Kate for less intrusive interaction

using kate will switch the current active tab in the editor (annoying). Zenity (or kdialog on KDE) is probably a better default choice for this. e.g.:

cat /tmp/jacksum.50865.txt | zenity --text-info --width 777 --height 400

cmd_calc /lib && cmd_check /lib => Jacksum: new files (NEW): 493153; version 3.1.0

While playing around with the new version 3.1.0:

jacksum cmd_calc /lib && jacksum cmd_check /lib
=> Jacksum: new files (NEW): 493153

-rw-r--r-- 1 root root 49768066 Jan 8 17:21 /tmp/jacksum.8534.txt
-rw-r--r-- 1 joerg disk 4322 Jan 8 17:19 /tmp/jacksum.8049.txt
-rw-r--r-- 1 joerg disk 9396307 Jan 8 17:19 /tmp/jacksum.txt
jacksum.txt.tar.gz

May be I configured something wrong during the update from 1.7.0 to 3.1.0:
jacksumJK.sh.tar.gz

/opt, /boot and /lib64 worked fine

Any Hints/explainations are welcome.

v2.6.0 hashsums don't match that of the *.zip file

v2.6.0 hashsums are for *.tar.bz2, but file under Assets is *.zip.