Jacksum for macOS
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.
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.
How to use it
Using HashGarten
Open the Spotlight Search and search for HashGarten or go to Applications and open HashGarten.
Using Finder and the Script Menu
Go to Finder, select files and folders and choose an action from the Jacksum script folder.
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.
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.
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.
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
- https://jacksum.net
- https://github.com/jonelo/jacksum
- https://github.com/jonelo/jacksum/wiki/Architecture
Show your support
Please ⭐️ this repository if this project helped you!