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/