Zettelkasten

The Archive: Help

Back to the Project Page

How to Get Help Inside the App

Check Out Our Forums

Out community of users is pretty amazing. You should get to know them! We’ll answer any app-related questions on the forums, too, so those coming after you can benefit from your question.

Find discussions about The Archive here:
https://forum.zettelkasten.de/categories/the-archive

Hidden Preferences

Some settings in the app are not exposed as user-customizable preferences. But they can be changed via the thearchive:// URL scheme. For some changes to take effect, you may have to relaunch the app.

To open these URLs, use the Terminal and use the open command, e.g.:

open thearchive://preference/thePreferenceName/set/1234

This also works in your browser if you copy the URL (not the “open” at the beginning)!

Currently supported preferences (replace <PREFNAME> with these):

Frequently Asked Questions

How can I import Finder tags? (Applies to nvALT and DEVONthink, too)

nvALT stores the tags as so-called “Finder tags” in the file metadata. Same for DEVONthink’s exported notes.

This is brittle and only works on Mac. The Archive does not recognize these on purpose, so you don’t tag yourself into a corner.

We provide a converter utility that inserts missing #hashtags into your notes to match the Finder metadata. This should help with the transition!

(back to top)

How do I create notes?

There are different ways to create a note, each with pros and cons depending on your workflow.

  1. Type the note title you want into the Omnibar and hit Return. If you type a term in the Omnibar that is not used as the name of a note already, The Archive will create a matching note for you; if a note exists, it will be opened instead.
  2. Use a Wiki-Link: create a link that leads nowhere, click on it to follow the link. There’ll be no note to show, but the Omnibar contains the link now. Then create a note from the Omnibar as you would above. The Wiki-link feature is built on top of the search. Similar rules apply to entering a term in the Omnibar: if a note with the linked text exists, it will be displayed for you. If there is no matching note, you can hit Return from the Omnibar to create a note with the title set to the search term.
  3. Create an empty note in The Archive without changing your search. Just hit ⌘N (or pick Note ‣ New from the menu). The Archive will create a note for you that will be named “Untitled” and take you right into the editor. After you complete the note you can rename it by hitting ⌘R (or via Note ‣ Rename from the main menu).
  4. Use the “Quick Entry” popup window from anywhere on your system to capture a thought. You have to configure the shortcut in the application preferences (⌘,) to make it globally accessible.

(back to top)

This is how we do it in The Archive by default: every Zettel note gets its own address. This is the note’s ID. (Find out why identifiers are important.)
An ID should never change: it must be fixed and stable. So the note title is not a good candidate as it may change over time. Moments in time are unique and also easy to generate.
We choose date-and-time IDs like 202305181056 which represents the date “2023-05-18 10:56am”.

To create links between notes, you reference the target note by its address, aka its ID.

Even though it sounds obvious to use file names, an arbitrary ID (which should be part of the filename) is more stable.

The Archive tries to be helpful and aid you with these nifty [[Double Bracket Wiki-Links]], which trigger a search. Adhering to the double-square-bracket convention of wikis, you get clickable links using Zettel IDs without buying into any proprietary file format or fragile file paths.

(back to top)

We believe that using a file path-based link isn’t a very durable way to point to your notes. The links break once you move your notes to another directory or drive. This is true for links between notes, but also for incoming links from other apps. Instead, we suggest you simply use the ID of your notes and tell The Archive to look up the result.

A link launches The Archive and opens a matching note works with this external link URL scheme:

For example, thearchive://match/202305181051 will show the note matching “202305181051” in The Archive.

(back to top)

How can I include images in my notes?

The Archive stores notes as plain text, but you can display image files in your notes using the Markdown syntax:

![image title](path/to/image.png)

The result looks like this:

Image files are displayed inside editor

The easiest way is to keep your images in your “media” sub-folder next to your notes and let The Archive manage the files for you. Drag and drop images into your notes, and that’s all you need.

(back to top)

Yes! Here’s how.

Operators are all caps: AND, OR, and NOT. NOT is alternatively expressed by the ! prefix. NOT b is equal to !b and will show notes that have no “b” inside them. ! b (note the space) evaluates as ! AND b.

When you write foo bar, that’s the same as writing foo AND bar. You can also connect phrases with OR to form a set union. Usually, phrases are “words”, i.e. strings of characters separated by whitespace. You can group words into larger phrases with the use of quotation marks: "the archive" will only find this very phrase, sans quotation marks, and not each occurrence of “the” in your notes.

Phrase search wins: "!b" is a phrase search for “!b”, matching the literal exclamation mark and letter. Instead of quotation marks, escaping works, too: \!b. Escaping inside phrase searches will also work: hello "you \"lovely\" specimen". You can also escape parts of reserved words, like the beginning of an operator: \AND will not be treated as an operator.

You can parenthesize expressions: !(foo OR (baz AND !bar) is equivalent to the expanded version, !foo OR !baz AND !foo OR !bar. Be aware that OR and AND do not have correct operator precedence. If you don’t know what that means, you probably do not need to care.

(back to top)

How can I assign custom shortcuts?

You can assign a shortcut to anything that’s available in The Archive’s main menu. Follow the excellent instructions by Apple.

(back to top)

Sending in Log Files for Errors

You can send log files from within the app by choosing Help ‣ Send Log Files…. This will attach log files of up to 5 days of app activity. You can remove irrelevant log files from the email draft.

Please make sure to delete confidential information from the log if necessary using any text editor.

Sending in Crash Reports

macOS 10.12 and later:

macOS 10.11 and earlier: