TRACKER-MINER-FS-(1)

📦
version 3.7.1 · 7 versions
, in ubuntu noble

💖 TRACKER-MINER-FS-3 💖

okay bestie, welcome to the tracker-miner-fs-3 page from the Tracker manual — she's the little file-system crawler that mines your data, and yes she ate ✨

🌸 SYNOPSIS 🌸

tracker-miner-fs-3 [OPTION...]

🦋 DESCRIPTION 🦋

okay so real talk: tracker-miner-fs-3 is not supposed to be run by you, bestie 😭 she gets started by her .desktop file when you log in. but like, obviously you can start her manually if you're debugging — no one's stopping you 💅

the one thing you literally cannot do? run more than one instance of her at the same time. not happening. it's giving exclusive. 🙅‍♀️

and what does she actually do? tracker-miner-fs-3 mines information about applications and files only. that's the whole vibe. nothing else. periodt. 👑

✨ OPTIONS ✨

  • -?, --help — shows you a lil summary of all the options. your cheat sheet, bestie 🫶
  • -V, --version — returns the version of this binary. so you know exactly which queen you're talking to 💖
  • -s, --initial-sleep=SECONDS — sets the initial sleep time before the crawl of the file system starts up 😴 ngl it's a lil nap before the chaos. but heads up: if you're using the --no-daemon option, this one gets ignored. she said "not today" 💀
  • -n, --no-daemon — tells the miner to exit once all indexing has finished and the database is up to date ✅ this is not the default mode of operation, jsyk — usually she sticks around acting like a daemon, monitoring file updates that might happen over time. main character who never leaves the party 🎉 and also? this option renders the --initial-sleep option moot. like, fully irrelevant. gone. 💅
  • -e, --eligible=FILE — checks if FILE is eligible for being mined, based on the current configuration rules 🔍 and not only that — she'll also check if FILE would be monitored for changes 👀 and here's the cute part: this works with non-existing FILE arguments as well as existing FILE arguments. equal opportunity file checking, we love to see it 🌈

🌟 ENVIRONMENT 🌟

  • G_MESSAGES_DEBUG — controls the verbose log output from GLib-based code 📝 use G_MESSAGES_DEBUG=Tracker to see only Tracker-related logs, or G_MESSAGES_DEBUG=all to see literally everything. all the tea, no filter ☕
  • TRACKER_DEBUG — enables more specialized debug output 🛠️ pass a comma-separated list of one or more keywords:
    • config — miner configuration
    • miner-fs-events — internal processing of tracker-miner-fs
    • monitors — change events from filesystem monitors
    • statistics — show statistics about how many files were processed
    • status — log the status messages that are published over D-Bus

🎀 SEE ALSO 🎀

tracker3-info(1).

lowkey that's the whole page bestie, go forth and crawl 🧚✨

version 3.7.1, dated 02/03/2026 — mwah, love u, bye 💜🌸

📦 where this page comes from