README
------

Hash v. 1.3.3
By Sriranga Veeraraghavan <[email protected]>

Homepage:

    https://github.com/srirangav/Hash

About:

    Hash is a MacOSX application to generate and verify the
    hash, crc, or checksum of a file.

    By default, Hash runs in a "simple" mode that supports
    the following hashes:

        MD5
        SHA1
        SHA256
        SHA512
        RIPEMD 160
        BLAKE3

    In the full mode, the following hash functions are
    supported:

        MD5
        SHA1
        SHA1 DC (SHA1 with collision detection / protection)
        SHA2 (SHA224, SHA256, SHA384, SHA512)
        SHA3/SHAKE (128, 224, 256, 384, 512)
        RIPEMD (160, 320)
        KangarooTwelve / K12 (256, 384, 512)
        Whirlpool
        BLAKE (224, 256, 384, 512)
        BLAKE2 (BLAKE2S 256; BLAKE2B 256, 512)
        BLAKE3
        Skein (256-256, 512-256, 512-512, 1024-256, 1024-512)
        MD6 (256, 512)
        JH (224, 256, 384, 512)
        Groestl (224, 256, 384, 512)
        Tiger, Tiger2
        HAS-160
        Snefru (128, 256)
        LSH (224, 256, 384, 512)

Installation:

    Copy Hash.app to /Applications (or wherever you prefer)

Known Issues:

    1. If the "Hash It!" contextual menu item doesn't show up in
       the Finder:

       a. Open System Preferences (or System Settings)
       b. Select Keyboard
       c. Click on Keyboard Shortcuts
       d. Select Services
       e. Select Files and Folders in the list
       f. Click the checkbox next to "Hash It!" to enable it

Supported MacOSX versions:

    v. 1.2.0 onwards      - 10.13+
    v. 1.0.15 - 1.0.25    - 10.9+
    v. 1.0.14 and earlier - 10.6+

License:

    Please see LICENSE.txt

History:

    v. 1.3.3  - Update to BLAKE3 v.1.5.4
    v. 1.3.2  - Update to BLAKE3 v.1.5.2
    v. 1.3.1  - Update to BLAKE3 v.1.5.1
    v. 1.3.0  - Implement a simple mode that shows only the most
                commonly used hashes (MD5, SHA1, SHA256, SHA512,
                RIPEMD 160, and BLAKE3)
    v. 1.2.2  - Update to BLAKE3 v.1.5.0, add support for AArch64
                optimized BLAKE3
    v. 1.2.1  - Update to BLAKE3 v.1.4.0
    v. 1.2.0  - Update to BLAKE3 v.1.3.3, updates for XCode 14.1
    v. 1.1.25 - Build on Monterey (MacOSX 12.x)
    v. 1.1.24 - Add support for KangarooTwelve / K12
    v. 1.1.23 - Synchronize preferences window with saved preferences
                on application startup
    v. 1.1.22 - Try to adopt #include/#import discipline for .h files
                (see https://doc.cat-v.org/bell_labs/pikestyle)
    v. 1.1.21 - Build using Xcode 13
    v. 1.1.20 - Added progress bar to dock icon
    v. 1.1.19 - Update to BLAKE3 v.1.3.1
    v. 1.1.18 - Update to BLAKE3 v.1.3.0
    v. 1.1.17 - Update to BLAKE3 v.1.2.0
    v. 1.1.16 - Show the name of the selected hash and file
                above the progress bar
    v. 1.1.15 - Update to BLAKE3 v.1.1.0, add option to show
                file size after the hash
    v. 1.1.14 - Update help pages
    v. 1.1.13 - Update to BLAKE3 v.1.0.0
    v. 1.1.12 - Add basic help support
    v. 1.1.11 - Update to BLAKE3 v.0.3.8, add LSH (224, 256,
                384, 512)
    v. 1.1.10 - Add preference pane
    v. 1.1.9  - Add support for BLAKE3
    v. 1.1.8  - Build on Big Sur, add SHAKE128 & SHAKE256
    v. 1.1.7  - Added support for checking the length of the
                verification hash
    v. 1.1.6  - Added a menu item to toggle lower case output
    v. 1.1.5  - Added support for Snefru (128, 256)
    v. 1.1.4  - Added SHA1 collision detection
    v. 1.1.3  - Added finder service to hash a selected file
    v. 1.1.2  - Added support for JH (224, 256, 384, 512),
                Tiger/Tiger2, BLAKE (224, 256, 384, 512),
                GROESTL (224, 256, 384, 512)
    v. 1.1.1  - Enabled MD6
    v. 1.1.0  - Added support for dark mode
    v. 1.0.15 - Updated for app notarizing
    v. 1.0.14 - Enabled app sandbox and hardened runtime
    v. 1.0.12 - Added support for MD6 (256, 512)
    v. 1.0.11 - Added support for BLAKE2, Skein, SHA224,
                SHA384, SHA3
    v. 1.0.10 - Initial GitHub Release

References:

    CRC/checksum - https://en.wikipedia.org/wiki/Cyclic_redundancy_check
                   https://en.wikipedia.org/wiki/Checksum
    MD5          - RFC 1321 (https://tools.ietf.org/html/rfc1321)
    SHA1         - https://en.wikipedia.org/wiki/SHA-1
    SHA1 DC      - https://github.com/cr-marcstevens/sha1collisiondetection
    SHA2         - https://en.wikipedia.org/wiki/SHA-2
    SHA3/SHAKE   - https://keccak.team/
                   https://en.wikipedia.org/wiki/SHA-3
                   https://www.di-mgt.com.au/sha_testvectors.html
    RIPEMD       - https://homes.esat.kuleuven.be/~bosselae/ripemd160.html
                   https://en.wikipedia.org/wiki/RIPEMD
    Whirlpool    - https://en.wikipedia.org/wiki/Whirlpool_(hash_function)
    BLAKE        - https://131002.net/blake/
                   https://github.com/veorq/BLAKE
                   https://en.wikipedia.org/wiki/BLAKE_%28hash_function%29
                   https://asecuritysite.com/encryption/blake
    BLAKE2       - RFC 7693 (https://tools.ietf.org/html/rfc7693)
                   https://blake2.net/
                   https://github.com/BLAKE2/BLAKE2
                   https://en.wikipedia.org/wiki/BLAKE_(hash_function)#BLAKE2
    BLAKE3       - https://github.com/BLAKE3-team/BLAKE3
    Skein        - https://en.wikipedia.org/wiki/Skein_(hash_function)
    MD6          - https://en.wikipedia.org/wiki/MD6
                   https://lib.rs/crates/md6
    JH           - https://www3.ntu.edu.sg/home/wuhj/research/jh/index.html
                   https://en.wikipedia.org/wiki/JH_(hash_function)
    Groestl      - https://www.groestl.info/
                   https://en.wikipedia.org/wiki/Gr%C3%B8stl
    Tiger/Tiger2 - https://www.cs.technion.ac.il/~biham/Reports/Tiger/
                   https://en.wikipedia.org/wiki/Tiger_(hash_function)
                   https://github.com/rhash/RHash
    HAS-160      - https://www.randombit.net/has160.html
                   https://github.com/rhash/RHash
    Snefru       - https://en.wikipedia.org/wiki/Snefru
                   https://github.com/rhash/RHash
    LSH          - https://seed.kisa.or.kr/kisa/Board/22/detailView.do
                 - https://en.wikipedia.org/wiki/LSH_(hash_function)
    K12          - https://github.com/XKCP/K12