Introduction to Tracker-miners

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

This package is known to build and work properly using an LFS 12.0 platform.

Package Information

Tracker-miners Dependencies


gst-plugins-base-1.22.5, Tracker-3.5.3, Exempi-2.6.4, and gexiv2-0.14.2



asciidoc-10.2.0, CMake-3.27.2, DConf-0.40.0, FFmpeg-6.0, libgsf-1.14.50, NetworkManager-1.44.0, taglib-1.13.1, totem-pl-parser-3.26.6, UPower-1.90.2, libcue, libitpcdata, libosinfo, and gupnp

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 setup --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