Obsidian Stats logoObsidian Stats

Tree Modal

by krannich
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Open files from the file explorer in a modal preview instead of in the editor.

Reviews

No reviews yet.

Stats

stars
20
downloads
0
forks
1
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

Tree Modal

Obsidian plugin that opens files from the file explorer in a modal preview instead of in the editor.

Features

  • Click a file in the tree → 80% viewport modal with Obsidian's native view header (read/edit toggle, full width)
  • Cmd/Ctrl-click → opens the file normally in the editor (escape route)
  • Right-click → "Open in modal" as a fallback (survives Obsidian DOM updates)
  • Internal links inside the modal are captured and opened in-place in the same modal
  • Configurable trigger modifier (none / Shift / Alt)
  • Toggle to hide the center workspace area and give the space to the sidebars
  • Toggle to hide sidebar toggles and sync status icon
  • Optional: ensure a terminal view stays mounted in the right sidebar after startup

Install

Community plugin (once accepted)

Settings → Community plugins → Browse → search "Tree Modal" → Install → Enable.

Manual

  1. Download main.js, manifest.json and styles.css from the latest release.
  2. Copy them into <vault>/.obsidian/plugins/tree-modal/.
  3. Reload Obsidian, then enable the plugin under Settings → Community plugins.

Development

npm install
npm run dev     # watch mode
npm run build   # production build (minified)

For local testing, symlink the plugin folder into your vault:

ln -s "$(pwd)" <vault>/.obsidian/plugins/tree-modal

How it works

The default click handler of the file explorer is intercepted via a DOM event listener on document in capture phase, filtered to .nav-file-title elements. preventDefault() and stopPropagation() block the default "open in editor" behavior; Cmd/Ctrl-click and folder clicks pass through unchanged.

The modal embeds a detached WorkspaceLeaf in markdown mode, so everything Obsidian provides (live preview, wikilink completion, Templater, the native read/edit toggle) keeps working inside the modal.

As a supported second path, a file-menu entry "Open in modal" is registered via the official API, independent of the DOM structure.

Limitations

  • data-path on .nav-file-title is not part of the official plugin API. It works reliably today but could theoretically break with an Obsidian update. The file-menu fallback keeps the core feature usable in that case.
  • Non-markdown files show a hint instead of a preview; Cmd/Ctrl-click opens them normally.

License

MIT

Sponsors