TRACKER3-SEARCH(1)

TRACKER3-SEARCH(1) 💅✨

okay bestie so this is a page from the Tracker manual, and it's all about tracker3-search — the little command that goes digging through literally everything you've got indexed. buckle up 🎀

---

✨ NAME ✨

tracker3-search — search for content by type, or across, like, all the types 💖

---

🦋 SYNOPSIS 🦋

tracker3 search [options...] [resource-type] <search-terms>

---

🌸 DESCRIPTION 🌸

tracker3 search goes through every single bit of indexed content and hunts down your search terms. Results come back in ascending order, no cap.

• <search-terms> — one or more words you're looking for. Give it multiple terms and the default behaviour is a logical AND. Want OR instead? Go look at -r, she's right there.

And listen — if you supply no search terms but you do give a resource-type (like --folders, for example), then it just returns ALL the items in that category. no filter, no chill 😌

Only resources that currently exist get returned by this command. (Check out --all if you wanna know more about that 👀)

---

👑 RESOURCE TYPES 👑

• -f, --files — search for files of any type matching search-terms.
• -s, --folders — search for folders matching search-terms.
• -m, --music — search for music files matching search-terms.
• --music-albums — search for music albums matching search-terms.
• --music-artists — search for music artists matching search-terms.
• -i, --images — search for images matching search-terms.
• -v, --videos — search for videos matching search-terms.
• -t, --documents — search for documents matching search-terms.
• --software — search for software installed matching search-terms. You get back a list of desktop files and application titles found. 🖥️
• --software-categories — search for software categories matching search-terms. You get a list of urns and their categories (think Settings, Video, Utility, etc).
• --feeds — search through RSS feed information matching search-terms. Returns a list of the ones it found. 📡

---

💅 OPTIONS 💅

• -l, --limit=<limit> — caps your search at limit results. Default is 10, or 512 when you're using --disable-snippets. pick your fighter 💀
• -o, --offset=<offset> — shifts the search results by offset. like, start at item number 10 in the results, bestie. default is 0.
• -r, --or-operator — use OR for your search terms instead of AND (which is the default).
• -d, --detailed — shows the unique URN attached to each search result. heads up: this does not apply to --music-albums and --music-artists. 🙈
• -a, --all — shows results that might not actually be available. this could be because a removable media isn't mounted, for example. without this option, resources only show up if they exist. and this option applies to all resource types except --music-artists, --software, --software-categories and --feeds.
• --disable-snippets — by default, results come with snippets. snippets are the context around the word you searched for in the first place, so you get a lil idea of whether the resource you found is actually the right one. 🎯 snippets require Full Text Search to be compile-time enabled AND to not be disabled with --disable-fts. using --disable-snippets only shows you the resources that matched — no context about where the match happened.
• --disable-fts — if Full Text Search (FTS) is available, this option lets you turn it off for one-off searches. it returns results slightly differently, using particular properties to match the search terms (like nie:title) instead of looking for the search terms amongst ALL properties. it's more limiting to do this, but sometimes searching without FTS can yield better results if the FTS ranking is off. lowkey worth a try 🔥
• --disable-color — kills any ANSI color use on the command line. by default it's enabled to make results easier to see. 🌈

---

🔍 SEE ALSO 🔍

tracker3-status(1), tracker3-tag(1), tracker3-info(1).

---

and that's the whole page, bestie!! 🫶 this was version 3.7.1, dated 02/03/2026, straight from the Tracker manual. go search something iconic, you absolute main character 👑💖