README file from
GithubTags overview - Obsidian plugin
This plugin for Obsidian adds an extended tags panel where tagged files can be overviewed, filtered and accessed in an easy way.
Features
- Display tagged files directly.
- Toggle between list and table view.
- User friendly filter field.
- Additional sort options.
- Displays related tags (more info below).
Related tags
When you filter the list of tags through a search, you can choose to display related tags. By default, the list will only include the tag(s) that are included in the search, but by showing related tags, tags that the files in the search contain are also included. The setting only affects which tags appear in the search results, not the files.
For example:
If a file contains the tags #vehicle and #car, then a search for #vehicle will show both tags in the result. However, files that only contain the #car tag will not be presented in the list.
Nested tags
The plugin supports nested tags, with an option to display nested tags as a tree or a flat list. You can choose to expand or collapse each nested level separately by clicking the arrow next to it.
Filter
Filter the list easily by selecting one or more tags in the dropdown menu. You can choose whether the results must match all search criterias (AND) or just any of them (OR). It is also possible to toggle a tag in the search by clicking on the tag in the results list while holding down ctrl/cmd.
Filter on custom properties (Front matter)
It is possible to extend the filter functionality by adding filters for specific properties (YAML/Front matter). This is easily done from the plugin's settings page.
In the example above, you can see how to add and remove properties to be used for filtering. It is also possible to determine the position on the filter row, as well as the type of filter. There are three different filter types:
- Select: The filter is displayed as a dropdown where all existing values are selectable (same widget as for filtering tags).
- Text: Filtering takes place with free text.
- Number: Only numeric input is allowed. It's possible to choose which compare operator to use (
=,!=,>,>=,<=,<).
In the above scenario, the result looks like this:
Different views
Choose between a table view or a more minimalistic list view. The table view will display the date when the file was last modified. It is possible to change the format of the dates in the plugin settings.
Table view customizations
It is possible to customize which columns should be displayed in the table view, as well as how the content should be aligned. Use the dropdown below the table to add a new column, then use the arrow icons to change the position of the column. The column at the top of the list will appear at the far left of the table.
It is also possible to add properties (Front Matter). Just select the option Property in the "Add column" dropdown, and then select which property you want the column to hold. If you add a property column it will also be possible to order the files based on that property.
Ignore files
It is possible to exclude files from being picked up by the plugin, either per file or by path. No tags will be retrieved from excluded files, nor will they show in the list views.
To ignore a single file, add the custom property tagsoverview and set the value to ignore.
You can also exclude files and folders from the plugin settings page by adding one path per line in the Excluded paths setting. Paths are matched against vault-relative file paths:
/archiveexcludesarchive.mdand all files inside the rootarchivefolder, but notnotes/archive/example.md.archiveexcludesarchive.md, the rootarchivefolder, and any folder namedarchiveelsewhere in the vault./archive/excludes only files inside the rootarchivefolder, notarchive.md.notes/drafts.mdexcludes that exact file.
Usage
Open the panel from the tag icon in the left ribbon, or run Tags Overview: Show panel from the command palette.
Install
Manual installation
Unzip the latest release into your <vault>/.obsidian/plugins/ folder.
Within Obsidian
- Go to
Settings > Community plugins - Ensure that Safe mode is turned off
- Click
Community plugins > Browse - Search for
Tags overview - Click install
- Once installed, close the community plugins window and activate the newly installed plugin