TRACKER3-TAG(1)

💖 TRACKER3-TAG 💖

okay bestie, welcome to tracker3-tag — the part of the Tracker manual, and literally the cutest way to add, remove and list tags. 🏷️✨

---

🌸 SYNOPSIS 🌸

tracker3 tag FILE1 [FILE2 ...] [-l <limit>] [-o <offset>] [-r]
tracker3 tag -t [[TAG1] [TAG2] ...] [-s] [-r]
tracker3 tag -a <TAG> [-e <description>]
tracker3 tag -d <TAG>

---

🦋 DESCRIPTION 🦋

So here's the tea ☕: you can list tags for local files, or list them by the tag labels themselves if you bring -t along. Two whole moods, one command. 💅

You can also manage tags using the -a and -d options — adding them, deleting them, full main character energy. 👑

And the FILE argument? It can be either a local path or a URI. It also does not have to be an absolute path. no cap, it's flexible like that. 🫶

---

✨ OPTIONS ✨

• -t, --list — List ALL the tags. 🔥 The results include the number of files associated with that tag and the tag's unique identifier. Wanna see the files hanging out with each tag? Use --show-files. iykyk.

The TAG arguments are optional, bestie. If no TAG argument is specified, all tags are listed. If one or more TAGs are given, either matching tags are listed (OR condition). For example, this will match any tags named either foo, bar or baz:

$ tracker3-tag -t foo bar baz

• -s, --show-files — Show the files associated with each tag. 🗂️ But listen — this option is ONLY available WITH the --list option. Not me showing up without -t… embarrassing. 😭
• -a, --add=TAG — Add a tag with the name TAG. ➕ If no FILE arguments are specified, the tag is simply created (if it didn't already exist) and no files are associated with it. Multiple FILE arguments can be specified. go off. 💖
• -d, --delete=TAG — Delete a tag with the name TAG. 🗑️ If no FILE arguments are specified, the tag is deleted for ALL files. If FILE arguments are specified, only those files have the TAG deleted. choose wisely bestie.
• -e, --description=STRING — This option ONLY applies when using --add, and it provides a description to go with the tag label according to STRING. 📝 giving your tag a lil personality.
• -l, --limit=N — Limit search to N results. 🔢 The default is 512.
• -o, --offset=N — Offset the search results by N. 🎯 For example, start at item number 10 in the results. The default is 0.
• -n, --and-operator — Use AND operator for search terms instead of OR (the default). 🧠 For example:

$ tracker3-tag -s -t sliff sloff

Should show files in the database that have both the sliff and sloff tags. both, not either. iconic behaviour honestly. 🌈

---

👀 SEE ALSO 👀

tracker3-sparql(1), tracker3-search(1), tracker3-info(1) — go read your siblings, they're family. 🫶

---

aaaand that's the whole page, bestie!! this one's from Tracker 3.7.1, dated 02/03/2026 — screenshot it, tag it, slay it. 💅🎀✨ bye bye!! 💖🦋🌸