ReverySky Map

ReverySky 3D Graph is an interactive 3D graph that lets you explore your vault as a connected universe. It runs on a bundled Unity WebGL runtime with live graph updates and integrated note navigation.

Features

• A dynamic force-directed layout for smaller graphs
• A wide panoramic starfield for larger, denser graphs
• A chronological layout that arranges notes by date
• Combined filters by path, tag, and date
• Opening notes from the graph and highlighting the active note
• Pan, zoom, rotation, and timeline navigation
• Detailed and simplified display modes
• Graphs with or without tag nodes
• Longer notes appear as larger nodes; more connected nodes glow brighter
• Stress-tested with graphs of up to 10,000 notes

Installation

Install ReverySky 3D Graph from Obsidian Community plugins.

Download and installation may take some time because the plugin includes a bundled Unity WebGL runtime.

Requirements: Obsidian 1.12.7 or later, desktop only, and WebGL-compatible graphics hardware.

Opening the graph

After enabling the plugin, you can open the graph in either of two ways:

• Click the left ribbon button Toggle ReverySky 3D Graph.
• Run ReverySky 3D Graph: Open from the command palette.

Visual quality

Visual quality depends on your display resolution, screen scaling, graphics driver, and the GPU used by Obsidian. For the clearest image, keep your graphics driver up to date and let Obsidian use a high-performance GPU when your device offers one. On dual-GPU laptops, this is usually set in your system graphics settings.

The graph settings panel includes two visual controls:

• Render Scale: higher values sharpen the graph but use more GPU power.
• Frame rate: controls how often the Unity runtime renders frames: Auto, 60 FPS, 30 FPS, or 24 FPS. Auto lets Unity synchronize rendering to the display, which may still be capped by the Obsidian/Electron host.

Character support

Graph note titles support Latin text with accents, Cyrillic text, common symbols, and monochrome emoji.

Navigation

• Pan: drag the graph with the primary mouse button to move the camera focus across the current layout.
• Zoom: use the vertical slider on the left side of the graph, or use the mouse wheel for quick zooming.
• Rotate: use the on-screen rotate controls, or hold the right mouse button and drag horizontally.
• Display mode: use the round view button to switch between the standard detailed rendering and a simplified rendering. In link layouts, the standard mode shows tag nodes and link lines; the simplified mode keeps note nodes visible and hides those extra details.
• Open a note: click a note node in the runtime. The graph focuses that node and opens the matching Markdown note in Obsidian.
• Follow the active note: when Obsidian focuses a Markdown note, the runtime can focus the matching node in the graph.
• Date navigation: in the Dates layout, use the date slider to move along the time axis while keeping pan, zoom, and rotation available.

Filter

Open the settings panel from the graph view to limit which notes are sent to the runtime. The filter box supports:

• path: to match notes by vault-relative file path. Folder suggestions are built from the current vault data.
• tag: to match notes by tag. Tag suggestions use tags collected from Markdown metadata and frontmatter.
• date: to match note dates from date, created, or created_at frontmatter, with file creation time as a fallback. Supported forms include exact dates and comparisons such as date:>=2026-01-01.
• A leading - to exclude matches, such as -path:Archive.
• Filters can be combined, for example: path:Projects tag:research -path:Archive date:>=2026-01-01

Use Escape in the filter box to clear the query. Use the Tags switch to hide tag-derived graph structure without changing the current path, date, or tag filter.

Layout

The layout control changes how the same vault data is arranged:

• Dynamic links: a force-directed layout for link-heavy inspection in vault slices up to 500 notes.
• Scalable links: a more stable layout for larger vault slices and denser link graphs.
• Dates: a chronological layout that arranges notes by date and enables the date slider.
• Auto: chooses Dynamic links for smaller datasets and switches to Scalable links above 500 notes.

Privacy, network, and local files

ReverySky 3D Graph processes vault structure locally on your device.

Vault data

The plugin uses Obsidian's vault and metadata APIs to collect the information required to build the graph:

