Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

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 FILE


DESCRIPTION
       tracker  extract  reads  the file provided and extracts any metadata it
       can from this file, then displays the metadata on standard output.

       The metadata is displayed as a SPARQL update command, that can  be  run
       against a SPARQL endpoint to update its copy of the metadata.

       The  actual  extraction  is done by a separate process. This is done to
       isolate the calling process from any memory leaks  or  crashes  in  the
       libraries Tracker uses to extract metadata.

       For  more  information  see the libtracker-extract reference documenta-
       tion.


OPTIONS
       -v, --verbosity=<LEVEL>
              This sets the log verbosity for the extractor process.

              The possible LEVEL options are:

               o   debug - Show EVERYTHING, from debug messages to errors.

               o   detailed - Show enough detail to understand what is happen-
                   ing.

               o   minimal - Show an overview of what is going on

               o   errors  -  Show  only  warnings, criticals, errors or fatal
                   events.


       -o, --output-format=<FORMAT>
              Choose which format to use to output results. Supported  formats
              are sparql, turtle and json-ld.


EXAMPLES
       Using command line to extract metadata from a file:

               $ tracker extract /path/to/some/file.mp3


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-miners |
       +---------------+---------------------------------------+
       |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
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source was downloaded from  https://download.gnome.org/sources/tracker-
       miners/2.3/tracker-miners-2.3.5.tar.xz.

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



GNU                               April 2016                tracker-extract(1)