1tracker-extract(1)               User Commands              tracker-extract(1)
2
3
4

NAME

6       tracker-extract - Extract metadata from a file.
7
8

SYNOPSYS

10       tracker-extract [OPTION...] FILE...
11
12

DESCRIPTION

14       tracker-extract  reads  the  file  and  mimetype  provided in stdin and
15       extract the metadata from this file; then it displays the  metadata  on
16       the standard output.
17
18       NOTE:  If  a  FILE is not provided then tracker-extract will run for 30
19       seconds waiting for DBus calls before quitting.
20
21

OPTIONS

23       -?, --help
24              Show summary of options.
25
26       -v, --verbosity=N
27              Set verbosity to N. This overrides  the  config  value.   Values
28              include 0=errors, 1=minimal, 2=detailed and 3=debug.
29
30       -f, --file=FILE
31              The  FILE  to  extract  metadata  from. The FILE argument can be
32              either a local path or a URI. It also does not  have  to  be  an
33              absolute path.
34
35       -m, --mime=MIME
36              The  MIME  type  to use for the file. If one is not provided, it
37              will be guessed automatically.
38
39       -d, --disable-shutdown
40              Disable shutting down after 30 seconds of inactivity.
41
42       -i, --force-internal-extractors
43              Use this option to force internal extractors  over  3rd  parties
44              like libstreamanalyzer.
45
46       -m, --force-module=MODULE
47              Force  a  particular module to be used. This is here as a conve‐
48              nience for developers wanting to test their  MODULE  file.  Only
49              the  MODULE  name  has to be specified, not the full path. Typi‐
50              cally, a MODULE is  installed  to  /usr/lib/tracker-0.7/extract-
51              modules/.   This option can be used with or without the .so part
52              of the name too, for example, you can use --force-module=foo
53
54              Modules are shared objects which are dynamically loaded  at  run
55              time. These files must have the .so suffix to be loaded and must
56              contain the correct symbols  to  be  authenticated  by  tracker-
57              extract.  For more information see the libtracker-extract refer‐
58              ence documentation.
59
60       -V, --version
61              Show binary version.
62
63

EXAMPLES

65       Using command line to extract metadata from a file:
66
67               $ tracker-extract -v 3 -f /path/to/some/file.mp3
68
69
70       Using a specific module to extract metadata from a file:
71
72               $ tracker-extract -v 3 -f /path/to/some/file.mp3 -m mymodule
73
74

ENVIRONMENT

76       TRACKER_EXTRACTORS_DIR
77              This is the directory which tracker  uses  to  load  the  shared
78              libraries  from  (used for extracting metadata for specific file
79              types). These are needed on each invocation of tracker-store. If
80              unset  it will default to the correct place. This is used mainly
81              for testing purposes.
82
83

FILES

85       $HOME/.config/tracker/tracker-extract.cfg
86
87

SEE ALSO

89       tracker-store(1), tracker-sparql(1), tracker-stats(1), tracker-info(1).
90
91       tracker-extract.cfg(5).
92
93       /usr/lib/tracker-0.7/extract-modules/
94
95
96
97GNU                                July 2007                tracker-extract(1)
Impressum