Skip to content

Installation program to add Jacksum (CLI) and HashGarten (GUI) to macOS. It also adds functions to Finder and other file managers.

License

Notifications You must be signed in to change notification settings

jonelo/jacksum-for-macos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 moree. See the Jacksum page for more info.

The installation program installs

  • Jacksum which is the hash engine, it also provides the command line interface (CLI)
  • HashGarten which is a standalone graphical user interface (GUI) for Jacksum
  • script glue to call Jacksum and HashGarten from your preferred file manager

See also the Architeture of interaction between those components.

System Requirements

Hardware

  • Intel Mac (x64) or Apple silicon (aarch64)
  • 150 MiB disk space

Software

  • macOS 10.11 (El Capitan) or later, tested up to macOS 14.4.1 (Sonoma)
  • optional: a supported file manager (see below) to call Jacksum and HashGarten from your flie manager

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.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

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)

Developers Notes

How to create the .app and .dmg

1. Download and install the Platypus command line tool

The .app will be created by the Platypus command line tool. Platypus is a great tool create Mac apps from command line scripts. Go to https://sveinbjorn.org/platypus, download and open Platypus, select "Settings..." from the Platypus menu and install the command line tool.

2. Clone the sources

Clone or download the sources from the GitHub project:

% git clone https://github.com/jonelo/jacksum-for-macos.git
% cd jacksum-for-macos/

Note: if you haven't installed git yet, Apple's Install Command Line Developer Tools will install it for you.

3. Build both the .app and the .dmg

Open a Terminal and run

% ./bin/make_all.sh

That will build the .app and wrap it in a .dmg. You find both the .app and the .dmg in the folder called ./output/.

4. Open the .dmg and test the .app

% open ./output/*.dmg

Interna of the installation app

The core of the Jacksum for macOS.app is a bash script that installs both HashGarten and Jacksum to the Finder's Script Menu (and other file managers it can detect) by creating applescript scripts (in case of Finder and Path Finder), and compiling those on the system during the installation using osacompile.

The installation script requires Mac OS X 10.4 (Tiger) or later to run. The script does not require admin privileges. Credits: the installer app has been created by Platypus, a great app to wrap shell scripts into a macOS app.

Once the script has been compiled by Platypus, the installer app requires macOS 10.11 or later. The script source can be revealed again by typing

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

The source code of the generated and compiled applescripts can be relealed again by opening the .scpt files (located in the appropriate sccript folders) usiing the Apple Script Editor or osadecompile.

Further Information

Show your support

Please ⭐️ this repository if this project helped you!