Skip to main content

Quickstart

Welcome to the Vault Explorer Quickstart.

In this tutorial we will cover a few basics to help you get started with the plugin.

Learning outcomes
  • How to open the explorer view
  • How to change views
  • How to open a file from a view
  • How to filter by favorites
  • How to filter by a custom filter group

Installation

If you haven't done so already, please install the Vault Explorer plugin from the Obsidian plugin store.

Open the explorer view

Start by opening the explorer view by clicking on the compass button in the left sidebar.

You may also run Open vault explorer view from the command palette.

Open by button

Open by command palette

Change views

Views are different visual formats for displaying your vault files. When you first open the explorer view, the grid view is active.

Let's change to another view. Change to the list view by clicking the list tab.

List tab

In the list view, you will notice that files are displayed differently. For each file, only a file name and a list of tags is displayed.

List view

Open a file

Now let's open one of the files that appears in this view. Move your mouse and highlight one of the view rows. Then left click on it to open it.

List view

Notice how the active tab changes to the tab that was just opened.

List view

Let's open a new tab without navigating to it. Highlight the row and right click it. Click Open in new tab.

List view

List view

Filter by favorites

When you open the explorer view after installation, no filters are active. Let's enable the favorite filter to filter by favorites.

Start by opening the plugin settings by clicking the gear icon in the upper right corner.

Filter by favorites

Scroll down to the Built-in Properties section

Filter by favorites

Find the Favorite property setting

Click the dropdown and change the value from Select a property to the property that you want to use

Filter by favorites

If no properties are listed, please add a checkbox property to one of your notes. This property will then appear in the dropdown list.

Filter by favorites

Now go to back to the explorer view, and click the favorites checkbox. The view will only display files that have the selected favorite property with a value of true.

Filter by favorites

Add a custom filter group

Now let's create a custom filter group. Using the custom filter we can filter by frontmatter properties or file data.

Start by creating a new note. Add a tags property with a test tag.

Custom filter

Now go back to the explorer view. Open the custom filter by clicking on the filter button.

Custom filter

Now click the add filter group button.

Custom filter

You will see that a filter rule was added when the filter group was added. Let's configure this rule.

Click the property type dropdown. Change it from text to list

Custom filter
Custom filter

Then, click the property name dropdown. Change it from select a property to tags

Custom filter
Custom filter

Enter test into the input field. Although this is a tag, you don't include a hash mark #.

Custom filter
Custom filter

Finally, click outside of the modal.

Click the filter group to enable it. With the filter group enabled, only have files that have a tags property containing a test with be displayed.

Custom filter

Congratulations

Congratulations! You have just learned the basics of using the Vault Explorer plugin.

What's next?