Skip to content

Settings and Workspace

CassiusAmicus edited this page Jul 7, 2026 · 1 revision

Settings and Workspace

Open settings with the gear icon (⚙) in the header, or press Ctrl+,.

View settings

Setting What it does
Theme Light or dark
Top bar colour Accent colour for the header bar
Outline format Bullets / numbers / letters / upper letters — globally or per depth level
Font Font family globally or per depth level
Node colour Text colour globally or per depth level
Vertical lines Show indentation guides
Tag chips Show/hide tag chips inline in the outline
Tags on right Move tag chips to the right margin
Reading width Constrain outline to a comfortable reading width
Status bar Show/hide the bottom status bar
Title format Toggle between plain and formatted (markup-rendered) titles
Notes visible Show/hide body text globally (individual notes can still be pinned open)

Editor settings

Setting What it does
Date stamp format Format used when inserting date stamps (Ctrl+D): M/D/YYYY, YYYY-MM-DD, or Mon D

Files settings

Setting What it does
Home directory Root directory served by Epicorg
Home file File opened automatically on launch
Journal directory Directory scanned for date-named journal files
Tag list file .org file whose top-level headlines define the autocomplete tag list
Bookmark list file .org file whose top-level headlines define quick-access bookmarks

Export settings

See Export and Import for full details on each option.

Keyboard shortcuts

The Keyboard Shortcuts section in Settings lists every shortcut and lets you rebind any of them. Click a shortcut row, press your desired key combination, and it is saved immediately.

Click Reset next to a shortcut to restore its default. Click Reset all shortcuts to restore all defaults at once.

Toolbar customisation

Drag toolbar buttons to reorder them. Toggle the visibility of individual buttons with the checkboxes in the Toolbar section.

Workspace

The workspace defines which directories are searched in Workspace Search, shown in the Sidebar file list, and scanned for cross-file TODOs and Backlinks.

Configuring search paths

Click Settings → Workspace → Configure… to open the workspace path builder.

You can add multiple root directories:

  • Home directory — always included; the primary org directory Epicorg is serving
  • Additional roots — any other directories on your machine you want to include

Each root can be given a label (e.g. "Work", "Personal") that appears in search results to identify which root a result came from.

Sidebar

The sidebar has two sections:

Files

Lists all .org files in the home directory. Subdirectories are shown with their files nested. Click a file to open it.

Saved Searches

Lists your pinned workspace search queries. An empty-state hint is shown when no searches have been saved yet, so the feature is always discoverable.

Detail pane

The detail pane (right side) shows the following for the focused node:

  • Title — read-only display of the node's formatted title
  • Status — click to cycle TODO / NEXT / DONE / CANCELLED
  • Priority — A, B, or C
  • Tags — edit tags inline
  • Scheduled — date picker for the planned work date
  • Deadline — date picker for the due date
  • Properties — key-value table; add custom fields with the + button
  • Linked References — backlinks from other files (expanded by default)
  • Unlinked Mentions — plain-text mentions without a formal link (expanded by default)

Toggle the detail pane with the detail icon in the header or Ctrl+Shift+D.

Clone this wiki locally