Skip to content

Gorkycreator/obsidian-quick-tagger

Repository files navigation

Obsidian Quick Tagger

This is a plugin for Obsidian that adds commands and a GUI to select tags to put in note metadata.

Originally developed to improve my personal workflow, it's very handy in conjunction with Obsidian Commander.

Features

  • Right click on note(s) to add tags in bulk
  • Tag search results in bulk
  • Hotkeyable Command Pallete entry to add or remove tags
  • Configurable Starred Tags for quicker access to your favorites
  • Ribbon icons to add or remove a tag from the current note1

Demo

demo

Note that this demo was recorded on mobile with buttons added to the title bar via Obsidian Commander. Some assembly required. Ribbon icons and command pallet actions are available in the standalone plugin, but this is my preferred workflow.

Menu options

file-menu

search-menu

Starred Tags

Starred tags have the following features, each independently configurable:

  • Add tag to top of the list when selecting a tag using the plugin
  • Add a right-click context entry
  • Add an Obsidian command to toggle the tag on the active note
  • Add a status bar button to toggle the command on the active note

starred-tag-demo

Disclaimer

This plugin is provided as-is, use at your own risk. I've tested it personally and use it on my vault but I can't confirm it's foolproof in every situation.

This plugin does not keep track of changes in an undo/redo queue, please be aware of that while you use it, particularly when bulk tagging or removing all tags.

Roadmap

  • Add a confirmation warning for removing all tags
  • Improved settings menu
  • Starred tags (improved priority tags)
  • Add command for starred tag
  • Add button for starred tag in status bar
  • Add right-click context menu option for starred tag
  • Tweak right-click behavior to toggle tags when tagging a single note
  • Permit adding new tag from tag selector
  • Toggle recently used tag command
  • Tag chains (cycle through a list of tags)
  • Dialog to add many tags to notes
  • Dialog to convert tags to linklist items (and vice versa)2

Manually install the plugin

Copy main.js and manifest.json to your vault VaultFolder/.obsidian/plugins/obsidian-quick-tagger/.

Development notes

The official documentation on tags states only alphanumeric, underscores, hyphens, and forward slashes are supported. I use lots of emojis in tags, which got me thinking about and then testing thousands of unicode characters. The ones I found to be bad are included in the constants file. If you find invalid characters that make it through this filter, please open an issue or create a PR on the constants file.

Special thanks to...

Footnotes

  1. Unfortunately, there's not an easy way to get the currently selected files from the ribbon icon, so bulk tagging is limited to the right-click context menu for now.

  2. For some reason I thought "linklist" was a more official term. Apparently I just picked it up from the example in the 1.4.0 release notes and ran with it.