1TRACKER3-TAG(1)                 Tracker manual                 TRACKER3-TAG(1)
2
3
4

NAME

6       tracker3-tag - Add, remove and list tags.
7

SYNOPSIS

9       tracker3 tag FILE1 [FILE2 ...] [-l <limit>] [-o <offset>] [-r]
10       tracker3 tag -t [[TAG1] [TAG2] ...] [-s] [-r]
11       tracker3 tag -a <TAG> [-e <description>]
12       tracker3 tag -d <TAG>
13

DESCRIPTION

15       List tags for local files or by the tag labels themselves if -t is
16       used.
17
18       It’s also possible to manage tags with the -a and and -d options.
19
20       The FILE argument can be either a local path or a URI. It also does not
21       have to be an absolute path.
22

OPTIONS

24       -t, --list
25           List all tags. Results include the number of files associated with
26           that tag and the tag’s unique identifier. You can show the files
27           associated with each tag by using --show-files.
28
29       The TAG arguments are optional. If no TAG argument is specified, all
30       tags are listed. If one or more TAGs are given, either matching tags
31       are listed (OR condition). For example, this will match any tags named
32       either foo, bar or baz:
33
34           $ tracker3-tag -t foo bar baz
35
36       -s, --show-files
37           Show the files associated with each tag. This option is ONLY
38           available WITH the --list option.
39
40       -a, --add=TAG
41           Add a tag with the name TAG. If no FILE arguments are specified,
42           the tag is simply created (if it didn’talready exist) and no files
43           are associated with it. Multiple FILE arguments can be specified.
44
45       -d, --delete=TAG
46           Delete a tag with the name TAG. If no FILE arguments are specified,
47           the tag is deleted for ALL files. If FILE arguments are specified,
48           only those files have the TAG deleted.
49
50       -e, --description=STRING
51           This option ONLY applies when using --add and provides a
52           description to go with the tag label according to STRING.
53
54       -l, --limit=N
55           Limit search to N results. The default is 512.
56
57       -o, --offset=N
58           Offset the search results by N. For example, start at item number
59           10 in the results. The default is 0.
60
61       -r, --and-operator
62           Use AND operator for search terms instead of OR (the default). For
63           example:
64
65           $ tracker3-tag -s -t sliff sloff
66
67       Should show files in the database that have both the sliff and sloff
68       tags.
69

SEE ALSO

71       tracker3-sparql(1), tracker3-search(1), tracker3-info(1).
72
73
74
75  3.6.2                           10/31/2023                   TRACKER3-TAG(1)
Impressum