rars

A Rust implementation of RAR.

Current Status

rars covers the RAR lineage from early RE~^ archives through RAR 7, compression and decompression. It's not fast, but it works. ish.

Rust API

Use the rars crate for Rust applications and libraries. Since 0.4, the lower-level rars-format, rars-codec, rars-crypto, rars-crc32, and rars-recovery crates are folded into rars; those standalone crates ended at 0.3.x. Applications should depend on rars, and command-line installs should use rars-cli.

CLI

Inspect, test, and extract archives:

rars info archive.rar
rars test archive.rar
rars x archive.rar out/

Create archives with specific RAR generation:

rars a --format rar29 archive.rar files...
rars a --format rar50 --solid --auto-filter archive.rar files...
rars a --format rar70 --store --volume-size 10m archive.part1.rar files...

The writer supports stored and compressed members, split volumes, passwords, header encryption where implemented, comments, RARVM filters, RAR5 quick-open records, and supported recovery records. Run rars --help for the exact option set.

Fast Builds

The optional fast feature enables safe portable SIMD paths for selected hot compression and decompression helpers, including LZ match scanning, x86 filter scanning, and CRC-32 updates. It uses Rust's experimental std::simd API, so it requires a nightly toolchain. Default builds do not enable this feature and remain stable-compatible.

Build or run the CLI with the fast path:

cargo +nightly run -p rars-cli --features fast -- info archive.rar
cargo +nightly build --workspace --features fast

Run the fast test and benchmark paths:

cargo +nightly test --workspace --features fast
cargo +nightly bench -p rars --bench chunk_sizes --features fast

Parallel Builds

The optional parallel feature enables Rayon worker threads for independent archive members. It parallelizes non-solid compression planning for supported writers and buffered extraction of non-solid, non-split single archives while preserving archive order for output. Solid archives and multivolume extraction fall back to the existing sequential stream because their codec state depends on member order.

Build or run the CLI with parallel workers:

cargo run -p rars-cli --features parallel -- --threads 4 a --format rar50 archive.rar files...
cargo run -p rars-cli --features parallel -- x --threads 4 archive.rar out/
cargo test --workspace --features parallel

Measure parallel archive-member work with Criterion:

cargo bench -p rars --bench parallel --features parallel
cargo +nightly bench -p rars --bench parallel --features fast,parallel

The parallel benchmark reports 1_thread and all_threads_N cases for RAR5 multi-member compression and extraction.

When --threads is omitted, rars uses all available cores. Passing --threads to a CLI built without parallel is rejected.

Python bindings

The workspace includes PyO3 bindings packaged as the rars Python module for Python 3.10 and newer. The default Python build enables the Rust parallel feature; the optional fast feature is available for nightly Rust builds only because it relies on std::simd.

maturin develop
RUSTUP_TOOLCHAIN=nightly maturin develop --features fast

The Python API exposes a rarfile-style RarFile for listing, reading, testing, and extracting archives, plus RarBuilder for creating or rewriting archives. Rewrites are staged into a new archive; existing RAR files are not edited in place.

Development

Run the test suite:

cargo test --workspace --all-targets

Generate a local coverage report:

rustup component add llvm-tools-preview
./scripts/coverage.py

The script prints a line-coverage summary, saves it to target/coverage/summary.txt, and writes HTML output to target/coverage/html/library/index.html and target/coverage/html/cli/index.html.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

rars-0.4.3-cp310-abi3-win_amd64.whl (896.1 kB view details)

Uploaded Jul 19, 2026 CPython 3.10+Windows x86-64

rars-0.4.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.0 MB view details)

Uploaded Jul 19, 2026 CPython 3.10+manylinux: glibc 2.17+ x86-64

rars-0.4.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (953.0 kB view details)

Uploaded Jul 19, 2026 CPython 3.10+manylinux: glibc 2.17+ ARM64

rars-0.4.3-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl (1.9 MB view details)

Uploaded Jul 19, 2026 CPython 3.10+macOS 10.12+ universal2 (ARM64, x86-64)macOS 10.12+ x86-64macOS 11.0+ ARM64

File details

Details for the file rars-0.4.3-cp310-abi3-win_amd64.whl.

File metadata

