Procedural materials; an open-source, node-based material designer, built in pure Rust.
Build procedural materials from primitives and functions in a node graph, watch them
update live in 2D and on a 3D model, and export the maps for any engine. It runs natively on
macOS, Windows, Linux and FreeBSD, and in the browser via WebAssembly. Built by the ArtCraft team.
The workspace: explorer, library, node graph, 3D view, 2D view and properties
> [!NOTE]
> **ArtCraft is a community of artists from all walks of life.** Painters, sculptors, game
> artists, material and texture artists, photographers, filmmakers, illustrators, designers,
> hobbyists, and people who picked up a stylus last week. If you make things, you belong here.
> **[Come say hi on Discord](https://discord.gg/artcraft).**
## A look around
These screenshots show the earlier procedural library. The current build uses the primitive
catalog described in [the primitive workflow](docs/atomic-workflow.md).
Wood planks: anisotropic grain, warped and laid over planks
Lava rock: cracked plates over glowing emissive seams
New graph: start from a PBR template or a sample material
Mossy ground: stones and dirt height-blended, with moss in the gaps
## Made in MaterialCraft
These historical renders used the former Rust library and are no longer bundled as templates.
They were built from
its own procedural nodes (no photos, scans or textures from anywhere else) and rendered by
`materialcraft-cli render --scene sphere --full --hq` (the height output displaces the mesh, with
ray-traced ambient occlusion and a shadowed key light).
Brick wall · Lava rock · Painted metal plates · Wood planks Wicker weave · Mossy ground · Stone tiles · Polished marble
## Why MaterialCraft
- **Familiar.** The layout, panels, menus and gestures material artists already know: a package
explorer, a library of nodes with previews, the node graph with live thumbnails, a 3D view, a 2D
view and a properties panel with base and specific parameters (Levels is edited over a
histogram of its input, see [docs/levels-editor.md](docs/levels-editor.md)). Space opens the
node search.
- **Fast.** Every node cooks on every CPU core, and a content-addressed cache means an edit
re-cooks only what lies downstream.
Cooking runs on a worker thread, so the UI never waits.
- **Tileable by design.** Noises and patterns live on whole-number lattices, so everything tiles
seamlessly at any resolution, from 16 px to 8K.
- **Robust.** No panics in shipped code, every command tested with hostile input, every node cooked
with odd inputs in tests, undo from snapshots, and native SBS project files. Save `.sbs` with an
adjacent `resources/` folder, or a self-contained `.mcraft` ZIP with `package.sbs` and `resources/`.
- **Open.** Export base color, normal, roughness, metallic, height and ambient occlusion as PNG,
JPEG, TGA, BMP, WEBP, EXR or HDR at 8, 16 or 32 bits, with your own file name pattern.
- **Works with TextureCraft.** **File ▸ Send to TextureCraft** puts a material on TextureCraft's
shelf as a portable `.mcmat`; painted onto a mesh there, its graph inputs stay live sliders and
colors, re-cooked by MaterialCraft at the texture set's resolution with the mesh's baked maps
feeding the graph's input nodes.
- **Agent-native.** Every menu item and edit is a command you can drive from the CLI, a JSON
control channel (including synthetic mouse and keyboard input) or an **MCP server**, so Claude
and other agents can build materials the way a person does.
- **Everywhere.** One codebase for the desktop apps and the same UI in the browser.
## Quick start
```sh
git clone https://github.com/storytold/materialcraft
cd materialcraft
cargo run --release -p materialcraft # desktop app
cargo run --release -p materialcraft -- package.sbs # open an SBS package
cargo run --release -p materialcraft -- --control 7878 # + JSON control channel
cargo run --release -p materialcraft-cli -- mcp # MCP server (stdio)
cargo run --release -p materialcraft-cli -- new wood wood.sbs
cargo run --release -p materialcraft-cli -- render wood.sbs wood.png --scene sphere --full --hq
cargo run --release -p materialcraft-cli -- export wood.sbs textures --format png --depth 16
cargo run --release -p materialcraft-cli -- export my.sbs out --set wear=0.7 # with a graph input "wear" set first
cargo run --release -p materialcraft-cli -- run my.sbs file.exportMaterial '{"path": "my.mcmat", "size": 2048}' # for TextureCraft
cd apps/materialcraft-web && trunk serve # web build
cargo xtask ci # fmt, clippy, tests, layering, wasm
```
You need Rust 1.95 or newer. The app opens with an empty graph in a new package; **File ▸ New ▸ Graph...**
starts from a PBR template or one of the sample materials.
### Use it from Claude Code and other agents
Register the MCP server with Claude Code, giving it the folders it may read and write:
```sh
claude mcp add materialcraft -- /path/to/materialcraft-cli mcp --read-root /work/materials --write-root /work/materials
```
To drive the running app instead, start it with `--control 7878` and bridge to it:
```sh
claude mcp add materialcraft-app -- /path/to/materialcraft-cli mcp --bridge 7878
```
The details are in [`docs/control-protocol.md`](docs/control-protocol.md).
## Status
MaterialCraft is under active development. [**ROADMAP.md**](ROADMAP.md) has the parity estimate by
area, the remaining work and what's next.
**Current focus (2026-11-16):** node behavior, regression coverage and SBS save/load. The old Rust
procedural library has been removed. The replacement includes 29 main-graph entries, 85 function
operations and four pattern node kinds. Start with **File → New → Atomic sample**.
See [the primitive workflow](docs/atomic-workflow.md) for usage, validation scope and limitations.
The [catalog status](docs/node-catalog-parity.md) records implemented behavior and remaining work.
Full numerical compatibility and arbitrary SBS interoperability remain unestablished.
**Workspace:** `crates/{core, geom, nodes, eval, formats, engine, render, automation, ui-egui}`
and `apps/{materialcraft, materialcraft-cli, materialcraft-web}`. The egui frontend is its own
crate, so the UI can be swapped without touching the engine; [`docs/architecture.md`](docs/architecture.md)
explains how it fits together.
Agent and contributor rules (clean room, the asset policy, no panics in shipped code, quality gates)
are in [`AGENTS.md`](AGENTS.md). Every bundled asset is listed with its licence in
[`ATTRIBUTION.md`](ATTRIBUTION.md).
## Downloads
**New to MaterialCraft?** Download it from the [MaterialCraft page on getartcraft.com](https://getartcraft.com/apps/materialcraft). That's the easiest way to install it.
**Want a specific build or format?** On GitHub, the [latest release](https://github.com/storytold/materialcraft/releases/latest) has every build listed below, and [all releases](https://github.com/storytold/materialcraft/releases) has earlier versions and their notes. `` in the file names is the version number, and `SHA256SUMS.txt` lists a checksum for every file.
### Windows
| Build | Installer | Portable |
|---|---|---|
| x64 (64-bit Intel/AMD) | `materialcraft--windows-x64.msi` | `materialcraft--windows-x64-portable.zip` |
| arm64 (Snapdragon and other ARM PCs) | `materialcraft--windows-arm64.msi` | `materialcraft--windows-arm64-portable.zip` |
| x86 (32-bit) | `materialcraft--windows-x86.msi` | `materialcraft--windows-x86-portable.zip` |
### macOS
| Build | File | Notes |
|---|---|---|
| App, universal (Apple silicon + Intel) | `materialcraft--macos-universal.dmg` | Signed and notarized |
| Command-line tool, universal | `materialcraft-cli--macos-universal.zip` | Signed and notarized |
### Linux
| Format | x86_64 | aarch64 (ARM64) | Notes |
|---|---|---|---|
| AppImage | `materialcraft--linux-x86_64.AppImage` | `materialcraft--linux-aarch64.AppImage` | Runs anywhere; updates itself with [AppImageUpdate](https://github.com/AppImageCommunity/AppImageUpdate) (`.zsync` files) |
| Flatpak | `materialcraft--linux-x86_64.flatpak` | `materialcraft--linux-aarch64.flatpak` | Sandboxed; `flatpak install --user ` |
| Debian/Ubuntu | `materialcraft--linux-x86_64.deb` | `materialcraft--linux-aarch64.deb` | |
| Fedora/RHEL/openSUSE | `materialcraft--linux-x86_64.rpm` | `materialcraft--linux-aarch64.rpm` | |
| Tarball | `materialcraft--linux-x86_64.tar.gz` | `materialcraft--linux-aarch64.tar.gz` | Unpack anywhere |
### FreeBSD
| Build | File |
|---|---|
| x86_64 | `materialcraft--freebsd-x86_64.tar.gz` |
### Web (WebAssembly)
| Build | File | Notes |
|---|---|---|
| Static site | `materialcraft-web-.zip` | Runs in a modern browser; host it on any static server |
## The Crafting Apps
MaterialCraft is one of the **Crafting Apps**: free, open-source creative tools from the
[ArtCraft](https://getartcraft.com/) team, each written from scratch in Rust and each able to
stand on its own.
| | App | What it's for | Code | Learn more |
|:-:|---|---|---|---|
| | **PhotoCraft** | Image editing: layers, masks, type and real PSD files | [GitHub](https://github.com/storytold/photocraft) | [Website](https://getartcraft.com/apps/photocraft) |
| | **VectorCraft** | Vector illustration | [GitHub](https://github.com/storytold/vectorcraft) | [Website](https://getartcraft.com/apps/vectorcraft) |
| | **TextureCraft** | 3D texture painting | [GitHub](https://github.com/storytold/texturecraft) | [Website](https://getartcraft.com/apps/texturecraft) |
| | **MaterialCraft** | **Procedural materials with node graphs · you are here** | [GitHub](https://github.com/storytold/materialcraft) | [Website](https://getartcraft.com/apps/materialcraft) |
| | **FilmCraft** | Video editing, color and sound | [GitHub](https://github.com/storytold/filmcraft) | [Website](https://getartcraft.com/apps/filmcraft) |
| | **LightCraft** | Photo library and raw development | [GitHub](https://github.com/storytold/lightcraft) | [Website](https://getartcraft.com/apps/lightcraft) |
| | **PdfCraft** | Reading, organizing and protecting PDFs | [GitHub](https://github.com/storytold/pdfcraft) | [Website](https://getartcraft.com/apps/pdfcraft) |
| | **EffectCraft** | Motion graphics and visual effects | [GitHub](https://github.com/storytold/effectcraft) | [Website](https://getartcraft.com/apps/effectcraft) |
| | **DesignCraft** | Page layout and publishing | [GitHub](https://github.com/storytold/designcraft) | [Website](https://getartcraft.com/apps/designcraft) |
| | **GridCraft** | Spreadsheets and data | [GitHub](https://github.com/storytold/gridcraft) | [Website](https://getartcraft.com/apps/gridcraft) |
And [**ArtCraft**](https://getartcraft.com/) itself, our AI image and video studio for artists who want real control.
Come make things with us
Our Discord is where artists of every kind hang out: people who paint, sculpt, model, build
materials, shoot, draw, cut film, set type, and people still figuring out what they like to make.
Share what you're working on, ask for help, tell us what's broken, or tell us what you wish these
tools could do. Whatever your medium and however long you've been at it, you're welcome here.
## Star history
[](https://www.star-history.com/?repos=storytold%2Fmaterialcraft&type=date&legend=top-left)
## License and credits
MaterialCraft is dual-licensed under [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE), at your option.
Copyright (c) 2026 ArtCraft Team and the MaterialCraft contributors. Required notices are in [NOTICE](NOTICE).
Bundled icons, images and other assets keep their own open licenses; each one is listed with its
author, source and license in [ATTRIBUTION.md](ATTRIBUTION.md).
Every material, noise, pattern, environment, library preview and mesh shown is generated
procedurally by MaterialCraft itself; no third-party textures, scans or models appear in the
screenshots. MaterialCraft is an independent, clean-room implementation of a node-based procedural
material workflow and is not affiliated with any other software vendor.
The app icon (an engraved rhino on MaterialCraft teal `#178a9c`) is original artwork made for this
project by its owner; its files and notes are in [`assets/app-icon/`](assets/app-icon/).
The ArtCraft name, wordmark and logos in [`docs/brand/`](docs/brand/) are trademarks of the
ArtCraft Team and are not covered by this license. They may be used only unmodified, and only as
part of this repository and MaterialCraft, under [`docs/brand/LICENSE-brand.txt`](docs/brand/LICENSE-brand.txt).
Forks and modified versions must remove them.