jonelo / jacksum-for-macos

Installation program to add Jacksum (CLI) and HashGarten (GUI) to macOS. It also adds functions to Finder and other file managers.
GNU General Public License v3.0
6 stars 0 forks source link
apple applescript bash-script checksum file-browser file-browser-integration finder hash hashing hybrid jacksum mac macos macosx osx

GitHub downloads

Jacksum for macOS

Jacksum for macOS app

Abstract

Jacksum for macOS is an installation program with which you can easily access functions of Jacksum on macOS. In other words, it adds more than 480 hash algorithms to your Mac and you can use them with different user interfaces to calculate hash values, verify data integrity, and many more. See the Jacksum page for more info.

The installation program installs

See also the Architeture of interaction between those components.

System Requirements

Hardware

Software

Supported File Managers

Finder which supports the Apple Script Menu is fully supported by this integration program. In adddition to that, some file managers providing proprietary interfaces are also supported.

[!TIP] If your preferred file manager does not support the Apple Script Menu, nor allow to use any external scripts nor support any plug-ins, 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.

The following File Managers have been tested successfully to work with Jacksum and HashGarten:

File Manager Supported Interfaces Comment
CRAX Commander DnD Commercial Software (Demo)
Commander One DnD Commercial Software
Dropover DnD Commercial Software
EasyFind DnD Freeware
Finder DnD + Script Menu Commercial Software, the standard file manager from Apple
Fileside DnD + proprietary API Commercial Software (Trial), few extra actions required
Forklift 4 DnD + proprietary API Commercial Software (Trial), few extra actions required
HiFile DnD Commercial Software (Trial)
Marta DnD + proprietary API Freeware
muCommander DnD + proprietary API Free/Libre Open Source Software (GPLv3)
Nimble Commander DnD Free/Libre Open Source Software (GPLv3)
Path Finder DnD + Script Menu Commercial Software
Transmit DnD Commercial Software (Trial)
VioletGiraffe FileCommander DnD Free/Libre Open Source Software (Apache 2.0)

Not Yet Supported FLOSS File Managers

The following file managers do not support DnD nor allow calling external scripts.

File Manager Comment
Spacedrive Alpha v0.4.2 Free/Libre Open Source Software (AGPL 3.0)

Installation

1. Download and open the .dmg

Download and open the .dmg.

2. Open on the .app

Control-click on the app icon, and choose Open from the shortcut menu. Gatekeeper warns you about the app, but gives you the option to bypass its default policy and open the app.

Open the Jacksum for macOS app


[!TIP] For users of macOS Sequoia 15.0 and later

With the release of macOS Sequoia, any app from an unidentified developer gives an error that the app is not opened. To open any of such apps, open "System Settings", and go to the "Privacy & Security" tab. On the "Privacy & Security" page, scroll down to last. Under the Security section, you have the option to open the application that was previously blocked. Click on the "Open Anyway" button to open it, and proceed with the prompts. Your app will be opened.

To allow open apps on macOS from anywhere, open a Terminal and enter sudo spctl --master-disable. In the Security section, under "Allow applications from", there is a new menu item called "Anywhere."

Alternatively, you can open a Terminal to bypass the graphical installation program and run the script directly that is bundled with the installer app. Example for Jacksum 3.7.0:

% cd /Volumes/Jacksum\ for\ macOS
% ./Jacksum\ 3.7.0\ for\ macOS.app/Contents/Resources/script

3. Check results

At the end of the task a summary will tell you what file managers have been found and where Jacksum and HashGarten have been integrated.

After the installation

How to use it

Using HashGarten

Open the Spotlight Search and search for HashGarten or go to Applications and open HashGarten.

Spotlight Search

Using Finder and the Script Menu

Go to Finder, select files and folders and choose an action from the Jacksum script folder.

Jacksum at the Finder script menu

From here HashGarten takes over, and you can calculate checksums, CRCs and hash values of the selected files.

Using Path Finder and the Script Menu

Open Path Finder, select files and folders and choose an action from the Jacksum script folder.

Jacksum at the Path Finder script menu

From here HashGarten takes over, and you can calculate checksums, CRCs and hash values of the selected files.

Using muCommander

Open muCommandere, select files and folders, right click and choose an action from the "Open with..." menu.

muCommander menu

From here HashGarten takes over, and you can calculate checksums, CRCs and hash values of the selected files.

Using Marta

Open Marta, select files and folders, select Tools -> Actions... -> Enter "Jacksum" in Search Action and choose one of the entries.

Bildschirmfoto 2024-05-23 um 21 36 38

From here HashGarten takes over, and you can calculate checksums, CRCs and hash values of the selected files.

Using the Command Line Interface (CLI)

Open a Terminal to get full access to the CLI. Now you can use all features that Jacksum provides.

% /Applications/HashGarten.app/jacksum

For more information see also Jacksum

How to configure it

Finder

Open Finder, click on the script menu, and select "Open Scripts Folder", followed by "Open Finder Scripts Folder". Alternatively hit ⇧⌘G, enter the path to the Finder scripts folder ~/Library/Scripts/Applications/Finder, and click on the Go button.

Click on Jacksum 3.7.0, and remove any .scpt file that you do not want to see.

Path Finder

Open Path Finder, click on the script menu, and select "Open Scripts Folder", followed by "Open Path Finder Scripts Folder". Click on Jacksum 3.7.0, and remove any .scpt file that you do not want to see.

muCommander

Modify the content of ~/Library/Preferences/muCommander/commands.xml to match your needs.

How to recreate all items again

Just run the Jacksum for macOS.app again.

How to uninstall it

Open a Terminal and type

% rm -rf /Applications/HashGarten.app
% rm -rf ~/Library/Scripts/Applications/Finder/Jacksum*

If Path Finder was found during installation, type

% rm -rf ~/Library/Scripts/Applications/Path\ Finder/Jacksum*

If muCommander was found during installation, type

% rm ~/Library/Preferences/muCommander/commands.xml
% cp ~/Library/Preferences/muCommander/commands.xml.before_jacksum.* ~/Library/Preferences/muCommander/commands.xml
% rm ~/Library/Preferences/muCommander/commands.xml.before_jacksum.*

If Marta was found during installation, type

% cd ~/Library/Application\ Support/org.yanex.marta/Plugins/
% rm $(grep -il jacksum *.lua | xargs)

Further Information

Show your support

Please ⭐️ this repository if this project helped you!