Download URL: rars-0.4.3-cp310-abi3-win_amd64.whl
Upload date: Jul 19, 2026
Size: 896.1 kB
Tags: CPython 3.10+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rars-0.4.3-cp310-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`83e745ff54142ed3ec97b11726505bcf434d24a50093147e5c354d88418e13e3`
MD5	`f2866e7a92b97d1c4d402ead375ab912`
BLAKE2b-256	`9f28c16bd1afc7bddb4e932c12cd4cce4366962aa4756c096a1a43d840e9fb9e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rars-0.4.3-cp310-abi3-win_amd64.whl:

Publisher: release.yml on bitplane/rars

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rars-0.4.3-cp310-abi3-win_amd64.whl
- Subject digest: 83e745ff54142ed3ec97b11726505bcf434d24a50093147e5c354d88418e13e3
- Sigstore transparency entry: 2197669977
- Sigstore integration time: Jul 19, 2026
Source repository:
- Permalink: bitplane/rars@96eba4a6123633ac1700076deb44aa418a8f05dc
- Branch / Tag: refs/tags/v0.4.3
- Owner: https://github.com/bitplane
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@96eba4a6123633ac1700076deb44aa418a8f05dc
- Trigger Event: push

File details

Details for the file rars-0.4.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: rars-0.4.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 19, 2026
Size: 1.0 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rars-0.4.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`b7ad367f35165e4a2bea4cd392904e5b96503893378d50ae3ea8aeb21772b99f`
MD5	`9ca995a336ec7275517b4074df23933c`
BLAKE2b-256	`59e8dcf9528c9151be8ab9d039955762390024174cf45f3babea58ced7e233b0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rars-0.4.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on bitplane/rars

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rars-0.4.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: b7ad367f35165e4a2bea4cd392904e5b96503893378d50ae3ea8aeb21772b99f
- Sigstore transparency entry: 2197670391
- Sigstore integration time: Jul 19, 2026
Source repository:
- Permalink: bitplane/rars@96eba4a6123633ac1700076deb44aa418a8f05dc
- Branch / Tag: refs/tags/v0.4.3
- Owner: https://github.com/bitplane
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@96eba4a6123633ac1700076deb44aa418a8f05dc
- Trigger Event: push

File details

Details for the file rars-0.4.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: rars-0.4.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Jul 19, 2026
Size: 953.0 kB
Tags: CPython 3.10+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rars-0.4.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`e35bbec5a884ff6d35ebe7f2731cc7ce2af4c4d5c558b281f78505c92d0b5ef1`
MD5	`8437fdede37a81d3e0f9a13abf7f012b`
BLAKE2b-256	`78c77be57d9af12c87414d2141bfa14de8372b59e3a170e19002d81762cd2b91`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rars-0.4.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on bitplane/rars

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rars-0.4.3-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: e35bbec5a884ff6d35ebe7f2731cc7ce2af4c4d5c558b281f78505c92d0b5ef1
- Sigstore transparency entry: 2197669517
- Sigstore integration time: Jul 19, 2026
Source repository:
- Permalink: bitplane/rars@96eba4a6123633ac1700076deb44aa418a8f05dc
- Branch / Tag: refs/tags/v0.4.3
- Owner: https://github.com/bitplane
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@96eba4a6123633ac1700076deb44aa418a8f05dc
- Trigger Event: push

File details

Details for the file rars-0.4.3-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl.

File metadata

Download URL: rars-0.4.3-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Upload date: Jul 19, 2026
Size: 1.9 MB
Tags: CPython 3.10+, macOS 10.12+ universal2 (ARM64, x86-64), macOS 10.12+ x86-64, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rars-0.4.3-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Algorithm	Hash digest
SHA256	`d56884ec8206f80853a5113c7555d2caf9645d7c938daef55c242c205d3edb7d`
MD5	`d0cdefd7fb2e817f03d50793712128a8`
BLAKE2b-256	`4944ea92c6c412576a2e9961f1574d46dc7b2ff8affb44899d1d0ff0842bf19a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rars-0.4.3-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl:

Publisher: release.yml on bitplane/rars

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rars-0.4.3-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
- Subject digest: d56884ec8206f80853a5113c7555d2caf9645d7c938daef55c242c205d3edb7d
- Sigstore transparency entry: 2197670190
- Sigstore integration time: Jul 19, 2026
Source repository:
- Permalink: bitplane/rars@96eba4a6123633ac1700076deb44aa418a8f05dc
- Branch / Tag: refs/tags/v0.4.3
- Owner: https://github.com/bitplane
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@96eba4a6123633ac1700076deb44aa418a8f05dc
- Trigger Event: push