Introduction to Tracker-miners

The Tracker-miners package contains a set of data extractors for Tracker.



Development versions of BLFS may not build or run some packages properly if dependencies have been updated since the most recent stable versions of the book.

Package Information

Tracker-miners Dependencies


gst-plugins-base-1.22.0, Tracker-3.4.2, Exempi-2.6.3, and gexiv2-0.14.0



asciidoc-10.2.0, CMake-3.25.2, DConf-0.40.0, FFmpeg-5.1.2, libgsf-1.14.50, taglib-1.13, totem-pl-parser-3.26.6, UPower-1.90.0, libcue, libitpcdata, libosinfo, and gupnp

User Notes:

Installation of Tracker-miners



If you plan to run the tests, some timeouts are too short when using spinning disks. There are two places where timeouts are used: first, individual tests inside a group of tests have a default timeout of 10s. This can be changed by setting the environment variable TRACKER_TESTS_AWAIT_TIMEOUT to the desired value when running the tests (see below). Second, a global timeout for a group of tests is fixed at configuration time. The default value in the functional-tests directory (other directories have only short lived tests) may be increased with the following command (replace 200 with a value suitable for your machine):

sed -i s/120/200/ tests/functional-tests/

Install Tracker-miners by running the following commands:

mkdir build &&
cd    build &&

meson --prefix=/usr                 \
      --buildtype=release           \
      -Dsystemd_user_services=false \
      -Dman=false .. &&

To test the results, issue (adjust the individual test timeout to a value suitable for your machine, see the note above):

dbus-run-session env TRACKER_TESTS_AWAIT_TIMEOUT=20 ninja test &&
rm -rf ~/tracker-tests


The tests create files in the user directory (up to 24 MB), so they have to be removed afterwards.

Now, as the root user:

ninja install

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-Dman=false: This switch prevents the build process from generating man pages. Omit this switch if you have asciidoc-10.2.0 installed and wish to generate and install the man pages.

-Dsystemd_user_services=false: This switch prevents the build process from installing systemd units since they are useless on SysV systems.

-Dseccomp=false: This option disables the seccomp system call filter. On some architectures, such as i686 and ARM, the functions that tracker-miners uses are not guarded properly, and tracker-miners will get killed with a SIGSYS as a result.

-Dminer_rss=false: Use this option if you have not installed the recommended dependency libgrss.


Installed Programs: None
Installed Libraries: Several modules under /usr/lib/tracker-miners-3.0
Installed Directories: /usr/lib/tracker-miners-3.0, /usr/libexec/tracker3, and /usr/share/tracker3-miners