• Markdown file paths and note titles
• Tags from note metadata and frontmatter
• Dates from the date, created, or created_at frontmatter properties, with file creation time as a fallback
• File sizes
• Resolved links between notes

The graph payload does not include the full Markdown contents of your notes.

Vault data is passed from the Obsidian plugin to the embedded Unity runtime through local bridge messaging within Obsidian. It is not sent to external servers.

ReverySky 3D Graph does not include telemetry, analytics, advertising, user accounts, subscriptions, or payments.

Local runtime files

The Unity WebGL runtime is bundled with the plugin release and is not downloaded from an external server.

When the graph is opened for the first time, the plugin extracts the bundled runtime into a versioned cache inside the installed plugin directory:

<vault-config-dir>/plugins/reverysky-map/.reverysky-runtime/<version>/

Later graph launches reuse the validated cache.

Runtime file access is limited to the installed plugin directory. It is not used to scan, read, or write vault notes, unrelated user files, or system files outside the plugin directory.

Local WebGL server

Unity WebGL requires its runtime files to be loaded through HTTP. ReverySky 3D Graph therefore starts a local loopback server when the graph runtime is needed.

The server:

• Binds exclusively to 127.0.0.1 on a randomly selected port
• Is accessible only from the same device
• Accepts only GET and HEAD requests
• Serves files only from the prepared Unity runtime directory
• Stops when the graph view is closed or when the plugin is unloaded

The local server only delivers Unity WebGL runtime files to the embedded graph iframe. It does not process or serve vault notes.

Runtime packaging and source availability

The release build uses the embedded-archive package mode. Other package modes and release shapes are documented in Packaging Modes.

The Obsidian plugin source code and the Unity project source code are available in this repository. The Unity project keeps the technical project name ReverySky Map; the public Obsidian plugin display name is ReverySky 3D Graph.

Release assets are built and attested by GitHub Actions from tracked repository contents. To make the build reproducible without running Unity Editor in GitHub Actions, the compact Unity WebGL runtime input under unity-webgl/Build/runtime-* is intentionally tracked after the local Unity export/import workflow.

The standard Obsidian community plugin release shape consists of a small set of root release assets: manifest.json, main.js, and optionally styles.css.

ReverySky 3D Graph also requires a Unity WebGL runtime, including Unity-generated JavaScript, WebAssembly, data files, and visual and runtime assets. To keep the release self-contained in the standard Obsidian plugin shape, the embedded-archive package mode stores the generated Unity WebGL build archive inside the released main.js.

The ReverySky 3D Graph WebGL view was built with Unity® software and includes Unity-generated WebGL runtime files. ReverySky 3D Graph is not sponsored by or affiliated with Unity Technologies or its affiliates. Unity and related Unity marks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere.

Because the bundled runtime is large, plugin files may not be transferred by sync services with per-file size limits. Install the plugin separately on each device when necessary.

See the Third-Party Notices for bundled visual assets and runtime dependencies.

WebAssembly module

The packaged Unity WebGL runtime includes a single WebAssembly module, runtime-code.wasm. Unity generates this file from the project source in unity/ReverySkyMap/ as part of the WebGL build process. The binary module contains the compiled Unity runtime and ReverySky 3D Graph code required to render and run the interactive 3D graph inside Obsidian.

License

Original source code and project-owned materials are licensed under the MIT License.

Created and maintained by MoonSkorch Studio.

Third-party visual assets

The built plugin uses several third-party visual assets. Their raw source files are intentionally excluded from Git and must be added manually for local Unity development.

See Third-Party Notices and Unity setup instructions.

Feedback and support

• Bug reports and technical problems: GitHub Issues
• Feedback, ideas, questions, feature suggestions, and general discussion: GitHub Discussions

Future development

ReverySky is built around the idea that every experience and every piece of information is a world of its own. Through their connections, these worlds form a living universe that can be explored, expanded, and shaped.

I want to continue developing ReverySky in this direction through richer visualizations, deeper ways to navigate connected information, and new mechanics.

I’m open to sponsorship, funding, and publishing or marketing partnerships that can help move this work forward.

Contact: [email protected]