Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/christianwannerstedt/obsidian-tags-overview

Obsidian plugin which adds an extended tags panel where tagged files can be overviewed, filtered and accessed in an easy way.
https://github.com/christianwannerstedt/obsidian-tags-overview

Last synced: 3 months ago
JSON representation

Obsidian plugin which adds an extended tags panel where tagged files can be overviewed, filtered and accessed in an easy way.

Awesome Lists containing this project

README

        

# Tags overview - Obsidian plugin

This plugin for [Obsidian](https://obsidian.md/) 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.

![related-tags](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/9ed3edd0-b6a3-4669-aec1-6bc9158d93ad)

### Nested tags
The plugin supports [nested tags](https://help.obsidian.md/Editing+and+formatting/Tags#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.

![nested-tags](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/3c551140-1c97-4fa4-aeb0-a8bef7608bb3)

### 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](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/f8374340-17da-4fd0-bde3-cebde2e74815)

#### 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.

![property-filters-settings-II](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/7aa5e43c-36fb-4e72-86c2-a260eaf47034)

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:

![property-filters-II](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/5f79431f-41a1-4d3e-802e-fc8a9f9f151e)

### 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.

![display-types](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/bc677992-f1e9-4eb3-93bb-59955aee7120)

#### 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.

![table-columns](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/73dda1c8-c75f-4994-b206-f6067b2552f8)

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.

![table-columns-property](https://github.com/christianwannerstedt/obsidian-tags-overview/assets/25314/dcc36907-114b-490d-badf-5620333495dd)

## Ignore files
It is possible to exclude files to be picked up by the plugin, by adding the custom property `tagsoverview`and set the value to `ignore`. No tags will be retrieved from excluded files, nor will they show in the list views.

## Install

### Manual installation
Unzip the [latest release](https://github.com/christianwannerstedt/obsidian-tags-overview/releases/latest) into your `/.obsidian/plugins/` folder.

### Within Obsidian
1. Go to `Settings > Community plugins`
2. Ensure that Safe mode is turned off
3. Click `Community plugins > Browse`
4. Search for `Tags overview`
5. Click install
6. Once installed, close the community plugins window and activate the newly installed plugin