← All help

Open a Folder as a Project

Choose Folder in Start Something… and pick a folder, and every file inside becomes a node you can arrange, connect and write about, while the files stay exactly where they are.

Where: Top bar › your project's name › Start Something… › Folder (or Open)

What it is

Any folder on your computer can become a Filamental project, so you can see what's in it as a structure and start connecting it, without copying anything or deciding up front how it should be organised. If you'd rather an AI read the documents and build the structure for you, see Explore a Folder or Document with AI.

How to use it

  1. Click Start Something…, choose Folder and pick the folder.
  2. Filamental looks inside first. A project just opens, an Obsidian vault is offered its import (see Working with Obsidian), and anything else gets a short step saying it isn't a Filamental project yet.
  3. Decide about sub-folders, if it has any (see below).
  4. Click Open as a project.

Every file becomes a node. Notes that link to each other with [[wikilinks]] are connected, and PDFs, images and other files arrive as file nodes that open in their usual app when you double-click them. The project joins your list in the Projects Window.

Sub-folders as classifications

If the folder has sub-folders, you'll see Use sub-folders as classifications. Switch it on and the files in each top-level sub-folder go into a classification named after it, PDFs and images included. Files sitting in the top folder stay unclassified, and deeper sub-folders take the classification of the top-level one they're inside. Leave it off and everything arrives unclassified, ready for you to sort in the Left Panel.

What happens to your files

Nothing is moved, renamed or deleted. Your notes get Filamental's details added to their front matter, keeping any fields they already have, so Obsidian and other apps read them as before. A hidden .filamental folder inside holds the layout and the project's settings. More in How Your Files Are Stored.

A folder inside another project

If the folder you choose sits inside a project you already have, Filamental says so first. Opening it makes it a separate project, and the outer project then shows it as a single bridge node that takes you into it. See Bridges.

Read-only projects

A project that isn't on your list in the Projects window opens read-only, with a Read-only strip at the top: usually a project folder somebody sent you, or one you opened through Open and haven't added yet. While it's read-only, Filamental switches off the actions that add to it, among them connecting nodes and adding nodes from the left panel. A read-only open writes nothing into your notes, so a note without Filamental's details doesn't appear as a node yet. Click Add to shortcuts and edit on the strip, and the project joins your list and opens for editing, on any plan, with every note in it.

When a project won't open

A project whose folder has moved or been deleted shows a warning sign on its card in the Projects Window, where you can point it at the folder's new place. If a folder can't be opened for another reason, Filamental says why, with Go Back (to the project you had open) and Choose Different Folder.

  • A note file could not be read names the note. Open it in a text editor and check it starts with valid --- front matter.
  • A config file is corrupt names a file in .filamental. Try again, and if it persists, delete that one file and Filamental recreates it with its defaults.

Tips

  • Files you add to the folder while it's open appear as nodes by themselves. A plain note with no Filamental details yet joins the next time the project opens.
  • A few hundred unconnected nodes is a lot to look at. Highlight one classification at a time (see Highlighting) and connect as you go.
  • A note whose front matter Filamental can't read (broken, or saved with a byte-order mark by some older Windows editors) is left as it is and won't appear as a node. Fix the note and open the project again.

How this helps you

Use it when you have a folder of research, a client's documents or years of notes, and you'd like to see how they fit together without reorganising a thing first.

Related

Still stuck? Email [email protected].