Atlas VTT

by Fabian Urbanek
5
4
3
2
1
Score: 61/100

Description

Open Source virtual tabletop for Obsidian: battle maps, tokens, fog of war, dice, initiative and a separate player view.

Reviews

No reviews yet.

Stats

689
stars
29,553
downloads
97
forks
60
days
0
days
1
days
322
total PRs
19
open PRs
63
closed PRs
240
merged PRs
430
total issues
135
open issues
295
closed issues
3,012
commits

Latest Version

2 days ago

Changelog

Atlas VTT 0.17.0 — Armarium, documentation and the dice tray

2026-11-18

New

New Feature: Armarium and Documentation directly within Atlas

  • Browse the Armarium right inside the asset manager: choose the shop icon at the end of the tabs, or Armarium in the command palette
  • Install a collection with one click. The import review shows what's included before anything is added
  • Share your own collections in the Armarium without leaving Atlas
  • Read the documentation inside Atlas: choose Documentation in the command palette

Updated: Dice tray

  • Updated UI/UX for Dice tray
  • Roll history: open it to see your recent rolls and roll any of them again. Enter repeats the last roll
  • Formulas can add, subtract, multiply and divide with brackets, and roll d% and Fate dice (dF). Dice can reroll (4d6r1), explode (2d6!), keep or drop the highest or lowest (4d6kh3, 2d20kl1), count successes (8d10cs>=8) and carry a label (2d6[fire])
  • Everything has a key: number keys add dice, N, A and D choose advantage, S shows the roll to players and / jumps to the formula
  • Right-click or Alt-click a die to take one away, Shift-click it to roll it at once
  • Results show the formula and whether players saw them, and stay on screen while you hover them. Dropped dice show in brackets

Cheat sheet and documentation

  • A question mark button at the bottom right of the map opens the cheat sheet with every keyboard shortcut, as do ? and Cheat sheet in the command palette
  • Customize toolbar can hide the cheat sheet button and the online play button too

Improved

  • The command palette opens the DM screen and the Sound page, and Escape closes the DM screen. Contributed by young-george
  • TrueScale: drag the frame players see by its new grip to move them with you at once, as before 0.13.1. Alt moves it off the grid, Escape puts the players back. Contributed by aryistia
  • TrueScale: Show players here keeps the staged frame in place while the players' frame glides to it. Contributed by aryistia
  • Sound is no longer an experimental feature: the Sound page, its commands and its shortcuts are there without switching anything on
  • Experimental features can now be switched on and off in Atlas's settings tab, not only in the command palette
  • The Saver lighting now shows light reflected into shadows, like the other quality levels
  • Various UI/UX improvements across Atlas. Atlas now uses it's own tokens for corner rounding of UI components in order to ensure Atlas looks the same across all platforms which wasn't previously the case by using the native Obsidian tokens. If you want your Obsidian theme to also change the corner rounding of Atlas you'll have to adjust the theme to include Atlas in it's scope

Fixed

  • Edit Token stays where it opened: switching vision or a carried light on or off no longer moves the dialog away from the pointer. Contributed by bbell-sys
  • The token creator saves zoom and position for tokens without a ring. Contributed by aecorn
  • Players no longer see tokens standing just outside a lantern's beam in the dark
  • A door drawn in Rooms mode now stays where you put it instead of stretching to the nearest corner, and opening it opens the wall it was drawn on
  • Music tracks in a linked folder now show their waveform while they play, as dragged-in tracks always did. They have to finish processing for the waveform to show
  • Map photos taken in portrait on a phone no longer show parts of the map in the wrong places or squeezed when zoomed out
  • The TrueScale frame on the map no longer lags behind, flickers or shakes while you pan with the player window open
  • Tokens without a ring are now as large as tokens with a ring and fill their square
  • Grid alignment by measuring now accepts corners anywhere on the map, so levels padded with black can be aligned
  • The player window keeps following the map when it sits on another virtual desktop
  • On Windows and Linux, with the tab bar hidden (Atlas Sidebar), the widgets slide out from under the window's minimise, maximise and close buttons while you use them

Atlas Online

  • Players now see the fog edge the GM chose instead of a hard edge
  • Quest pins on maps inside the world map now show to players while the quest is Active, and the campaign page says when players see a quest's pin
  • A note shared with players that contains a table now shows it as a table instead of raw | lines

Thanks to my Patreon supporters Aaron, Aaron W Scott, Aiden Hatcher, Andrew, Anna B. Meyer, basilisk, Bradley Bell, Carl Corneil, Chris Del Gigante, Daniel Mensinga, Daria Ambrose, Deus Ex Minima, Dewwww, Dom Bosco, Eskil Bolsøy, George Young, Giodude, Hannes Pingel, Ionazh, Jake kulig, Josh Zindler, Joshua Herrin, Kevin Hait, Krangal, LittleBlueShyGuy, Markus Baumann, Michael Breuer, MrEhm, Nick, Pau Benazet Montobbio, SamDark, Scaradeus, ShonkyMapCo, Silo Slate, Tim, Tim Roddick-Hull, Tobias Redlich, Voider Elf, Xethgnur, z-lf and Zack Samuels. You mean everything to me :heart:

