Skip to main content

Altium Cruncher

Command-line tools for working with Altium projects, schematics, boards and libraries on Windows, macOS and Linux. Export SVGs, generate BOM and pick-and-place files, extract library assets, and inspect or modify designs.

Install uv

uv installs the application and manages its Python runtime and dependencies.

On Windows, open PowerShell and run:

powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"

On macOS or Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your terminal after installing uv.

Install Altium Cruncher

To install the published package:

uv tool install altium-cruncher
uv tool update-shell

To install directly from GitHub, with Git installed:

uv tool install --force "git+https://github.com/wavenumber-eng/altium_cruncher.git@main"
uv tool update-shell

For a specific branch, tag or commit, replace main in the URL with that reference. Both installation methods provide the same command names: altium-cruncher and its shorter alias, acr.

Open a new terminal if the command is not found, then verify the installation:

acr version
acr --help

Update

For an installation from PyPI:

uv tool upgrade altium-cruncher

For an installation from a GitHub branch, rerun the install command with --reinstall-package to refresh the source:

uv tool install --force --reinstall-package altium-cruncher "git+https://github.com/wavenumber-eng/altium_cruncher.git@main"

Use the same branch reference you selected when installing.

Use

Get help for any command:

acr pcb-svg --help
acr bom --help

For example, export a board SVG or a project BOM:

acr pcb-svg board.PcbDoc
acr bom project.PrjPcb

See the command guide for the complete command list and links to individual usage instructions. Some commands, such as launching Altium Designer and running OutJobs, require Altium Designer on Windows.

Uninstall

uv tool uninstall altium-cruncher

Documentation

Altium Cruncher is licensed under AGPL-3.0-or-later.

Release files for altium-cruncher 2026.9.12

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

Source distribution (sdist)

Source distribution for altium-cruncher 2026.9.12
File Size Uploaded
altium_cruncher-2026.9.12.tar.gz 88.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for altium-cruncher 2026.9.12
File Interpreter ABI Platform
altium_cruncher-2026.9.12-py3-none-any.whl Python 3 none any Details

Total release size: 89.5 MB

Release files / altium_cruncher-2026.9.12.tar.gz

Download URL altium_cruncher-2026.9.12.tar.gz
Size 88.9 MB
Tags Source
SHA-256 checksum
How to use checksums
28e22459b1918d96ad23b4c3993a5ebb61b9d70dbff99a1ae5bd20b9c713f3d5
BLAKE2b-256 checksum
How to use checksums
1e860f39d584cb190455019f10d7e3ec149769fb53dcf8daf7c5a71e202ed797
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.

Transparency log

Release files / altium_cruncher-2026.9.12-py3-none-any.whl

Download URL altium_cruncher-2026.9.12-py3-none-any.whl
Size 614.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a6b476cf32fd3c13d12646e7e2930593d9ae694a9146096ac8a11f0233e4c413
BLAKE2b-256 checksum
How to use checksums
d113e5d964173b630ac43d769193e2f6a5e2bbfc2f7392081b370ba35f6260d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 13, 2026.

Transparency log
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