Skip to content

StressTestor/galaxy-graph

Repository files navigation

galaxy graph

obsidian's graph view is a flat web of connected dots. this renders your vault as a 3d galaxy you fly through instead.

notes are stars. folders are colors. wikilinks pull stars together into clusters. the busiest note sits at the core as a black hole. orphan notes drift in the outer void.

galaxy graph

it's read-only. it just looks at your vault and draws it, never touches your notes.

what it does

  • stars = notes - bigger star = more links
  • color = top-level folder - each folder gets its own hue
  • constellations on demand - hover a star and its linked neighbors light up
  • black-hole core - the most-connected note anchors the center
  • nebula - each folder-cluster gets a soft cloud of haze
  • twinkle - stars pulse slowly (recently-edited notes flare brighter)
  • search to fly - search a note and the camera flies to it
  • freecam - WASD to fly, arrow keys to look, click a star to open the note

install

from a release (easiest)

  1. grab manifest.json, main.js, and styles.css from the latest release
  2. drop them in <your-vault>/.obsidian/plugins/galaxy-graph/
  3. obsidian -> settings -> community plugins -> enable Galaxy Graph
  4. command palette (Cmd/Ctrl+P) -> Galaxy Graph: Open

from source

git clone https://github.com/StressTestor/galaxy-graph
cd galaxy-graph
npm install
npm run build

then copy manifest.json, main.js, and styles.css into <your-vault>/.obsidian/plugins/galaxy-graph/ and enable it.

controls

key does
W A S D fly forward / left / back / right
Q E / Space rise / descend
arrow keys look around (yaw / pitch)
Shift boost
click a star open that note
drag orbit
scroll zoom

settings (folder colors, nebula, black hole, bloom, fly speed, etc) live under settings -> Galaxy Graph.

requires

desktop obsidian, 1.4.0+. it uses webgl, so it's desktop-only.

license

MIT

About

fly through your obsidian vault as a 3d galaxy. notes are stars, folders are colors, the core is a black hole.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors