mat2(1) - f39

1mat2(1)                          User Commands                         mat2(1)
2
3
4

NAME

6       mat2 - the metadata anonymisation toolkit 2
7
8

SYNOPSIS

10       mat2 [-h] [-v] [-l] [-V] [-s | -L] [files [files ...]]
11
12

DESCRIPTION

14       mat2  removes metadata from various fileformats. It supports a wide va‐
15       riety of file formats, audio, office, images, …
16
17       Careful, mat2 does not clean files in-place, instead, it will produce a
18       file  with  the  word "cleaned" between the filename and its extension,
19       for example "filename.cleaned.png" for a file named "filename.png".
20
21

OPTIONS

23   positional arguments:
24       files  the files to process
25
26   optional arguments:
27       -h, --help
28              show this help message and exit
29
30       -v, --version
31              show program's version number and exit
32
33       -l, --list
34              list all supported fileformats
35
36       --check-dependencies
37              check if mat2 has all the dependencies it needs
38
39       -V, --verbose
40              show more verbose status information
41
42       --unknown-members policy
43              how to handle unknown members  of  archive-style  files  (policy
44              should be one of: abort, omit, keep)
45
46       -s, --show
47              list harmful metadata detectable by mat2 without removing them
48
49       -L, --lightweight
50              remove SOME metadata
51
52       --no-sandbox
53              disable bubblewrap's sandboxing
54
55       --inplace
56              clean in place, without backup
57
58

EXAMPLES

60       To remove all the metadata from a PDF file:
61
62              mat2 ./myfile.pdf
63

NOTES ABOUT METADATA

65       While  mat2  is doing its very best to display metadata when the --show
66       flag is passed, it doesn't mean that a file is clean from any  metadata
67       if mat2 doesn't show any. There is no reliable way to detect every sin‐
68       gle possible metadata for complex file formats.
69
70       This is why you shouldn't rely on metadata's presence to decide if your
71       file must be cleaned or not.
72
73       Moreover, mat2 goes to great lengths to make sure that as much metadata
74       as possible are removed. This might sometimes result in a loss of qual‐
75       ity  of  the  processed files. For example, textual based pdf file con‐
76       verted into image based one means that it'll be no longer  possible  to
77       select  text  in  them.  If you're experiencing this, you might want to
78       give the lightweight cleaning mode a try, but keep in mind by doing so,
79       some metadata won't be cleaned.
80
81
82

BUGS

84       While  mat2  does  its  very best to remove every single metadata, it's
85       still in beta, and some might remain. Should you encounter some issues,
86       check the bugtracker: https://0xacab.org/jvoisin/mat2/issues
87
88       Please use accordingly and be careful.
89
90

AUTHOR

92       This  software  was made by Julien (jvoisin) Voisin with the support of
93       the Tails project.
94
95

COPYRIGHT

97       This software is released on LGPLv3.
98
99