Filamental and Obsidian

Your vault, in three dimensions, without leaving Obsidian

3D Filamental Graph is a free community plugin that gives you a quick look at the shape of your vault. The vault itself also opens in the Filamental desktop app, which is a separate thing and the larger half of this page. None of it is trying to replace anything you do in Obsidian.

How they fit

Two applications, one folder, and nothing to migrate

  • They read the same folder. An Obsidian vault is a folder of Markdown files and so is a Filamental space, so one folder can be both at once.
  • They read the same wikilinks. The [[links]] already in your notes are read by both, and neither rewrites them.
  • They don’t conflict. Both can be open on that folder at the same time, and neither takes it off the other.
  • Importing is optional, and offered at the start. Point Filamental at a vault and it offers Import from Obsidian, which turns those wikilinks into real connections you can type and direct, and keeps the fields your notes already have. Opening it as it is takes in every note as well, and keeps the fields each one has.
Inside Obsidian

A quick view of the shape, in a tab you have open

Open it from the ribbon and the graph starts simulating, so notes settle into the shape of your vault rather than the shape of your folders, and clicking one opens the note. What follows is the whole plugin, which is deliberately not very much.

  • It reads what’s there. Your wikilinks, and the connections written in the front matter where a vault holds a Filamental space.
  • Positions stick. Drag a node somewhere deliberate and it’s still there on Friday, kept in the plugin’s own settings rather than in your vault.
  • A panel and a button. The sidebar shows how many links the active note has, and one button opens the folder in Filamental.
  • Free, and desktop only. No account, no trial, no node limit.
Running in a vault tab A vault of the world’s payment rails. Every note in the file list on the left is a node, every link a connection. Nothing was imported and nothing moved.
Close in, it has depth Nearer notes draw larger. Fly in among them, and drag any note to where you want it.
A vault called Payment Rails open in Obsidian, with the 3D Filamental Graph in a tab. The file list on the left runs from Eftpos, ELIXIR and ESAS through FedNow, Fedwire and FPS to Interac e-Transfer and Jumo M-Pesa. The graph is a close view of West African payments: Togo, Guinea-Bissau, Senegal and Benin large in the foreground, RTGS BCEAO, UEMOA - RTGS and Burkina Faso a little further in, and Airtel, MTN MoMo, Orange Money and Wave smaller behind them, every note a red card joined to the others by thin lines. The sidebar on the right reads Filamental, 3 links, above Open 3D Graph and Open in Filamental buttons, and Dark Energy, Spin and Open in Filamental sit under the graph.
The same folder

One folder, and neither of us owns it

Obsidian is open on a second screen here most days, and we use it as the place knowledge goes once it has been worked out. For that job it’s excellent and none of this is aimed at it. Filamental is for the half of the work that hasn’t settled yet and eventually has to be understood by somebody who wasn’t there.

That one folder runs in both directions, which is the useful part. A vault opens in Filamental when you want to see the shape of it, and a space that has reached the end of its useful life drops into a vault, where it goes back to being notes with its structure still in the front matter.

We did it this way because it’s what we wanted for our own work. Anything kept on somebody else’s server is kept on somebody else’s terms, and those terms tend to get rewritten in the direction of whoever wrote them. Let us be the paranoid ones, and you can get on with the writing.

What the desktop app adds

The plugin shows you the shape. The app is where you give it meaning.

Every connection in the quick view is a plain line, because a line is all a quick view can honestly show. It can’t tell you that one note supersedes another, or blocks it, or reports to it, which is precisely what a connection carries in the desktop app.

  • Connections that mean something. A type you name yourself, a direction and a strength, so supersedes, blocks and evidenced by stop being one grey line.
  • Categories and properties. A Person, a Decision and a Contract get their own colour and shape, with the structured facts held on the node rather than buried in prose.
  • Attachments. A file sits on the thing it concerns and opens in whatever normally opens it.
  • Publisher. Send a space to somebody who has never heard of either application.

You keep writing in Obsidian, which is very good at writing, and the structure work happens next door in the same folder.

Bringing an existing vault across

Your wikilinks become the first draft of the structure

If you want a vault to become a Filamental space rather than only be viewed as one, there’s a one-time import that matches each [[wikilink]] to the note it points at and turns it into a real connection, reporting the ones that point nowhere rather than dropping them. Typing those connections is the work, and they arrive untyped on purpose, since the import knows two notes are related and can’t know whether one supersedes the other.

