Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 10, 2021
 
 

tracker-extract (1)

Name

tracker-extract - Extract metadata from a file.

Synopsis

Please see following description for synopsis

Description

tracker-extract(1)               User Commands              tracker-extract(1)



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.

       -m, --force-module=MODULE
              Force a particular module to be used. This is here as  a  conve-
              nience  for  developers  wanting to test their MODULE file. Only
              the MODULE name has to be specified, not the  full  path.  Typi-
              cally,  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 refer-
              ence 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-1.0/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 sup-
              ported    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/



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------------------+
       |ATTRIBUTE TYPE |        ATTRIBUTE VALUE         |
       +---------------+--------------------------------+
       |Availability   | library/desktop/search/tracker |
       +---------------+--------------------------------+
       |Stability      | Pass-through volatile          |
       +---------------+--------------------------------+
SEE ALSO
       tracker-store(1), tracker-sparql(1), tracker-stats(1), tracker-info(1).

       /usr/lib/tracker-1.0/extract-modules/

       /usr/share/tracker/extract-rules/



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source         was         downloaded        from         https://down-
       load.gnome.org/sources/tracker/1.6/tracker-1.6.0.tar.xz

       Further information about this software can be found on the open source
       community website at https://wiki.gnome.org/Projects/Tracker.



GNU                                July 2007                tracker-extract(1)