mactag.yazi

mactag.yazi

Bring macOS's awesome tagging feature to Yazi! The plugin it's only available for macOS just like the name says.

Authors: @AnirudhG07, and @sxyazi

screenshot-002041.mp4

Installation

Install the plugin itself, and jdberry/tag used to tag files:

ya pack -a yazi-rs/plugins:mactag
brew update && brew install tag

Setup

Add the following to your ~/.config/yazi/init.lua:

require("mactag"):setup {
	-- Keys used to add or remove tags
	keys = {
		r = "Red",
		o = "Orange",
		y = "Yellow",
		g = "Green",
		b = "Blue",
		p = "Purple",
	},
	-- Colors used to display tags
	colors = {
		Red    = "#ee7b70",
		Orange = "#f5bd5c",
		Yellow = "#fbe764",
		Green  = "#91fc87",
		Blue   = "#5fa3f8",
		Purple = "#cb88f8",
	},
}

And register it as fetchers in your ~/.config/yazi/yazi.toml:

[[plugin.prepend_fetchers]]
id   = "mactag"
name = "*"
run  = "mactag"

[[plugin.prepend_fetchers]]
id   = "mactag"
name = "*/"
run  = "mactag"

Usage

Besides displaying tags attached to files, you can also add or remove tags within Yazi using this plugin.

Add following keybindings to your ~/.config/yazi/keymap.toml to enable it:

[[manager.prepend_keymap]]
on   = [ "b", "a" ]
run  = 'plugin mactag --args="add"'
desc = "Tag selected files"

[[manager.prepend_keymap]]
on   = [ "b", "r" ]
run  = 'plugin mactag --args="remove"'
desc = "Untag selected files"

License

This plugin is MIT-licensed. For more information check the LICENSE file.