That first pass is the only time a wikilink becomes a connection. After it, a link you type stays a hyperlink you can click, because a link you made while writing a sentence is a different claim from a relationship you meant to assert. Opening a plain folder takes its links in the same way, and what it writes is on the plain Markdown page.

Getting it

Two minutes, and the second half is optional

  • The plugin. In Obsidian, open Settings, then Community plugins, then Browse, and search for 3D Filamental Graph, which is the name it’s listed under, so searching for Filamental alone may not surface it. Install it, enable it, click the icon in the ribbon.
  • The application. Download it free for Windows, macOS or Linux, point it at the same folder, and carry on. Nothing to migrate, and the layout you arranged in the plugin is already there.
In the community plugin browser Search the community plugins for 3D Filamental Graph. Free, and there’s nothing to sign up for.
The 3D Filamental Graph listing inside Obsidian’s community plugin browser, marked INSTALLED, at version 2.2.0, published by CosimoScott, with its repository link and Options, Hotkeys, Disable, Uninstall, Copy share link and Donate buttons. Its page opens: See your vault in 3D. Every note is a node, every wikilink a connection, and physics settles them into the shape your links make. Then: 3D Filamental Graph is free, with no account, and stays free, from the team behind Filamental, the desktop companion app that opens this same vault folder. Below that, What it does lists your whole vault in 3D, physics with Dark Energy and Spin, click a node to open the note and drag it to place it, live updates as you add links, and a sidebar panel.
What it costs

The plugin is free and most people never pay for the rest

The plugin costs nothing and always will, with nothing switched off until you pay, because there’s no paid version of it to sell you.

  • Personal, free and permanent. No account and no card. Spaces are unlimited, the bridges joining them are free, and each space holds twenty nodes, so a vault becomes several linked spaces rather than one enormous one.
  • Fifteen days with everything switched on from first install, so the paid features are something you’ve used rather than a description. When it ends nothing is deleted and nothing is held hostage.
  • Professional, $120 a year or $12 a month. It’s for sending a structure to somebody who doesn’t have Filamental, or presenting it to them, and most Obsidian users never need it.
Asked before installing

Seven straight answers

Is the Obsidian plugin free, or is there a paid version of it?

Free with no restrictions, meaning no account, no trial, no node limit and no feature held back for a paid tier, because there’s no paid version of the plugin to sell you. It’s a quick view rather than a cut-down editor, and it stops there on purpose. The twenty-node limit people ask about belongs to the desktop application's free plan.

Do I need the Filamental desktop app to use the Obsidian plugin?

No. 3D Filamental Graph installs from the Obsidian community plugins list and runs entirely inside Obsidian, drawing your vault as a 3D physics graph in a tab. The desktop application is a separate free download reading the same folder, and it adds what a quick view can’t show: connections carrying a type and a direction, categories, properties, attachments, and sending a structure to somebody else.

Does the plugin change my vault or create duplicate files?

Your notes aren’t touched. There’s no import, no export and no second copy, and the plugin writes nothing into your vault: the positions you drag nodes into live in its own settings, so a layout you arrange is still there next time. Opening the same vault in the desktop application does one thing more, adding Filamental front matter to any note that has none and leaving your prose untouched below it.

What is the difference between a wikilink and a connector?

A wikilink says two notes are related, while a connector says how, carrying a type you name yourself, a direction and a strength. The plugin draws both as the same plain line, since a quick view can show you that two notes connect and not what the connection means, and the desktop application is where that meaning is added.

Can I use the plugin to look at an old Filamental project?

Yes, and it’s one of the two jobs the plugin exists for. A Filamental space is a folder of Markdown files, so a space you’ve finished with can be moved into a vault for keeping, where the notes read as notes and the plugin still draws the structure you built.

Does it work on Obsidian mobile?

No. The plugin is desktop only, on Windows, macOS and Linux, and Filamental is a desktop application on the same three. A 3D physics simulation over a whole vault isn’t worth pretending about on a phone, and Obsidian marks the plugin desktop only so it won’t appear as an option there.

Is Filamental file over app?

Yes. Every node is a plain Markdown file in a folder you choose, readable and editable in Obsidian or any editor with Filamental closed, and the layout is kept separately so the content never depends on it. If Filamental disappeared tomorrow, your notes would still be there as notes.

Start inside Obsidian

Install it, open a vault, and see what shape it has been all along

Free, nothing to sign up for, and it doesn’t touch a single one of your notes.

Platforms
Win / macOS / Linux
Personal
Free, permanent
Professional
$120 / year, or $12 / month