- Rust 91.4%
- TypeScript 6.2%
- CSS 0.8%
- Java 0.4%
- Shell 0.4%
- Other 0.8%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
A street-level visit left ~300 MB in the disk cache, which the startup sweep caps at 512 MiB; 111 MB of it was the per-cell JSON layers stored as plain text. Native cache entries ending `.json` are now deflated (level 1, over 8 KiB) and inflated on read, told apart from entries written before by the gzip magic: the same visit leaves 200 MB, and a warm start was no slower. The web store is unchanged. The sweep ordered by mtime, i.e. by when a file was fetched, so a city opened every day sorted as old as its first visit and went before a place seen once since. A cache read now sets the file's atime and the sweep orders by the later of the two; the mtime stays the fetch time that `storage::age_secs` reads for staleness. |
||
| .cargo | ||
| .claude | ||
| .forgejo/workflows | ||
| assets | ||
| crates | ||
| deploy | ||
| docs | ||
| tools | ||
| .git-blame-ignore-revs | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| LICENSE | ||
| LICENSE-APACHE | ||
| LICENSE-MIT | ||
| LICENSE-THIRD-PARTY.md | ||
| README.md | ||
Cartopolis
A shared, walkable 3D copy of the real world, built from open public data. Rust + Bevy. Runs on the desktop, in the browser and on Android, and you can host your own.
cartopolis.org (WebGPU) · desktop releases (x86_64 needs AVX2 + FMA) · Android APK
Use it
Nothing to install for the web: open cartopolis.org in a browser with WebGPU.
- Desktop: download from releases. Linux: unpack
cartopolis-linux-x86_64.tar.gzand run./run.sh. Windows: unpack the zip and runcartopolis.exe. Needs a GPU driver; x86_64 needs AVX2 + FMA. - Android: install the APK from cartopolis.org/apk.
The app starts with the map. To meet people, choose ☰ ▸ Sign in…: it signs in to cartopolis.org, or to your own server if you type its address under Server.
Host your own server
A server is one program, cartopolis-server: the shared world, accounts and chat, the website, and the map data and place search for its area. You need a Linux machine with systemd and a domain name pointed at it. Install Caddy first for HTTPS; the installer then sets it up too.
curl -fsSL https://cartopolis.org/server/install.sh | sh
It asks for the server's address and an admin account, starts the server and adds the address to Caddy. Open https://maps.example.org, or sign in from the app with maps.example.org as the server. The map data for your area is made from the website: sign in as the admin and open Admin ▸ Data.
Updates are offered on the server's Admin page: it looks for a new release every six hours, and shows only one signed by the Cartopolis maintainer. An admin installs it with one click; the server tests it on a copy of its database, keeps the previous version and database, and goes back to them by itself when the new one does not start.
The download is also at cartopolis.org/server; unpacked, ./install.sh does the same. To build it from source: deploy/build/server-package.sh. The server guide has the settings and how the hosted server is set up.
Build it yourself
Install Git LFS before cloning: fonts, icons and test fixtures are compiled in, and without LFS the build embeds pointer files and fails at runtime. Then cargo run -p cartopolis runs the app. Rust, a C compiler and a GPU driver are needed; Linux links with clang + lld. The development guide covers the dev loop, tests, the web and Android builds, the code map and CI.
Where it works
The map, sky, weather, routing and shared world work anywhere on Earth. Register detail is available for the Netherlands only: measured buildings and their records, relief, street objects, aerial photography and transit. Elsewhere the ground is flat and buildings come from OpenStreetMap.
Docs
- Development guide: prerequisites, dev loop, tests, code map, CI
- Server guide: deploying the sim and the self-hosted geo services
- User manual: controls and authoring · Changelog
docs/notes/: measurements, constraints and the traps that fail silently, one topic per file.CLAUDE.mdlists the rules that hold everywhere.
Licence
Code is MIT OR Apache-2.0 (LICENSE). Data, models and the font carry their own terms. LICENSE-THIRD-PARTY.md is the canonical list; the credits below mirror it, so add new sources there.
Credits
- Engine: Bevy. Floating origin:
big_spaceby Aevyrie, MIT OR Apache-2.0, vendored and ported. - Avatars: bodies, clothes and hair from MakeHuman, CC0; motion from 100STYLE (Ian Mason, CC BY 4.0) and the CMU Graphics Lab Motion Capture Database.
- Map data: © OpenStreetMap contributors, ODbL. Detail from Overpass, search from Nominatim, both self-hosted (public instances under the OSMF policies).
- Vector tiles: VersaTiles, Shortbread schema, self-hosted mirror.
- Buildings (LoD2.2): 3DBAG by the 3D geoinformation group, TU Delft, CC BY 4.0, derived from the Kadaster's BAG and AHN via PDOK. NL.
- Aerial photography: Beeldmateriaal Nederland, Luchtfoto RGB via PDOK, CC BY 4.0. NL.
- Street objects: gemeente Groningen open data, CC BY 4.0. Groningen.
- Elevation: AHN DTM/DSM via PDOK, CC0. NL.
- Public transport: OVapi, from Dutch NDOV operator data. NL.
- Weather: MET Norway, CC BY 4.0; cloud cover from NOAA GFS, public domain.
- Night sky: HYG Database v4.1 by David Nash, CC BY-SA 4.0 (Hipparcos, Yale Bright Star, Gliese).
- Type: Plus Jakarta Sans by Tokotype, SIL OFL 1.1.
