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.25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| altium_cruncher-2026.9.25.tar.gz | 9.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| altium_cruncher-2026.9.25-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.9 MB
Release files / altium_cruncher-2026.9.25.tar.gz
| Download URL | altium_cruncher-2026.9.25.tar.gz |
|---|---|
| Size | 9.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
101d5783bf8a549eee8786c403810ec8caec28878e2d995366606e1fa2dcc885
|
|
BLAKE2b-256 checksum How to use checksums |
8ccb5bb398cc8440c45e95c0009b3e99caf32149d9ff570e70c6670b631a259b
|
| 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 25, 2026.
Transparency logRelease files / altium_cruncher-2026.9.25-py3-none-any.whl
| Download URL | altium_cruncher-2026.9.25-py3-none-any.whl |
|---|---|
| Size | 693.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
211bbe2479ec32b994a283b0ceb500fadece09e16669bbb17516207f4a0b8d8b
|
|
BLAKE2b-256 checksum How to use checksums |
1592d7b15a8fe7cd71570d7b4f63cfa1a536178931099177c566ff5a8fb6dffe
|
| 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 25, 2026.
Transparency log