explaingit

theatrus/toposaic

Analysis updated 2026-07-26

5RustAudience · generalComplexity · 2/5Setup · easy

TLDR

A desktop app that turns real-world elevation data into 3D-printable jigsaw puzzles of any landscape. Pick a place on a map, adjust the grid, and export print-ready STL or 3MF files.

Mindmap

mindmap
  root((repo))
    What it does
      Terrain jigsaw puzzles
      3D printable models
      Live 3D preview
    Data sources
      Elevation tiles
      OpenStreetMap
      ESA WorldCover
    Puzzle options
      Grid sizes 2 to 16
      Solid terrain mode
      Super-tile mode
    Output formats
      STL files
      3MF with color
      Optional tray export
    Tech stack
      Rust
      Desktop app
      Web interface
    Use cases
      Educational models
      Custom gifts
      Large terrain sets

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Create a 3D-printable jigsaw puzzle of your favorite city or hiking trail.

USE CASE 2

Print a large landscape across multiple printer beds using super-tile mode.

USE CASE 3

Export a solid, seamless terrain model for display or education.

USE CASE 4

Generate a puzzle tray with contour lines and place name labels.

What is it built with?

Rust

How does it compare?

theatrus/toposaicdhkts1/teamclaude-rselofight/emufight
Stars555
LanguageRustRustRust
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Prebuilt installers are available for Windows, macOS, and Linux with no complex configuration required.

In plain English

TopoSaic is a desktop application that turns real-world elevation data into 3D printable terrain puzzles. You pick a place on a map, and the software builds a jigsaw puzzle model of that landscape. Each piece has round tabs and sockets like a standard jigsaw, and the final model can be sent to a 3D printer. The name is a blend of "topographic" and "mosaic." The app runs on Windows, macOS, and Linux, with prebuilt installers available for each. A web interface lets you choose a location, adjust mesh detail, and set surface colors. The program fetches elevation data from public sources like Mapzen Terrarium tiles, then constructs watertight 3D meshes from those samples. It also pulls in land cover, water, roads, and building data from OpenStreetMap and ESA WorldCover, all of which get cached locally so you do not re-download them on every change. You can save named model setups and export them as JSON files to move between computers. The interface shows a live, rotatable 3D preview beside the map, with adjustable dividers between sections. Pieces can range from a 2 by 2 grid up to 16 by 16, with the default making 100 pieces. There is also a solid terrain mode that exports one continuous model with no puzzle seams. A super-tile mode lets you create terrain sets too large for a single printer bed. The model is split across a grid of up to 12 by 12 tiles, each printed separately but sharing the same elevation scale so they line up when assembled. The software locks that scale after your first move across tiles and warns you if a later tile needs adjustment. An optional tray can be exported alongside the puzzle, with contour line inlays and raised place name text. The software outputs files in formats like STL and 3MF, with color information that slicers such as Bambu Studio and OrcaSlicer can read. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to use TopoSaic to make a 3D-printable jigsaw puzzle of the Grand Canyon. How do I pick the location, choose a grid size, and export an STL file for my 3D printer?
Prompt 2
Help me set up TopoSaic's super-tile mode so I can print a large terrain model across multiple print beds. How does the shared elevation scale work across tiles?
Prompt 3
I have TopoSaic installed and want to export a 3MF file with color information for Bambu Studio. How do I configure surface colors and land cover data?
Prompt 4
How do I use TopoSaic to create a puzzle tray with contour line inlays and raised text place names for my exported terrain puzzle?

Frequently asked questions

What is toposaic?

A desktop app that turns real-world elevation data into 3D-printable jigsaw puzzles of any landscape. Pick a place on a map, adjust the grid, and export print-ready STL or 3MF files.

What language is toposaic written in?

Mainly Rust. The stack also includes Rust.

How hard is toposaic to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is toposaic for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.