Obsidian Stats logoObsidian Stats

Headless Mode

by Meirakami
5
4
3
2
1
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Run Obsidian headless: hide every window and the Dock icon while Obsidian keeps running from a menu bar (tray) icon, until Headless is unchecked.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Headless Mode

An Obsidian plugin by Meirakami.

Run Obsidian headless: every window hidden, the app removed from the macOS Dock, alive only as a menu bar (tray) icon — until you uncheck Headless from the icon's menu.

Useful when Obsidian is doing background work (sync, automations, plugins that watch the vault) and you don't want it taking up the Dock or window switcher.

How it works

A gem-shaped icon is added to the menu bar (system tray on Windows/Linux). Clicking it opens a menu:

  • Headless (checkbox) — when checked, all Obsidian windows hide and the Dock icon disappears (macOS). Obsidian keeps running. Uncheck to bring the window and Dock icon back.
  • Open Obsidian — shortcut to exit headless mode.
  • Quit Obsidian — fully quits the app.

There are also command palette entries: Toggle headless mode and Go headless.

Settings

  • Start headless — launch Obsidian directly into headless mode.
  • Hide Dock icon while headless (macOS) — on by default; turn off if you want the window hidden but the Dock icon kept.
  • Menu bar icon color — White (default), Black, or Auto. White/Black force an explicit fill; Auto uses a macOS template image that the system tints to match the menu bar.

Cutting a release (maintainer)

  1. Bump version in manifest.json (and versions.json / package.json), commit, push.
  2. npm run build
  3. gh release create <version> main.js manifest.json --title "<version>" — the tag must be the bare semver (no v prefix).

Install (manual)

  1. Build: npm install && npm run build
  2. Copy main.js and manifest.json into <your-vault>/.obsidian/plugins/headless-mode/
  3. Reload Obsidian, then enable Headless Mode under Settings → Community plugins.

Notes

  • Desktop only (isDesktopOnly: true). Dock hiding is macOS-only; on Windows/Linux the tray toggle still hides/shows windows.
  • The plugin always restores the window and Dock icon when it unloads, so disabling it can never strand a hidden app.
  • Quitting from the tray is the reliable way to quit while headless; with the Dock icon hidden there's nothing else to click.
Sponsors