Obsidian Stats logoObsidian Stats

Ultra Zen Mode

by Marcos
5
4
3
2
1
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Enter a distraction-free zen mode by hiding sidebars, properties, title and status bar. Works on desktop and mobile.

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

Ultra Zen Mode

A lightweight Obsidian plugin that clears the screen so you can read and write without distractions. One tap hides everything you don't need; a floating button brings it all back the moment you want it.

Works on desktop, tablet, and mobile.

What it does

When you activate Zen Mode, Ultra Zen Mode hides the parts of the Obsidian interface that aren't your content:

Element Hidden by default
Left sidebar (ribbon + panel) ✅
Right sidebar ✅
Note properties / frontmatter ✅
Tab bar ✅
Status bar ✅
Inline note title ❌ (optional)

A small floating exit button appears in the bottom-right corner of the screen. It stays out of your way (very transparent) until you hover or tap it, then it comes forward so you can exit Zen Mode with one click.

How to activate

Three ways — use whichever feels natural:

  1. Ribbon button — click the glasses icon (🕶) in the left icon bar.
  2. Command palette — open it with Ctrl/Cmd + P, search for Toggle Zen Mode.
  3. Hotkey — assign a keyboard shortcut in Settings → Hotkeys → Ultra Zen Mode: Toggle Zen Mode.

To exit, click the floating button that appears in the bottom-right corner, or use any of the three methods above again.

Settings

Open Settings → Ultra Zen Mode to choose exactly what gets hidden:

  • Hide left sidebar — hides the icon ribbon and the sidebar panel on the left.
  • Hide right sidebar — hides the sidebar panel on the right.
  • Hide note properties — hides the YAML frontmatter / properties block at the top of a note.
  • Hide note title — hides the large inline title above the note body.
  • Hide status bar — hides the small bar at the very bottom of the window.
  • Hide tab bar — hides the row of open-note tabs above the editor.

All toggles take effect the next time you enter Zen Mode, so you can experiment freely.

Installation

From the Community Plugin store (once published)

  1. Open Settings → Community plugins and disable Safe Mode if asked.
  2. Click Browse, search for Ultra Zen Mode, and install it.
  3. Enable the plugin with the toggle.

Manual installation

  1. Download main.js, styles.css, and manifest.json from the latest release.
  2. Create the folder .obsidian/plugins/ultra-zen-mode/ inside your vault.
  3. Copy the three files into that folder.
  4. Restart Obsidian (or reload plugins via Settings → Community plugins → Reload plugins).
  5. Enable Ultra Zen Mode in Settings → Community plugins.

Development

Requirements: Node.js ≥ 18 and npm.

# Clone and install dependencies
git clone https://github.com/MarckFp/ultra-zen-mode
cd ultra-zen-mode
npm install

# Watch mode — rebuilds on every file save
npm run dev

# Production build (minified, no sourcemap)
npm run build

The plugin is written 100% in TypeScript — no JavaScript source files. The build pipeline is:

src/main.ts  →  esbuild (via esbuild.config.ts + tsx)  →  main.js

Copy main.js, styles.css, and manifest.json into your vault's plugin folder to test locally.

How it works (technical overview)

Ultra Zen Mode is intentionally simple and fast. The entire logic lives in a single file, src/main.ts, and works in three steps:

  1. Activate — adds a set of CSS classes (e.g. uzm-hide-left-sidebar) to document.body.
  2. Style — styles.css contains scoped rules that hide the target elements only while those classes are present. Nothing leaks outside of Zen Mode.
  3. Deactivate — removes all classes and the floating button. The UI is instantly restored; no DOM manipulation required.

Because the approach is pure CSS class toggling, it is extremely fast and does not rely on timers, MutationObservers, or any polling.

License

MIT

Sponsors