Installation

Every build is on numen.md. Pick the one for the machine in front of you; the page marks the one it thinks you are on.

macOS

Open the .dmg and drag numen into Applications.

Windows

Run the installer. It brings the web view the window is drawn with, so nothing else has to be installed first.

Windows warns about installers it has not seen before. The warning is about how many people have run this file, not about what is in it: choose More info, then Run anyway.

There is also a plain .zip holding the program alone, for a machine where nothing is to be installed.

Linux

A .deb for Debian and Ubuntu, an .rpm for Fedora and openSUSE, and a .tar.gz holding the program alone.

sudo apt install ./numen-linux-amd64.deb     # or
sudo dnf install ./numen-linux-amd64.rpm

Updating

Install the new build over the old one. Your notes are your files and an install does not touch them; what numen keeps of its own — the list of vaults, the settings, the search index — lives outside the application and survives it.

Where numen keeps its own files

Linux	~/.config/numen/
macOS	~/Library/Application Support/numen/
Windows	%AppData%\numen\

What is in it:

numen.json	the settings, yours to edit.
vaults.json	the vaults this installation knows and which one was open last. numen writes it; you do not.
themes/	your own themes, one .css file each.
agents.json	where an agent reaches the vault, and the token to present. It is there while the window is running.
agents.token	that token, kept so the line in your agent’s configuration goes on working.

Deleting the whole folder forgets which vaults you had and loses nothing you wrote: the notes are your files, and adding the folders again brings the same vaults back.

The search index is not in there. It is index.db in the folder your system keeps caches in — ~/.cache/numen/ on Linux — because that is what it is: everything in it was read out of your files and can be read again.

What numen remembers

Which vault you had open, and the vaults on the list — that is all. Open the window and you get the vault you left, with a fresh plex and a fresh agent beside it; the tabs you had are not put back.

Each vault also carries a .numen/ folder of its own, inside the folder of notes. It holds that vault’s identity — which is how numen recognises the same vault after the folder is moved or renamed — and the text read out of any scanned documents.