thombles/hashgood

CLI tool for easily verifying a downloaded file's checksum

hashgood

A CLI tool for easily verifying a downloaded file's checksum.

Wouldn't it be nice if your computer compared the hash for you?

Read the MD5, SHA1 or SHA256 hash from:

• Command line argument
• SHASUMS-style check files (-c)
• Raw hash in a file/STDIN (-c)
• The clipboard (-p)

...or just run hashgood against the input and receive all three at once.

This program arose from dissatisfaction with the workarounds required for traditional tools.

Installing

If you have a working Rust toolchain you can install hashgood from crates.io:

cargo install hashgood --features paste

Pre-compiled binaries for common platforms can be downloaded from the releases page. Otherwise you can build it yourself; see the next section.

Compiling

hashgood targets stable Rust. With a Rust toolchain installed, clone the repository and run:

cargo build --release

Take the compiled executable from target/release/hashgood.

To include support for pasting from the clipboard with -p, specify the extra feature. Note that on Linux this requires several extra libraries: libxcb1-dev libxcb-xfixes0-dev libxcb-shape0-dev libxcb-render0-dev

cargo build --release --features paste

Goals

• Be forgiving and deliver what the user wants with a minimum of fuss. They just want to check this hash, damnit.
• Don't let users be tricked - be explicit about checksum types and the sources of those checksums that are being compared.
• As much cross-platform support as is practical.

Non-goals

• Scriptability. This is an interactive tool.
• Support for any unusual scenarios that could compromise smooth operation. (e.g., text mode, uncommon hash types)

Future ideas

• Nominate a default (downloads) directory and auto-select the most recently created file in that directory as input.

hashgood's Issues

Consider publishing hashgood to crates.io

This will allow to build from source with:
cargo install hashgood

Include Releases

Hey first i want to say that tool is awesome.
I wrote one for myself in python and then I found yours, and it is perfect for the job! Probs on that.

But maybe for the not so technical users out there, it maybe would be cool to include releases for the standard plattforms.

I needed like 20 Minutes to compile this, because on Windows you need to install the VisualStudio Build tools to get the rust compiler running, which takes forever.

Keep the amazing work up

arm64 releases

Hello! Thank you for this program, much appreciated!
Would it be possible for you to also add arm64 binaries in the release page?

failinig result results in zero exit code

λ hashgood hashgood.exe 0259a0454b88d92984edf4e1413d643073537a0ec98f78db44e8d8320236faca
hashgood.exe / SHA-256
0259a0454b88d92984edf4e1413d643073537a0ec98f78db44e8d8320236fac5
0259a0454b88d92984edf4e1413d643073537a0ec98f78db44e8d8320236faca
command line argument

Result: FAIL

λ echo %errorlevel%
0