v2.1.0

Author: jonelo

README.md

@@ -2,43 +2,57 @@
 
 # Jacksum File Browser Integration on macOS
 
-## Abstract
+<img alt="Jacksum_3.7.0_Finder_Integration" src="docs/images/Jacksum_3.7.0_Finder_Integration.png" >
 
-Allows macOS users to calculate hash values of their files and folders in Finder, just by selecting the algorithm of choice from the script menu. The Finder integration is **powered by Jacksum** which provides **470 algorithms**.
+## Abstract
 
-See also [https://jacksum.net](https://jacksum.net) and [https://github.com/jonelo/jacksum](https://github.com/jonelo/jacksum)
+Allows macOS users to calculate hash values of their files and folders in Finder,
+just by selecting the algorithm of choice from the script menu.
+The Finder integration is powered both
+**[Jacksum](https://github.com/jonelo/jacksum)** (the engine) and
+**[HashGarten](https://github.com/jonelo/HashGarten)** (the GUI).
 
+See also [https://jacksum.net](https://jacksum.net).
 
 ## System Requirements
 
-- OS X 10.8 (Mountain Lion) or later, tested up to macOS 12.2 (Ventura)
+- OS X 10.8 (Mountain Lion) or later, tested up to macOS 14.4.1 (Sonoma)
 - Finder
 - JDK 11 or later, see also [https://adoptium.net](https://adoptium.net)
-- 2 MiB disk space for Jacksum
-- 4 MiB disk space for all .scpt files
+- 2 MiB disk space for Jacksum and HashGarten
 
 ## Quick Start
 
 ### How to install it
 
-- Download and install a Java Development Kit (JDK), go to [https://adoptium.net](https://adoptium.net)
-- Activate the Apple Script Menu, see also [https://support.apple.com/en-tm/guide/script-editor/scpedt27975/mac](https://support.apple.com/en-tm/guide/script-editor/scpedt27975/mac)
-- Download and open the [.dmg](https://github.com/jonelo/jacksum-fbi-macos/releases/latest), and double click on the .app
+#### Download and install a Java Development Kit (JDK)
+
+Go to [https://adoptium.net](https://adoptium.net)
+
+#### Activate the Apple Script Menu
+
+See also [https://support.apple.com/en-us/guide/script-editor/scpedt27975/mac](https://support.apple.com/en-us/guide/script-editor/scpedt27975/mac)
+
+<img height="462" alt="Apple Script Menu activated" src="docs/images/AppleScriptMenuActivated.png">
 
-<p align="center">
-  <img src="docs/images/Jacksum 3.0.0 FBI on macOS during installation.png" width="629" alt="Jacksum 3.0.0 FBI on macOS during installation">
-</p>
+#### Download and open the .dmg
 
+Download and open the [.dmg](https://github.com/jonelo/jacksum-fbi-macos/releases/latest),
+
+#### Open on the .app
+
+<img alt="Open the Jacksum Finder Integration app" src="docs/images/JacksumFinderIntegrationOpen.png">
 
 ### How to use it
 
 #### Using Finder and the script menu
 
-Go to Finder, select files and folders and choose an algorithm from the script folder called "Jacksum 3.5.0" in order to calculate checksums, CRCs and hash values of the selected files.
+Go to Finder, select files and folders and choose an action from the script folder called "Jacksum 3.7.0"
+pass those paths to HashGarten where you can calculate checksums, CRCs and hash values of the selected files.
+
+<img height="353" alt="Jacksum at the Script Menu" src="docs/images/JacksumAtTheScriptMenu.png">
 
-<p align="center">
-  <img src="docs/images/Jacksum 3.0.0 at the script menu.png" width="413" alt="Jacksum 3.0.0 at the script menu">
-</p>
+From here [HashGarten](https://github.com/jonelo/HashGarten) takes over.
 
 #### Using the command line interface
 
@@ -48,14 +62,14 @@ Open a Terminal, and use all features that Jacksum provides.
 $ /Applications/Jacksum/jacksum
 ```
 
-### How to configure it
+For more information see also [Jacksum](https://github.com/jonelo/jacksum)
 
-#### Limit the number of algorithms
+### How to configure it
 
 Open Finder, hit ⇧⌘G, enter the path to the Finder scripts folder `~/Library/Scripts/Applications/Finder`, and click on the Go button.
-Click on `Jacksum 3.5.0`, and remove any .scpt file that you don't wanna see.
+Click on `Jacksum 3.7.0`, and remove any .scpt file that you do not want to see.
 
-#### Recreate all algorithms
+### How to recreate all items again
 
 Just run the .app again.
 
@@ -96,10 +110,10 @@ Open a terminal and run
 That will build the .app and wrap it in a .dmg. You find both the .app and the .dmg in the folder called ./output/.
 
 ```
-open ./ouutput/*.dmg
+open ./output/*.dmg
 ```
 
 ### How does that all work?
 
-The core of the .app is bash script that installs Jacksum's primary features to macOS Finder's Script Menu by creating applescript scripts and compiling those on the system during the installation.
+The core of the .app is bash script that installs calls to HashGarten and Jacksum to macOS Finder's Script Menu by creating applescript scripts and compiling those on the system during the installation.
 

docs/images/AppleScriptMenuActivated.png

@@ -1,7 +1,7 @@
 #!/bin/bash
 # 
 #  Jacksum File Browser Integration for macOS
-#  Copyright (c) 2010-2023 Dipl.-Inf. (FH) Johann N. Loefflmann
+#  Copyright (c) 2010-2024 Dipl.-Inf. (FH) Johann N. Loefflmann
 #
 #  This program is free software; you can redistribute it and/or modify
 #  it under the terms of the GNU General Public License as published by
@@ -75,7 +75,7 @@ else
 fi
 mkdir -p "$SCRIPTS"
 #ALGORITHMS="$(/Applications/Jacksum/jacksum -a all --list)"
-COMMANDS="cmd_calc;1)_Calc_hash_values cmd_check;2)_Check_data_integrity cmd_cust;3)_Customized_output cmd_edit;4)_Edit_script cmd_help;5)_Help"
+COMMANDS="cmd_calc;1)_Calc_hash_values cmd_check;2)_Check_data_integrity cmd_cust;3)_Customized_output cmd_edit;4)_Edit_script"
 
 TOTALCOUNT=$(echo "$COMMANDS" | wc -l)
 FINISHED=0
@@ -122,14 +122,18 @@ done
 
 cat << EOL
 
-Jacksum has been integrated into the Finder's script menu.
+Jacksum and HashGarten have been integrated
+into the Finder's script menu.
 
-Make sure that you have activated the Apple Script Menu. Starting with
-Mac OS X 10.6 (Snow Leopard), the Script Menu preferences are at the Apple 
-Script-Editor's preferences, in the General tab.
+Make sure that you have activated the Apple
+Script Menu. Starting with Mac OS X 10.6
+(Snow Leopard), the Script Menu preferences
+are at the Apple Script-Editor's preferences,
+in the General tab.
 
-Go to Finder, select one or more files and directories and choose an entry
-from the script directory called Jacksum.
+Go to Finder, select files and directories and
+choose an entry from the script directory
+called "Jacksum 3.7.0".
 
 Done.
 EOL

docs/images/Jacksum 3.0.0 FBI on macOS during installation.png

@@ -1,7 +1,7 @@
 #!/bin/bash
 #
 # Jacksum File Browser Integration Script, https://jacksum.net
-# Copyright (c) 2006-2023 Johann N. Loefflmann, https://johann.loefflmann.net
+# Copyright (c) 2006-2024 Johann N. Loefflmann, https://johann.loefflmann.net
 # Code has been released under the conditions of the GPLv3+.
 #
 
@@ -15,7 +15,7 @@ ERROR_LOG="/tmp/jacksum-error.txt"
 CHECK_FILE="/tmp/jacksum-check.txt"
 JAVA="java"
 JACKSUM_JAR="/Applications/Jacksum/jacksum-3.7.0.jar"
-HASHGARTEN_JAR="/Applications/Jacksum/HashGarten-0.14.0.jar"
+HASHGARTEN_JAR="/Applications/Jacksum/HashGarten-0.16.0.jar"
 SCRIPT="/Applications/Jacksum/jacksum.sh"
 
 cat /dev/null > "$FILE_LIST"
@@ -44,35 +44,13 @@ case $ALGO in
 
   "cmd_calc")
     "${JAVA}" -jar "${HASHGARTEN_JAR}" --header -O relative -U ${ERROR_LOG} --file-list-format list --file-list ${FILE_LIST} --path-relative-to-entry 1 --verbose default,summary
-    rm relative > /dev/null 2>&1
-    if [ $? -eq 0 ]
-    then
-      # Generate an output that contains both stdout and stderr in a file for the viewer
-      # CHECK_FILE contains the output file name that the user has been specified at the GUI
-
-      CHECK_FILE=$(grep gui.output $HOME/.HashGarten.properties)
-      # We need to strip the key called gui.output= and undo any escapes done by Java''s properties API
-      CHECK_FILE=${CHECK_FILE#*=}
-
-      cat ${CHECK_FILE} ${ERROR_LOG} > ${OUTPUT}
-      viewer "${OUTPUT}"
-    fi
     ;;
 
   "cmd_check")
-    if [ ! -f relative ]; then
-      touch relative
-    fi
     "${JAVA}" -jar "${HASHGARTEN_JAR}" --header -c relative -O ${OUTPUT} -U ${OUTPUT} --file-list-format list --file-list ${FILE_LIST} --path-relative-to-entry 1 --verbose default,summary
-    rm relative > /dev/null 2>&1
-    if [ $? -eq 0 ]; then
-      viewer "${OUTPUT}"
-    fi
     ;;
 
-
   "cmd_cust")
-    cat /dev/null > "${OUTPUT}"
     ALGOS="md5+sha1+ripemd160+tiger+\
 sha256+sha512/256+sha3-256+shake128+ascon-hash+sm3+streebog256+kupyna-256+lsh-256-256+blake3+k12+keccak256+\
 sha512+sha3-512+shake256+streebog512+kupyna-512+lsh-512-512+blake2b-512+keccak512+m14+skein-512-512+whirlpool"
@@ -140,4 +118,3 @@ legacy message digests (avoid if possible):
     ;;
 
 esac
-

docs/images/Jacksum 3.0.0 at the script menu.png

@@ -9,10 +9,10 @@ For more information about Jacksum please go to https://jacksum.net
 How do I install the "Jacksum Finder Integration"?
 --------------------------------------------------
 In order to install Jacksum's primary features to Finder,
-just double-click on the icon to run the installer.
+and open the app to run the installer.
 
 The installer requires Mac OS X 10.11 (El Capitan) or later.
-It has been tested up to macOS 13.2 (Ventura).
+It has been tested up to macOS 14.4.1 (Sonoma).
 
 The first time you do run the installer you may need to override
 your GateKeeper settings. See also https://support.apple.com/en-us/HT202491
@@ -38,12 +38,11 @@ a great app to wrap scripts into an app, see also https://sveinbjorn.org/platypu
 How to calculate a CRC/checksum/hash value using Jacksum?
 ---------------------------------------------------------
 After you have installed Jacksum by the Jacksum Finder Integration, you can
-go to Finder, select one or more files, one or more folders and choose an
-algorithm from the script folder called Jacksum in order to calculate checksums
-for the files.
+go to Finder, select files and folders and choose an entry from the script
+folder called Jacksum in order to calculate checksums for the files.
 
 Alternatively, you can also do it on the commandline. Jacksum is installed in
-/Applications/Jacksum by the installer and you can call jacksum on the command 
+/Applications/Jacksum by the installer, and you can call jacksum on the command
 line by typing
 
 $ /Applications/Jacksum/jacksum
@@ -55,7 +54,7 @@ Jacksum and HashGarten require Java to run, so you have to install a JDK.
 You can get it for free for example at https://adoptium.net (recommended)
 or http://jdk.java.net/
 
-Also please make sure that you have activated the Apple Script Menu.
+Also, please make sure that you have activated the Apple Script Menu.
 The Script Menu preferences are at the Apple Script-Editor's preferences,
 in the General tab.
 

docs/images/JacksumAtTheScriptMenu.png

@@ -1,5 +1,10 @@
 Release Notes
 -------------
+2.1.0, Apr 6, 2024
+- bundled Jacksum 3.7.0, and HashGarten 0.16.0
+- removed the Help menu under the Jacksum script directory, because the GUI provides
+  Help from now on.
+
 2.0.0, Sep 17, 2023
 - bundled Jacksum 3.7.0, and HashGarten 0.14.0
 - files/directories are passed from Finder to HashGarten (which is a graphical user

docs/images/JacksumFinderIntegrationOpen.png

@@ -1,2 +1,2 @@
 APP_VERSION=3.7.0
-DMG_VERSION=2.0.0
+DMG_VERSION=2.1.0

docs/images/Jacksum_3.7.0_Finder_Integration.png

@@ -4,5 +4,5 @@ APP_AUTHOR="Johann N. Löfflmann"
 APP_BUNDLE_ID=net.loefflmann.johann.JacksumFinderIntegration
 APP_LICENSE_FILE=license.txt
 APP_JAR_FILE="jacksum-${APP_VERSION}.jar"
-APP_JAR_FILE_HASHGARTEN="HashGarten-0.14.0.jar"
-APP_JAR_FILE_FLATLAF="flatlaf-3.2.jar"
+APP_JAR_FILE_HASHGARTEN="HashGarten-0.16.0.jar"
+APP_JAR_FILE_FLATLAF="flatlaf-3.4.1.jar"