Quadami

2. Install and update

The add-on is one .zip file with the remesher program inside. Do not unpack it; Blender installs the zip itself. You need Blender 4.2 or newer. Marks used below: (CI) checked by the project's automatic tests, (from memory, check) not checked on a real screen.

Get the zip

Download it from the Releases page: under Assets, click the zip for your system. No GitHub account is needed.

System Zip on the Releases page Tested on a real computer?
Linux (64-bit Intel/AMD, any distribution with glibc 2.28 or newer: Ubuntu 20.04+, Debian 10+, Fedora 29+, RHEL 8+) quadami-<version>-linux-x64.zip. Blender from blender.org or the snap (/snap/bin/blender). Or build it yourself (addon/BEGINNERS.md). Yes (Ubuntu, Blender 4.5 snap)
Windows 10 or 11 (64-bit) quadami-<version>-windows-x64.zip (the program is not signed) 0.1.0 on one Windows 10 desktop; 0.2.0 only in CI (Blender 5.2, no window)
macOS, Apple silicon (M1 or newer), macOS 11.2 or newer: experimental, untested quadami-<version>-macos-arm64.zip (not notarized, so macOS may block it) No, only in CI
macOS on Intel, Linux on ARM, Windows on ARM Not built. Intel Macs: build it yourself (BUILDING.md). No

SHA256SUMS.txt next to the zips lets you check a download; the release notes say how.

Test builds between releases

Every change merged after a release is built as a test build: newer, but checked less than a release. Use one only when asked to try a fix, and send its build line with any report.

  1. Sign in to GitHub (downloads of these files need an account).
  2. Open https://github.com/KajetanMuczynski/quadami/actions/workflows/ci.yml?query=branch%3Amaster and click the newest run where the job for your system (addon (linux-x64), addon (windows-x64) or addon (macos-arm64)) has a green tick. The run as a whole may be red only because the macOS job never got a computer; the Linux and Windows zips are still there (CI). Linux and Windows are built for every merge; macOS only in the nightly run (event schedule), so a macOS test build can be up to a day behind.
  3. Scroll to Artifacts at the bottom and click addon-linux-x64, addon-windows-x64 or addon-macos-arm64.
  4. GitHub wraps the add-on in a zip of its own. Unpack that outer zip once (Linux: unzip; Windows: right-click > Extract All...; macOS: double-click). The quadami-<version>-<system>.zip inside is the add-on: keep it zipped.

These files are deleted by GitHub after its retention period (90 days unless the repository says otherwise (from memory, check)), so download a newer one if the link is gone.

Install (first time and every update)

The same on every system:

  1. Open Blender. Edit > Preferences (macOS: Blender > Settings (from memory, check)).
  2. Left column: Get Extensions.
  3. Top right of that window: the small down arrow (⌄), then Install from Disk..., pick the zip. Dragging the zip from your file manager onto the Blender window does the same.
  4. Restart Blender. Needed if Blender showed "Missing Add-ons" before, and the safe habit after every update.
  5. Check: Edit > Preferences > Add-ons, find Quadami, make sure it is ticked, and click the arrow left of its name. Under Remesher executable (leave that field empty) it must say Using: .../bin/autoremesher-cli with a tick (Windows: autoremesher-cli.exe). "not found" means the zip has no remesher inside, or one for another system: get the right zip.

Installing a newer zip replaces the old copy (same add-on id, quadami). Every Blender version keeps its own add-ons, so if you have two Blenders, install in the one you use.

Where Blender keeps it

System Folder (replace 4.5 with your Blender version)
Linux, blender.org .tar.xz ~/.config/blender/4.5/extensions/user_default/quadami
Linux, snap (/snap/bin/blender) Usually the same folder, since the Blender snap may read your home folder (classic confinement). Installing with /snap/bin/blender worked on the maintainer's laptop (2026-10-22); which folder it used was not recorded. The install script below asks Blender and prints the folder it really uses.
Linux, Flatpak Not supported: its sandbox cannot start the remesher. Use the .tar.xz or the snap.
Windows %APPDATA%\Blender Foundation\Blender\4.5\extensions\user_default\quadami (CI, with 5.2)
macOS ~/Library/Application Support/Blender/4.5/extensions/user_default/quadami (from memory, check)

The remesher program is in its bin folder.

Remove it

Edit > Preferences > Add-ons, expand Quadami, open the ⌄ or ... menu next to it > Uninstall (from memory, check). Or quit Blender and delete the quadami folder from the table above. Results you already made stay in your files; they are ordinary mesh objects.

Install scripts (optional, they also clean up)

macOS: if the remesher is blocked

The program inside the macOS zip is not signed by a registered Apple developer ("notarized"). Nobody has tried it on a real Mac yet, so we do not know whether macOS blocks it. If a remesh fails at once or macOS says the program "cannot be opened", quit Blender and in the Terminal run xattr -dr com.apple.quarantine "<the quadami folder from the table above>", then start Blender again. Please report what happened either way.

Which version do I have? (the build line)

Blender's extension list shows the release version (such as 0.2.0) for every build, so it cannot tell builds apart. Use the build line instead: a small grey line at the very bottom of the Quadami panel (and in the add-on's preferences), for example Add-on build 4e9cdc7 2026-10-21. The first part is the code version (a commit), the second its date. Copy that line into every bug report.