Quadami
Quadami is an automatic quad remesher for Blender. Select a mesh (a sculpt, a scan, a dense
triangle model), set how many quads you want, press Remesh, and you get a new object made of
quads that follows the shape and has edge loops that run along it.
It is made for people who sculpt or model in Blender and need clean, even topology afterwards
(to animate, UV-unwrap, keep sculpting at a lower resolution, or hand over). You do not need to be
a programmer to use it: the user guide is written for Blender beginners.
Status: 0.2.1, a release with known limits. It works on the sculpts we test with, but
expect rough edges. Read Limits and warnings before you rely
on it, and send the panel's build line with every bug report.
More before/after examples, with their numbers and limits: docs/gallery.
What it does
- Runs outside Blender. The remesher is a separate program that the add-on starts in the
background. Blender stays usable while it works, Esc cancels it, and a crash in the remesher
cannot take Blender down.
- Remeshes what you see. Modifiers (Subdivision Surface, Solidify, Mirror ...) are used at their
viewport level; you do not need to apply them. Your original object is hidden, never changed.
- Tells you how good the result is. After every run the panel shows quads against the target,
non-quads, holes, non-manifold edges and vertices, flipped and folded faces, empty pieces and the
time, with problems in red and a warning that says what to do.
- Finds folded sculpt input. Twist, Rotate and Pinch brushes can fold a sculpt's surface over
itself where you cannot see it; that is where most defects come from. Quadami detects these spots
and offers Repair Folds and Re-run, which smooths only those spots in the remesher's copy.
The warning can also appear on CAD or scanned models whose result is clean (its text still
blames a sculpt brush); if the result looks fine, ignore it.
- Builds quads with libQEx, a robust quad extractor from RWTH Aachen, with our own extractor as
a per-piece fallback.
- Shows the quad size before you remesh. Preview Density paints the planned quad size on your
model; drag Change to see what more or fewer quads would give, at once, then remesh at the
count that keeps your details. It is a plan (on average 10-15 % off the result, less reliable on
hard-surface parts), and it shows size only, not edge loops.
- Asks before a huge job. Above 200,000 quads it shows the memory it needs (about 2 GB per
100,000 quads) and waits for you to confirm.
Install
Download the zip for your system from the
Releases page (under Assets;
no GitHub account needed). Do not unpack it: Blender installs the zip itself.
| System | Zip | Tested |
|---|
| Linux (x64, any distribution with glibc 2.28 or newer, e.g. Ubuntu 20.04+, Debian 10+, Fedora 29+, RHEL 8+) | quadami-<version>-linux-x64.zip (built in AlmaLinux 8, so it does not need a new distribution). Works with Blender from blender.org and the snap (/snap/bin/blender). Or build it yourself (addon/BEGINNERS.md). | CI (Ubuntu 24.04, Blender 4.2, headless) and the maintainer's laptop (Ubuntu, Blender 4.5 snap) |
| Windows 10/11 (x64) | quadami-<version>-windows-x64.zip | CI (Blender 5.2, headless); 0.1.0 also on one Windows 10 desktop, 0.2.x not yet by hand. The program is not signed. |
| macOS (Apple silicon, macOS 11.2+): experimental, untested | quadami-<version>-macos-arm64.zip | In CI only; never tried on a real Mac, and the program is not notarized, so Gatekeeper may block it |
| macOS on Intel | Build it yourself (docs/BUILDING.md). | No |
SHA256SUMS.txt next to the zips lets you check a download. Test builds between releases (newer,
less checked) are CI artifacts; how to get them: user guide §2.
Then, in Blender 4.2 or newer: Edit > Preferences > Get Extensions, the small ⌄ arrow
at the top right, Install from Disk..., pick the zip, and restart Blender. The panel is in the
3D Viewport sidebar (N), tab Quadami.
Step by step for every system, including where Blender keeps the add-on, updating, removing it,
the install scripts and the snap version of Blender on Linux: user guide §2.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