Help me develop Atlas: https://www.patreon.com/cw/atlas_vtt

README file from

Github

AtlasVTT

A game system agnostic virtual tabletop for tabletop RPGs that runs inside Obsidian.

The guides, with screenshots and clips of every feature, are on atlas-vtt.dev.

I built Atlas as part of my bachelor's thesis to give the TTRPG community a virtual tabletop that's open source, hackable, and free to use. Every file Atlas creates, every token, every map, every world you build, stays yours and stays local. It follows the same philosophy as Obsidian: your work lives on your machine, in formats you control, with no account and no server in between. Atlas VTT also has an online play service, Atlas Online, to share your maps with players over the internet. Atlas Online requires an account and an internet connection.

TTRPG worlds in my opinion are something very personal and players and DMs get attached to them. That attachment deserves better than a subscription and someone else's database. Atlas makes sure your creative output stays yours, just like a sheet of paper would.

Ease of use matters just as much to me. Atlas aims for a minimal, streamlined interface that feels native to Obsidian, with clear controls and simple workflows that keep your attention on the game.

AtlasVTT is desktop only for now

Documentation at: atlas-vtt.dev

Atlas VTT showing a battle map, character tokens, a linked statblock, and the initiative tracker

At the table

  • Maps and grids: Build scenes from your own map images. Align square or hex grids manually or with automatic detection.
  • Tokens and encounters: Import characters, move and resize tokens, and save groups as reusable encounters. Link creature notes with the optional Fantasy Statblocks plugin. Simple die syntax like 2d8+2 will be turned into a clickable dice roll.
  • Fog and player view: Reveal the map as your players explore. Show a separate player window on a second screen while keeping GM information hidden.
  • Drawing and notes: Sketch, add text, measure distances, and pin Markdown notes or other Atlas maps to locations.
  • Dice and initiative: Roll dice, review the roll log, track turns, and keep counters and timers close at hand.
  • Online play (closed beta): Host a table that your players join from their web browsers. It is off until you turn it on, and hosting needs an Atlas account with closed beta access.

Your notes, right on the map

Pin an Obsidian markdown note or even another Atlas map to a location, then read and edit it in a floating panel without leaving the map. Keep room descriptions, session prep, and character details close at hand, with Obsidian's familiar note linking built in.

Atlas VTT showing the note picker beside a linked note open on the map, with editing and Obsidian link suggestions

Organise your campaign

Keep scenes, maps, encounters, and characters together in collections. Use folders and tags to find what you need, then bring it onto the map.

Atlas VTT collection manager with character tokens, folders, tags, and actions for spawning tokens and linking statblocks

Atlas Sidebar

Atlas Sidebar is an optional companion plugin. It turns Obsidian's tabs into a vertical list with pinned tabs, folders, essentials and spaces, and keeps a pin at the top that takes you back to your scene in one click.

Atlas Sidebar, vertical tabs for Atlas VTT. The sidebar with the Atlas pin and the open notes beside a world map in Atlas.

Install

Requires Obsidian 1.8.7 or newer on desktop. Atlas VTT is available through Obsidian's community plugins.

  1. Open Settings → Community plugins and turn off Restricted mode if it is enabled.
  2. Select Browse and search for Atlas VTT.
  3. Select Install, then Enable.

Check for updates under Settings → Community plugins.

New to Atlas? Start here takes you from installing it to showing your first map to your players.

Want to try upcoming features early? Beta builds are available through BRAT, see .github/beta-testing.md.

In the beta, Random tables → New table turns pasted text into a Markdown table in your collection. Copy a table from a PDF, spreadsheet, website or Markdown note, enter its name and review the preview before choosing Save and roll.

The imports stay on your device. The XLSX reader uses the http://schemas.openxmlformats.org XML namespace identifiers locally and makes no requests to that address.

Download main.js, manifest.json, and styles.css from a GitHub release. Place them in <your vault>/.obsidian/plugins/atlas-vtt/, then enable Atlas VTT under Settings → Community plugins.

Your first scene

  1. Run Atlas VTT: Open dashboard from the command palette.
  2. Use the + button in the asset manager to import a map image, then create a scene using that map.
  3. Align the grid with automatic detection or the manual alignment tool.
  4. Import tokens and place them on your scene.
  5. For a local game, open the player view and move it to your second screen.

Privacy and network use

Atlas works offline with files in your vault. It has no telemetry or ads, and you need no account to use it. Scenes are saved as .atlasmap files, and the rest of your library (tokens, encounters, collection settings, game system presets) as JSON files in the atlas-vtt folder, so it syncs with your vault. With Obsidian Sync, turn on "Sync all other types".

