Skip to content

eadf/hallr

Repository files navigation

Hallr

crates.io Workflow License Sponsor

Hallr is a Blender add-on written in Rust and Python. Python is used for the blender add-on system glue, sending and receiving data to the rust implementation.

This project is a work in progress, so expect frequent changes to its functionality and API.

Usage

For Blender instructions, refer to the wiki.

Gallery

For some images generated by this add-on, see the release page and the wiki

Installing Hallr

You can download pre-built ZIP files from the GitHub Releases section. This ZIP file is the pre-packaged Hallr add-on, which can be drag-and-dropped directly into Blender.

The ZIP file contains dynamic libraries compiled for multiple platforms:

  • macOS (amd64 & ARM)
  • Linux (amd64)
  • Windows (amd64)

All releases are built automatically by GitHub workflows.

To build the add-on locally, use the following command:

python3 build_script.py

Once the build is complete, simply drag and drop the generated hallr.zip file into Blender to install it.

Developer Mode

For a faster development workflow, you can enable developer mode:

python3 build_script.py --dev_mode

Then, open and run the blender_addon_exported/__init__.py file inside Blender. In this mode, Blender will automatically use the latest compiled Rust library, so you only need to recompile your Rust code to see changes take effect the next time you run an operation.

For this purpose, the Rust tool watchexec works exceptionally well for automatically recompiling when source files change.

Contributing

We welcome contributions from the community! Feel free to submit pull requests or report issues on our GitHub repository.

License

Hallr is licensed under AGPL-3.0-or-later.