2018-03-19 00:09:00 +01:00
|
|
|
```
|
|
|
|
_____ _____ _____ ___
|
|
|
|
| | _ |_ _|_ | Keep you data,
|
|
|
|
| | | | | | | | _| trash your meta!
|
|
|
|
|_|_|_|__|__| |_| |___|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
2018-03-27 21:15:30 +02:00
|
|
|
[![pipeline status](https://0xacab.org/jvoisin/mat2/badges/master/pipeline.svg)](https://0xacab.org/jvoisin/mat2/commits/master)
|
|
|
|
[![coverage report](https://0xacab.org/jvoisin/mat2/badges/master/coverage.svg)](https://0xacab.org/jvoisin/mat2/commits/master)
|
|
|
|
|
2018-04-23 00:11:34 +02:00
|
|
|
This software is currently in **beta**, please don't use it for anything
|
|
|
|
critical.
|
|
|
|
|
2018-05-14 22:59:42 +02:00
|
|
|
# Metadata and privacy
|
|
|
|
|
|
|
|
Metadata consist of information that characterizes data.
|
|
|
|
Metadata are used to provide documentation for data products.
|
|
|
|
In essence, metadata answer who, what, when, where, why, and how about
|
|
|
|
every facet of the data that are being documented.
|
|
|
|
|
|
|
|
Metadata within a file can tell a lot about you.
|
|
|
|
Cameras record data about when a picture was taken and what
|
|
|
|
camera was used. Office documents like PDF or Office automatically adds
|
|
|
|
author and company information to documents and spreadsheets.
|
|
|
|
Maybe you don't want to disclose those information on the web.
|
|
|
|
|
|
|
|
This is precisely the job of MAT2: getting rid, as much as possible, of
|
|
|
|
metadata.
|
2018-03-27 21:15:30 +02:00
|
|
|
|
2018-04-01 01:06:56 +02:00
|
|
|
# Requirements
|
|
|
|
|
|
|
|
- `python3-mutagen` for audio support
|
|
|
|
- `python3-gi-cairo` and `gir1.2-poppler-0.18` for PDF support
|
|
|
|
- `gir1.2-gdkpixbuf-2.0` for images support
|
|
|
|
- `libimage-exiftool-perl` for everything else
|
|
|
|
|
2018-04-14 21:35:45 +02:00
|
|
|
Please note that MAT2 requires at least Python3.5, meaning that it
|
|
|
|
doesn't run on [Debian Jessie](Stretc://packages.debian.org/jessie/python3),
|
2018-03-19 00:09:00 +01:00
|
|
|
|
2018-04-23 00:11:34 +02:00
|
|
|
# Running the testsuite
|
2018-03-19 00:09:00 +01:00
|
|
|
|
|
|
|
```bash
|
|
|
|
$ python3 -m unittest discover -v
|
|
|
|
```
|
2018-04-03 21:37:46 +02:00
|
|
|
|
2018-05-14 22:59:42 +02:00
|
|
|
# Supported formats
|
|
|
|
|
|
|
|
```bash
|
2018-05-21 22:49:40 +02:00
|
|
|
$ python3 ./mat2 -l
|
2018-05-14 22:59:42 +02:00
|
|
|
```
|
|
|
|
|
2018-04-03 21:37:46 +02:00
|
|
|
# Related softwares
|
|
|
|
|
|
|
|
- The first iteration of [MAT](http://mat.boum.org)
|
|
|
|
- [Exiftool](https://sno.phy.queensu.ca/~phil/exiftool/mat)
|
|
|
|
- [pdf-redact-tools](https://github.com/firstlookmedia/pdf-redact-tools), that
|
2018-04-23 00:11:34 +02:00
|
|
|
tries to deal with *printer dots* too.
|
2018-04-03 21:37:46 +02:00
|
|
|
- [pdfparanoia](https://github.com/kanzure/pdfparanoia), that removes
|
|
|
|
watermarks from PDF.
|
2018-05-14 22:59:42 +02:00
|
|
|
|
|
|
|
# License
|
|
|
|
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
GNU General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
|
|
Copyright 2018 Julien (jvoisin) Voisin <julien.voisin+mat2@dustri.org>
|
|
|
|
|
|
|
|
# Thanks
|
|
|
|
|
|
|
|
MAT2 wouldn't existe without:
|
|
|
|
|
|
|
|
- the Google Summer of Code,
|
|
|
|
- the fine people from the Tails project
|
|
|
|
- friends
|
|
|
|
|
|
|
|
Many thanks to them!
|
|
|
|
|