LOCALSEARCH-SEARCH(1)

📦
version 3.12.0 · 15 versions
, in arch rolling

💅 LOCALSEARCH-SEARCH — the localsearch manual, bestie edition ✨

okay so this is localsearch-search, straight out of the LocalSearch manual, and it's genuinely the most useful little gremlin in the whole toolbox 🫶

✨ NAME ✨

localsearch-search — literally just search for content, that's the whole gig 🔍💖

🎀 SYNOPSIS 🎀

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

🌸 DESCRIPTION 🌸

localsearch search goes through all your indexed content and hunts down whatever you asked for. Results come back in ascending order — no chaos, no random shuffling, it's giving organized queen energy 👑

search-terms 🦋

One or more words to search for, bestie. When you hand over multiple terms, the default operation is a logical AND — so everything you typed has to match. Wanna do a logical OR instead? Scroll down to -r... wait, no, actually peep the resource type flags, iykyk 💀

ngl if you supply no search terms at all, then all the items come back. Everything. The whole closet. 🙈

Also important: this command only returns resources that currently exist — like, right now, in real time. (Check --all below if you want the messy truth about stuff that might not be there.)

🌈 RESOURCE TYPES 🌈

Pick your fighter 💅 these narrow the search down to one flavour of thing:

  • -f, --files — search for files of any type that match your search-terms 🍓
  • -s, --folders — search for folders that match your search-terms 🎀
  • -m, --music — search for music files that match your search-terms 🎵
  • --music-albums — search for music albums that match your search-terms 💿
  • --music-artists — search for music artists that match your search-terms 🎤
  • -i, --images — search for images that match your search-terms 🖼️
  • -v, --videos — search for videos that match your search-terms 🎬
  • -t, --documents — search for documents that match your search-terms 📄
  • --software — search for software files that match your search-terms 💻

⭐ OPTIONS ⭐

  • -l, --limit=<limit> — cap the search at limit results. No infinity scroll for you, bestie 🛑
  • -o, --offset=<offset> — shift the results by offset. Like, start at item number 10 in the results. The default is 0 🦋
  • -d, --detailed — show the unique URN attached to each search result, plus a snippet of the matched search terms — but only if any was actually provided 👀
  • -a, --all — show results that might not be available. This might be because a removable media isn't mounted, for example. Without this option, resources are only shown if they exist 🫶
  • -m, --mount=<FILE> — if you give it a removable device mount path, the info gets pulled from the specific database for that mount point. If you don't specify one, the data comes from the main instance 🧚
⚠️ okay real talk: -m shows up twice up there — once for --music and once for --mount=<FILE>. That's not me being sloppy, that's literally what's in the manual. Context is your friend 💀

👑 SEE ALSO 👑

Go bother these queens next:

and that's the whole page, bestie — no cap, every flag accounted for 💜

this iconic little number is version 3.12.0, dated 09/15/2026, and it's the localsearch-search(1) page from the LocalSearch manual 🎀✨ slay, go search something 🦋

📦 where this page comes from