Thingi10K Browser

A searchable, filterable 3D model archive browser for the Thingi10K dataset — 10,000 3D-printable models from Thingiverse, with mesh quality metadata.

Support the Project

Thingi10K Browser is open-source and free to use, maintained in spare time as a labor of love. Friends James Smith and Dan Ruskin help out from time to time too.

If you find it useful, here are a few ways to help keep development going:

• Donations: Buy Me a Coffee — every coffee helps.
• Star the repo: Costs nothing and helps others find the project.
• Report issues: Open an issue for bugs or feature ideas.
• Contribute: PRs welcome — open an issue first to discuss larger changes.

▶ Live Demo

Part of the rust-apps suite — a collection of Rust graphics and geometry libraries by Lars Brubaker.

---

Features

• Search by model name, ID, or Thing ID
• Filter by mesh quality properties (closed, edge/vertex manifold, single component, PWN) — each with three states: Both / Yes / No
• Filter by face and vertex count ranges
• Sort by ID, Thing ID, or name
• 3D preview with orbit controls and wireframe toggle
• Download any mesh directly from the browser (decompressed on the fly)

Architecture

The live demo is a fully static site hosted on GitHub Pages — no server required.

Layer	Detail
Frontend	Vanilla JS + Three.js, served from docs/ via GitHub Pages
Model metadata	docs/data/models.json — 9 997 records, ~3 MB (excluded: 81313, a NURBS-only OBJ; 74463 and 286163, empty STLs)
Mesh files	Compressed per-model zips in three companion repos, served via jsDelivr CDN
Decompression	fflate — in-browser, no server needed

Mesh repos

Repo	ID range	Models
Thingi10K-meshes-1	32 770 – 88 580	3 331
Thingi10K-meshes-2	88 581 – 301 929	3 332
Thingi10K-meshes-3	301 930 – 1 778 123	3 334

Each mesh is stored as a deflate-compressed zip (e.g. 32770.stl.zip). The browser fetches and decompresses on demand — no files are pre-extracted.

Running locally

# Requires Rust + the Thingi10K.zip dataset (not in repo — see dataset source above)
cd Thingi10K
cargo run
# Open http://localhost:3000

The local server reads directly from Thingi10K.zip with no extraction needed.

Regenerating static output

If you update the zip (e.g. replace a model), regenerate with:

cargo run --bin export_static
# Writes docs/data/models.json and mesh-export/meshes-{1,2,3}/

Then push mesh-export/meshes-N/ to the corresponding mesh repo.

The weld_result column

docs/data/models.json carries a weld_result field computed by manifold-rust itself — the outcome of normalizing the mesh, welding coincident vertices, and importing through the robust (non-manifold-tolerant) pipeline:

Value	Meaning
"manifold"	Welds into a halfedge-pairable mesh the engine imports as manifold. Note this includes many models whose dataset flags say non-manifold: edges shared by 4+ triangles still pair into a consistent halfedge structure after exact welding.
"nonmanifold"	Imports only as triangle soup (closed and orientable, but not pairable). None of the closed ≤20k-face STL models fall here.
"not_closed"	Rejected — not geometrically closed even after welding

The dataset's original closed / edge_manifold / vertex_manifold flags were computed with different tolerances and regularly disagree with this stricter pipeline, so consumers that feed meshes into manifold-rust (e.g. its Boolean Gallery demo) should trust weld_result. Records without the field (non-STL formats, very large meshes) have not been processed yet.

Populate or update it with:

cargo run --release --bin update_weld_status              # closed STL <= 20k faces
cargo run --release --bin update_weld_status -- --max-faces 100000
cargo run --release --bin update_weld_status -- --refresh # recompute existing

Meshes are fetched from the CDN and cached in mesh-cache/ (gitignored); progress saves every 100 models, so the run is interruptible and resumable.

Dataset

Thingi10K — ten-thousand-models.appspot.com
10,000 models from Thingiverse with mesh quality annotations (closed, manifold, PWN, etc.).