crcutil 2.1.1

No project description provided

CRCUtil

Portable CRC32 Checksum Tool – Generate & Compare

[!NOTE] Installation is supported only for the following:

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

Table of Contents

• Installation
• Usage
  • crc
  • diff
  • pause/resume
• Development

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

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'

---

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)
  • alt+p
    • Linux (Wayland)
• The tool can be exited at any time by pressing:
  • q
    • Windows
    • Linux (X11)
  • alt+q
    • Linux (Wayland)

Development

[!NOTE] Development requires a fully configured Dotfiles dev environment

source init.sh