# Document Explorer for Silverbullet
**URL:** https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647
**Category:** Plugs and Libraries
**Created:** [December 14, 2025, 4:07pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647 "2025-12-14T16:07:42Z")
**Posts on this page:** 20
**Page:** 3
### Author:  [@JmiXIII](https://community.silverbullet.md/u/JmiXIII)
#### Post date: [December 17, 2025, 4:30pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/41 "2025-12-17T16:30:16Z")
😀 no pb I’m not picky, thanks for sharing your work.
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 18, 2025, 9:26am UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/42 "2025-12-18T09:26:20Z")
# [UPDATE]
## ChangeLog:
- changed the config attribute `listView` from boolean to `viewMode` string with options: `"grid" | "list"`
- for convenience I also added a Button to easily toggle between “grid” and “list” Mode directly in the virtual page
---
### Author:  [@mjf](https://community.silverbullet.md/u/mjf)
#### Post date: [December 18, 2025, 2:31pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/43 "2025-12-18T14:31:41Z")
Works like charm! 👍 [And now something completely different](https://en.wikipedia.org/wiki/And_Now_for_Something_Completely_Different)… `viewMode = 'tree'`! 😇
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 18, 2025, 3:24pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/44 "2025-12-18T15:24:17Z")
Hmmm 🧐🔜(maybe)
[EDIT]
it’s not that simple tho…need to rethink the whole working architecture.
TreeView is different than List/Grid View I think the best way is to create separate VirtualPage Patterns for each viewMode: VirtualPagePattern +`_t` for treeview, `_g` for grid and `_l` for list view. Separating it like this it is more manageable and also the code maintenance is simpler.
---
### Author:  [@ced](https://community.silverbullet.md/u/ced)
#### Post date: [December 18, 2025, 7:36pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/45 "2025-12-18T19:36:24Z")
Great, thank you for the tool !
Do you think it would be possible to view only the files with some choosen extensions, and to view all the files in the choosen folder and all subfolders ?
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 18, 2025, 9:03pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/46 "2025-12-18T21:03:02Z")
> “Anything is possible!”
…which is true.
But the real question is how many features we actually want to add.
This library started out as a simple image grid that displayed files from a folder. Then, inevitably:
- other document types joined the party
- folder navigation was added
- configurability became a requirement
- list view showed up as well
- …
With every new feature, the codebase gets a little heavier and a little harder to manage.
It is entirely possible to build a full-featured file management tool inside SilverBullet. Drag & drop, rename, delete, copy files, the whole lot, either as a library or as a plug.
Don’t get me wrong, I’d love to keep adding features. But I don’t want to inflate the library with complexity just for the sake of it, especially for features that only 5% of users would ever touch and that cover maybe 5% of real-world use cases.
So the real challenge isn’t what we can build, but where we draw the line between a lightweight file visualisation tool and a full-blown file manager.
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 19, 2025, 10:12am UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/47 "2025-12-19T10:12:46Z")
Is this something you had in your mind? What do you think?
it’s nowhere finished yet, but this is how a treeview mode would look like.
But i ran into issues with the treeview, that all folder return to the default collapsed state when refreshing the page. So i need to add some kind of cache to remember it which of the folders were open and which were closed, which adds a lot of complexity to the mix…
need to find a simple solution to this.
# 🤔
---
### Author:  [@mjf](https://community.silverbullet.md/u/mjf)
#### Post date: [December 19, 2025, 12:10pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/48 "2025-12-19T12:10:49Z")
@Mr.Red Awesome, exactly like this. And with current page where I opened the Explorer from highlighted somehow (different background color? whatever…) 🙂
And what about the switching button when there are 2+ view modes? I suggest for the sake of simplicity to rotate the view modes (as there is no select box in SB yet), ordering can be implemented as changing `viewMode` to `viewOrdering`: `viewOrdering: ['list', 'tree', 'grid']` with the first in the list as the default one.
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 19, 2025, 12:59pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/49 "2025-12-19T12:59:20Z")
allready ahead of you:
---
### Author:  [@ChenZhu-Xie](https://community.silverbullet.md/u/ChenZhu-Xie)
#### Post date: [December 19, 2025, 4:39pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/50 "2025-12-19T16:39:14Z")
Apply for Fusion👬!
> Need your **Vertical Connecting Line** -\_-| **|** ← this one, exactly （XD）
[TreeView.css](https://github.com/ChenZhu-Xie/xczphysics_SilverBullet/blob/main/Library/xczphysics/STYLE/Theme/Doom-Two.md#treeview) in Doom-Two theme,
> based on the [Doom-One](https://community.silverbullet.md/t/doom-one-theme-implementation/2270) theme!
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 19, 2025, 9:09pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/51 "2025-12-19T21:09:33Z")
Thanks to @LogeshG5’s PR, now we also have
- `draw.io` & `excalidraw` support
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 20, 2025, 11:10pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/53 "2025-12-20T23:10:37Z")
## The Future of the “DocumentExplorer”: Transitioning to the Sidebar
Hello everyone!
I am currently working on a significant update for **DocumentExplorer**. Based on my experience with the current version, I am moving the explorer from a **VirtualPage** into the **Sidebar**.
While this involves a complete rewrite, it allows for a much more fluid user experience. By living in the sidebar, you can browse your file grid while keeping your active document open, making navigation feel like a native part of the SilverBullet UI.
### 📊 Pros & Cons of the Sidebar Shift
**Pros:**
- **Persistent Access:** Browse your library without navigating away from your current note.
- **Modern Feel:** Utilizes the sidebar real estate for a more “IDE-like” experience.
- **Dynamic Filtering:** Faster search and filtering that doesn’t refresh the whole page.
**Cons:**
- **No “Widget” Mode:** Unlike the VirtualPage version, it cannot be embedded as a widget inside a page.
- **Space Constraints:** Designed for a vertical/side-panel layout rather than a full-width page.
* * *
### 🖼 Sneak Peek: Sidebar Version
_(Note: Working search/filter, breadcrumbs, grid view, and all the file support from the earlier version are already implemented!)_
* * *
### 🗳 Community Poll
I want to ensure this transition is as smooth as possible for current users. How should we handle the library update?
_Poll ([view on site](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/53))_
---
### Author:  [@bau](https://community.silverbullet.md/u/bau)
#### Post date: [December 21, 2025, 8:19am UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/54 "2025-12-21T08:19:17Z")
Great feature !
A suggestion (I dream !): have a single interface to navigate either in the tree or via tags.
It seems to me that the proliferation of tools (sidebar, filterbox, breadcrumb or fastnav type widgets, etc.) complicates navigation (keyboard shortcuts, etc.) without offering a clear vision of the underlying structures.
Thank you for your development !
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 21, 2025, 9:00pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/55 "2025-12-21T21:00:21Z")
I’m kind of seeing where the POLL is going:
I found a third option where i can satisfy (kinda) both camps.
The solution I found and also pushed to Github is:
### Moved the “old”- Virtual Page version to it’s own Library marked as:
`☠️ Virtual Page Document Explorer (Deprecated) (Mr-xRed)`
and the new SidePanel version pushed as an Update for people who already installed the “old” version.
Here are two tlatest Screenshots with different widths and tileSizes:
## ChangeLog
- ⚠ WORK IN PROGRESS - Migrated the Document Explorer to Side Panel
- ⚠ Not all features from the OLD (VirtualPage) version are present.
- Currently only GridView is available
- Added Filter option where you can filter the view for names & extensions for the current folder.
- Added Right-Click Context Menu to Rename & Delete files
Because it’s still work in progress and not fully tested: ⚠ CAUTION is advised
This feature needs to be enabled manualy using: `"enableContextMenu" = true` in the config
- Added New Shortcut Keys to change the width of the Document Explorer Side Panel:
# The UPDATE is LIVE !!!
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 22, 2025, 9:24pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/56 "2025-12-22T21:24:46Z")
# [UPDATE] Document Explorer: Floating Window 🚀 (Ctrl-Alt-w)
I’ve updated the Document Explorer to support the OPTION for a floating, draggable, and resizable layout. This frees up your sidebar and lets you position your file navigation exactly where you want it.
Key Highlights:
- **Draggable** : Grab the top bar to move the explorer anywhere.
- **Resizable** : Use the bottom-right handle to adjust the window size & remembers your custom size and position across sessions.
- **Smart Snapping** : Windows snap to screen edges and stay within your browser bounds (no more “lost” windows).
---
### Author:  [@LogeshG5](https://community.silverbullet.md/u/LogeshG5)
#### Post date: [December 23, 2025, 5:27am UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/57 "2025-12-23T05:27:15Z")
Few observations (in chrome & firefox, using SB 2.3.0)
1. I see an additional box in chrome, which I do not see in your screenshot,
2. I see the drag handler also in file picker and the cursor changes to grab,
I find ‘Filter’ very useful. 👍
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 23, 2025, 6:20am UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/58 "2025-12-23T06:20:12Z")
> I see an additional box in chrome, which I do not see in your screenshot.
That definitely should not be there. This could be either a remnant of the old Tree View Extensions `space-style`, you need to Update that Library too, if you have it. This will delete the `sb-top panel` and `sb-main panel` related `space-styles` from the library . And don’t forget to force Refresh the Page (Shift-F5). If this doesn’t fix it, can you please provide more information about that box? What CSS selector/class does it have?
> I see the drag handler also in file picker and the cursor changes to grab
This was a bug, which I pushed the fix now. I named the panel-header mistakenly as `sb-header` which appears also in the Modal Boxes.
But I renamed it now to `sb-panel-header` so this should be fixed now.
## Thanks for the feedback!
---
### Author:  [@bau](https://community.silverbullet.md/u/bau)
#### Post date: [December 23, 2025, 9:09am UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/59 "2025-12-23T09:09:56Z")
Excellent achievement !
The standardization and modularity of the concept could make it possible to integrate different contexts: navigation of the documentary space, filter of documents (and why not via tags or history?), … Another example [here](https://community.silverbullet.md/t/mindmap-with-markmap-js/1556/16) with the Markmap plugin.
Two observations:
- after Ctrl+Alt+W: the document is (very briefly) moved to the right to make room for the “classic” panel (anchored to the left) then the floating panel appears and the document is refocused, which produces a flash.
- the succession of panel calls (Ctrl+Alt+d | a | w | m for the Markmap plugin) does not always produce the same result depending on the type of panel: There may be overlay, substitution or nothing.
Thank you very much for this excellent work!
---
### Author:  [@marcoswur](https://community.silverbullet.md/u/marcoswur)
#### Post date: [December 23, 2025, 12:23pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/60 "2025-12-23T12:23:06Z")
Thank you for the excellent work.
I prefer the explorer in list view mode. Will this be implemented?
I suggest implementing the “copy path” function in the menu or a button to write the file’s wikilink/path on the page.
Thanks!
---
### Author:  [@Mr.Red](https://community.silverbullet.md/u/Mr.Red)
#### Post date: [December 23, 2025, 8:50pm UTC](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647/61 "2025-12-23T20:50:17Z")
# [Update] ChangeLog
- CopyPath ✅ already implemented (Drag&Drop from document explorer into your page as WikiLink for all know filetypes ) pages/images/pdf’s/excalidraw/drawio
Next Steps:
- List View [soon] yes it will be implemented in future releases.
- TreeView [soon] ditto.
[Previous page](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647.md?page=2)
[Next page](https://community.silverbullet.md/t/document-explorer-for-silverbullet/3647.md?page=4)