NAME

       tracker-tag - Add, remove and list tags.

SYNOPSIS

       tracker tag FILE1 [FILE2 ...] [-l <limit>] [-o <offset>] [-r]
       tracker tag -t [[TAG1] [TAG2] ...] [-s] [-r]
       tracker tag -a <TAG> [-e <description>]
       tracker tag -d <TAG>

DESCRIPTION

       List tags for local files or by the tag labels themselves if -t is used.

       It's also possible to manage tags with the -a and and -d options.

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

OPTIONS

       -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, either matching tags are listed (OR condition). 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.

       -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, --and-operator
              Use AND operator for search terms instead of OR (the default). For example:

              $ tracker-tag -s -t sliff sloff

              Should show files in the database that have both the sliff and sloff tags.

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.

SEE ALSO

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