If you use an external image URL for a token or map background, or copy an externally hosted image from a note, Atlas downloads that image from the supplied address. To tell you when an update is out, Atlas reads the version number of its newest release from GitHub (raw.githubusercontent.com) once when Obsidian starts and then every hour. Nothing about you or your vault is sent, and you can switch this off in Settings → Atlas VTT → Updates. Vault images require no network access. When you press Get starter ambience on the Sound page, Atlas downloads six CC0 ambient sounds (about 14 MB, audio only) from https://assets.atlas-vtt.dev/starter/ into your ambience folder; nothing about you or your vault is sent. When you press Get 155 free tokens in an empty Tokens tab of the asset manager, Atlas downloads 155 tokens (about 19 MB, images and a credits note; creatures from Oozejar's art under CC BY-SA 4.0, class tokens from Sketch Studio's icons under CC BY 4.0), and, if you choose them, their statblocks from the 5E SRD 5.2.1 (CC BY 4.0) or the Cairn bestiary (CC BY-SA 4.0) from https://assets.atlas-vtt.dev/starter/ into the collection you have open; nothing about you or your vault is sent. When you open the documentation panel, Atlas loads https://atlas-vtt.dev/docs in a frame inside the map view; nothing about you or your vault is sent. When you open the Armarium, Atlas loads https://atlas-vtt.dev/armarium inside the asset manager; when you install a free collection from it (or open its obsidian://atlas-vtt-install link), Atlas reads the list of installable collections from https://atlas-vtt.dev/api/armarium/v1 and downloads the collection through https://api.atlas-vtt.dev, which counts the download, from https://atlasvttusercontent.com or raw.githubusercontent.com, checks it against its listed fingerprint and installs it only after you confirm the import review. Nothing about you or your vault is sent; the Armarium's page is told which of the Armarium's own collections your vault holds, to mark them installed. Signing in to an Atlas account is optional (Settings → Atlas VTT → Atlas account): you approve the sign-in at https://atlas-vtt.dev/device, and the token is kept in Obsidian's secret storage on this device and sent only to https://api.atlas-vtt.dev and, while online play runs, https://play.atlas-vtt.dev. When you choose Share in the Armarium for one of your collections, Atlas packs it in memory as Export collection would, uploads it to https://api.atlas-vtt.dev, shows what the Armarium's checks found, and publishes it with the listing details you write only when you confirm; if you stop before that, the upload is discarded. When you explicitly submit an issue report, Atlas sends it to https://srv1871379.hstgr.cloud/atlas/reports, which creates a public GitHub issue. Online play (closed beta) is off until you turn it on in the command palette's Experimental features page. Hosting a table needs an Atlas account, and a running table connects to https://play.atlas-vtt.dev, which passes the scene your players may see on to their browsers and keeps none of it. What players need of it as files, sound on the Sound page included, is stored at https://assets.atlas-vtt.dev for up to 30 days after you last shared it. Players need no account. See PRIVACY.md for details.

Help and contributing

Found a bug or have an idea? Run the Report an issue command inside Obsidian or use Settings → Atlas VTT → Help and feedback. Atlas fills in your versions and submits your report directly, without a GitHub account or a second form; see .github/reporting-issues.md. To contribute code, see CONTRIBUTING.md.

Requires Node.js 22 or newer.

npm ci
npm run build   # production build into ./dist
npm run dev     # watch build
npm test

The build also copies the plugin into local test vaults when they are present.

Game system templates

Atlas VTT comes with statblock templates for 5E, Cairn, Draw Steel and Fate. Each holds the fields and layout of a statblock, not rules text or creatures. Atlas VTT arranged the stat block structure as an editable template.

The Draw Steel statblock template and system preset in Atlas VTT are an independent product published under the DRAW STEEL Creator License and are not affiliated with MCDM Productions, LLC. DRAW STEEL © 2026 MCDM Productions, LLC.

Credits and license

Widget icons, map pin icons, the sound moods' crests, light marker icons, the dashboard's icons, the token icon and the end-combat icon are by Lorc, Delapouite, Skoll, sbed, Carl Olsen, and Caro Asercion from game-icons.net, under CC BY 3.0. Their backgrounds were removed and glyphs recoloured. The starter class tokens are icons by Sketch Studio, commissioned by Maatlock of maatlockstavern.com, under CC BY 4.0, redrawn as pencil sketches on parchment. Other asset and library credits are in THIRD_PARTY_NOTICES.md.

Atlas VTT is free software. Copyright (C) 2025-2026 Fabian Urbanek.

You can use it for any purpose, including streamed, recorded, and paid games. You can redistribute and modify it under the terms of the GNU Affero General Public License, version 3 (AGPL-3.0-only) as published by the Free Software Foundation. If you distribute Atlas VTT or a modified version, or let others use a modified version over a network, you must make the complete source code available under the same license. It is distributed in the hope that it will be useful, but without any warranty; see the license for details.

Additional permission under GNU AGPL version 3 section 7: if you modify this program, or any covered work, by linking or combining it with Obsidian (or a modified version of that program), the licensors of this program grant you additional permission to convey the resulting work.

Releases up to and including 0.1.6 were published under the PolyForm Noncommercial License 1.0.0. If you want to use the code under different terms, contact Fabian Urbanek.

Your campaign content remains yours. Third-party components retain their own licenses.