For years, I have used a snippet named Folder Hider
that does basically this:
.nav-file [data-path="path/to/file.md"],
.nav-folder-title[data-path^="path/to/folder"],
.nav-folder-title[data-path^="path/to/folder"] + .nav-folder-children {
display: none;
}
This snippet hides files I don't want to see.
However, managing a snippet has some caveats:
- Renaming or moving the file or folder will break the snippet.
- I need to know the entire path of the file or folder, including case sensitivity.
- I have to constantly edit the snippets if I want to hide a new file or folder.
- It's not possible to unhide individually (unless using a separate snippet for each file).
So, I decided to create a plugin to manage this for me!
To hide a file or folder, you can right-click on the file/folder in the explorer and select Hide << name >>
.
If Always hide in bookmark
is enabled, the file/folder will also be hidden in the bookmarks when the command is used from the explorer.
Tip
For folders, the rule will be ^=
(starts with) and for files =
(exact match).
See Experimental for more information about the bookmarks panel and shortcuts.
Using the "eye" ribbon button, you can enable or disable all the rules.
- Show all will display all the hidden files/folders (ignoring the rules).
- Hide all will restore the previous state (based on the hidden parameters).
The settings are divided into two parts:
It also displays a list of all the rules, with the option to:
- Delete them
- Hide from explorer
- Hide in the bookmarks
For string
rules, you can also edit the attribute selector and the rule itself.
You can choose to save the CSS in a snippet (in your .obsidian/snippets
folder) or directly inject it into the page. Use this if, for example, you want to keep the folder hidden without using the plugin (for instance, when disabling or uninstalling it).
Warning
This option will be disabled if the bookmarks plugin is not enabled.
You can choose to hide files in the bookmarks panel too. This will hide the file in the bookmarks panel when the command is used from the explorer.
It is possible to add a button in the file-menu of the bookmarks panel that allows hiding files from bookmarks. However, this feature has some caveats and bugs.
- Currently, there is no way to use the API for creating the file-menu, so I had to use a workaround that can cause some visual bugs and weird behavior.
- The HTML data of the bookmarks only displays the path in the bookmarks, not the real path. This path is needed to hide the file, so in some conditions, the bookmarks will be registered as a
string
and not a file (this mostly appears if the file is registered under a group). Consequently, it won't be followed if the bookmark is renamed or moved. - If two identical bookmarks exist (i.e., they lead to the same file, even with different names), only one will be detected and hidden. If the same file is in two different groups, the bug doesn't occur.
Using attribute selectors, you can hide multiple files or folders at once. For example, to hide all the files in a folder, you can set [startswith] <path>
. See CSS attribute selectors for more information.
Each attribute corresponds to:
Attribute | CSS | Description |
---|---|---|
Exact | = |
Exact match with the string |
Contains | *= |
Contains the string |
Ends with | $= |
Ends with the string (suffix) |
Starts with | ^= |
Starts with the string (prefix) |
List | ~= |
String is a whitespace-separated list of words, one of which matches exactly |
Text followed by hyphen | |= |
The match can be on exactly the value or can begin with the value immediately followed by a hyphen (- ) |
The result will be:
- For explorer:
.tree-item [data-path{selector}="path"] { /* Notice the space between the class and the attribute */ display: none; }
- For bookmarks:
.tree-item[data-path{selector}="path"] { display: none; }
Note
If the tree for bookmarks and explorer is changed by the Obsidian team, the plugin/snippets will break. I will try to keep it updated, but I can't guarantee it.
- From Obsidian's community plugins
- Using BRAT with
https://github.com/Mara-Li/obsidian-explorer-hider
→ Or use the protocol by pasting it in your web browser:obsidian:https://brat?plugin=https://github.com/Mara-Li/obsidian-explorer-hider
- From the release page:
- Download the latest release
- Unzip
explorer-hider.zip
in the.obsidian/plugins/
path - In Obsidian settings, reload the plugin
- Enable the plugin
- English
- French
To add a translation:
- Fork the repository.
- Add the translation in the
src/i18n/locales
folder with the name of the language (e.g.,fr.json
).- You can get your locale language from Obsidian using obsidian translation or using commands (in templater, for example):
<% tp.obsidian.moment.locale() %>
- Copy the content of the
en.json
file into the new file. - Translate the content.
- You can get your locale language from Obsidian using obsidian translation or using commands (in templater, for example):
- Edit
i18n/i18next.ts
:- Add
import * as <lang> from "./locales/<lang>.json";
- Edit the
resources
part by adding:<lang>: {translation: <lang>}
- Add