NAME

       tracker-tag - Add, remove and list tags.

SYNOPSIS

       tracker-tag [OPTION...] FILE [FILE...]
       tracker-tag [OPTION...] -t [[TAG] [TAG] ...]

DESCRIPTION

       tracker-tag  allows  the  caller add tags, remove tags and list tags by URN or to list all
       tags and the files associated with them.

       The FILE argument can be either a local path or a URI. It also does  not  have  to  be  an
       absolute path.

OPTIONS

       -?, --help
              Show summary of options.

       -l, --limit=N
              Limit search to N results. The default is 512.

       -o, --offset=N
              Offset  the  search  results  by  N.  For  example,  start at item number 10 in the
              results. The default is 0.

       -r, --or-operator
              Use OR for search terms instead of AND (the default)

       -t, --list
              List all tags. Results include the number of files associated with that tag and the
              tag's  unique  identifier. You can show the files associated with each tag by using
              --show-files.

              The TAG arguments are optional. If no TAG  argument  is  specified,  all  tags  are
              listed.  If  one or more TAGs are given, all matching tags are listed. For example,
              this will match any tags named either foo, bar or baz:

              $ tracker-tag -t foo bar baz

       -s, --show-files
              Show the files associated with each tag. This option is  ONLY  available  WITH  the
              --list option.

       -a, --add=TAG
              Add  a tag with the name TAG. If no FILE arguments are specified, the tag is simply
              created (if it didn'talready exist) and no files are associated with  it.  Multiple
              FILE arguments can be specified.

       -d, --delete=TAG
              Delete  a  tag  with  the  name TAG. If no FILE arguments are specified, the tag is
              deleted for ALL files. If FILE arguments are specified, only those files  have  the
              TAG deleted.

       -e, --description=STRING
              This option ONLY applies when using --add and provides a description to go with the
              tag label according to STRING.

       -V, --version
              Print version.

ENVIRONMENT

       TRACKER_SPARQL_BACKEND
              This option allows you to choose which  backend  you  use  for  connecting  to  the
              database. This choice can limit your functionality. There are three settings.

              With "direct" the connection to the database is made directly to the file itself on
              the disk, there is no intermediary daemon or  process.  The  "direct"  approach  is
              purely read-only.

              With "bus" the tracker-store process is used to liase with the database queuing all
              requests and managing the connections via  an  IPC  /  D-Bus.  This  adds  a  small
              overhead  BUT  this  is  the  only approach you can use if you want to write to the
              database.

              With "auto" the backend is  decided  for  you,  much  like  it  would  be  if  this
              environment variable was undefined.

       TRACKER_PRAGMAS_FILE
              Tracker  has  a  fixed  set  of PRAGMA settings for creating its SQLite connection.
              With this environment variable pointing to a  text  file  you  can  override  these
              settings. The file is a \n separated list of SQLite queries to execute on any newly
              created SQLite connection in tracker-store.

SEE ALSO

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