NAME

       tracker-extract - Extract metadata from a file.

SYNOPSYS

       tracker-extract [OPTION...] FILE...

DESCRIPTION

       tracker-extract  reads  the  file and mimetype provided in stdin and extract the metadata from this file;
       then it displays the metadata on the standard output.

       NOTE: If a FILE is not provided then tracker-extract will run for  30  seconds  waiting  for  DBus  calls
       before quitting.

OPTIONS

       -?, --help
              Show summary of options.

       -v, --verbosity=N
              Set  verbosity  to  N.  This  overrides  the  config  value.   Values include 0=errors, 1=minimal,
              2=detailed and 3=debug.

       -f, --file=FILE
              The FILE to extract metadata from. The FILE argument can be either a local path or a URI. It  also
              does not have to be an absolute path.

       -m, --mime=MIME
              The MIME type to use for the file. If one is not provided, it will be guessed automatically.

       -d, --disable-shutdown
              Disable shutting down after 30 seconds of inactivity.

       -i, --force-internal-extractors
              Use this option to force internal extractors over 3rd parties like libstreamanalyzer.

       -m, --force-module=MODULE
              Force a particular module to be used. This is here as a convenience for developers wanting to test
              their MODULE file. Only the MODULE name has to be specified,  not  the  full  path.  Typically,  a
              MODULE  is  installed  to  /usr/lib/tracker-0.7/extract-modules/.  This option can be used with or
              without the .so part of the name too, for example, you can use --force-module=foo

              Modules are shared objects which are dynamically loaded at run time. These files must have the .so
              suffix  to  be loaded and must contain the correct symbols to be authenticated by tracker-extract.
              For more information see the libtracker-extract reference documentation.

       -V, --version
              Show binary version.

EXAMPLES

       Using command line to extract metadata from a file:

               $ tracker-extract -v 3 -f /path/to/some/file.mp3

       Using a specific module to extract metadata from a file:

               $ tracker-extract -v 3 -f /path/to/some/file.mp3 -m mymodule

ENVIRONMENT

       TRACKER_EXTRACTORS_DIR
              This is the directory which tracker uses to load the shared libraries from  (used  for  extracting
              metadata  for specific file types). These are needed on each invocation of tracker-store. If unset
              it will default to the correct place. This is  used  mainly  for  testing  purposes.  The  default
              location is /usr/lib/tracker-0.10/extract-modules/.

       TRACKER_EXTRACTOR_RULES_DIR
              This  is  the directory which tracker uses to load the rules files from.  The rules files describe
              extractor   modules   and   their   supported   MIME    types.    The    default    location    is
              /usr/share/tracker/extract-rules/.

       TRACKER_USE_CONFIG_FILES
              Don't  use GSettings, instead use a config file similar to how settings were saved in 0.10.x. That
              is, a file which is much like an .ini file.  These are saved to $HOME/.config/tracker/

SEE ALSO

       tracker-store(1), tracker-sparql(1), tracker-stats(1), tracker-info(1).

       /usr/lib/tracker-0.10/extract-modules/

       /usr/share/tracker/extract-rules/