Skip to main content

CRCutil

Portable CRC32 Checksum Tool – Generate & Compare

PyPI Version Python Platform PyPI Status CLI

[!NOTE] Installation is supported for the following:

  • Windows (amd64)
  • Linux (amd64)
    • X11
    • Wayland
  • MacOS (arm64)

Table of Contents

Installation

[!NOTE]

  • Requires Python 3.11+

Windows & Linux (X11)

pip install crcutil

Linux (Wayland)

[!CAUTION]

  • This will add your user to the input group and immediately log you out.
  • This makes it possible in Wayland to track keyboard presses; necessary for the playback controls
pip install crcutil
sudo usermod -aG input $USER
sudo pkill -u $USER

MacOS

[!NOTE]

  • Enable Accesibility Access for the Terminal on System Settings > Privacy & Security > Accessibility
  • This makes it possible in MacOS to track keyboard presses; necessary for the playback controls
pip install crcutil

Usage

crc

Generate CRC32 checksums

[!NOTE]

  • This will output a crc.json file in the supplied -o argument.
  • If no -o supplied a crc.json is created in the current directory.
  • If a crc.json already exists in the current directory, a crc2.json is created.
crcutil crc -l 'C:\path_to_traverse' -o 'C:\path_to_output.json'

[!TIP]

  • Make CRCutil run faster by disabling playback controls -f
crcutil crc -f -l 'C:\path_to_traverse'

diff

Diff output can be generated from 2 separate crc files

[!NOTE]

  • This will compare both crc files and output a diff.json in the supplied -o argument.
  • If no -o supplied a diff.json is created in the current directory.
  • If no -l supplied it will look for a crc.json and crc2.json in the current directory
crcutil diff -l 'C:\crc1.json' 'C:\crc2.json' -o 'C:\diff.json'

Pause/Resume

[!CAUTION] The crc can only be resumed as long as the contents/structure of the traversed location have not changed

[!NOTE] To resume a crc after exiting, pass the location of the existing crc to the -o flag
i.e: crcutil crc -l 'C:\path_to_traverse' -o 'C:\existing_crc.json'

  • The tool can be paused/resumed at any time by pressing:
    • p
      • Windows
      • Linux (X11)
      • MacOS
    • alt+p
      • Linux (Wayland)
  • The tool can be exited at any time by pressing:
    • q
      • Windows
      • Linux (X11)
      • MacOS
    • alt+q
      • Linux (Wayland)

Logs

[!NOTE] Logs can be found in:

  • Windows -> C:\Users\User\Documents\crcutil\log
  • Linux -> $XDG_STATE_HOME/crcutil/log
  • MacOS -> ~/Library/Application Support/crcutil/log

Development

[!NOTE] Only Ubuntu environments supported

source init.sh

Known Issues

  • Playback controls on remote graphical sessions (NX, VNC, RDP, etc...) are not currently supported.

License

GNU GPLv3

Metadata

Release files for crcutil 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crcutil 3.0.0
File Size Uploaded
crcutil-3.0.0.tar.gz 61.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for crcutil 3.0.0
File Interpreter ABI Platform
crcutil-3.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 114.6 kB

Release files / crcutil-3.0.0.tar.gz

Download URL crcutil-3.0.0.tar.gz
Size 61.2 kB
Tags Source
SHA-256 checksum
How to use checksums
7d0fa53ab5171267e7d1271862002f7ccacfda85a7417812cbb5d08a7db0ef2e
BLAKE2b-256 checksum
How to use checksums
43865406db7a262d3140a56c43497342a0bf60084f5a9e223b1c6ede7e1fba75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release files / crcutil-3.0.0-py3-none-any.whl

Download URL crcutil-3.0.0-py3-none-any.whl
Size 53.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b338ee0cb64e7f8fb80127586ae2f28b1a54992fcaa2369ea06835cfaec19761
BLAKE2b-256 checksum
How to use checksums
84af46df4f6f8d9c705ffd5154f9aa8efedfc94b8ead5a6366c1e6af8178bd59
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release history Release notifications | RSS feed

This release

3.0.0 This release

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.6

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page