Skip to main content

tracking Dots Extraction, Decoding and Anonymisation toolkit

Project description

DEDA - tracking Dots Extraction, Decoding and Anonymisation toolkit

Document Colour Tracking Dots or simply yellow dots are small systematic dots in yellow color which encode information about the printer and/or the printout itself. This process is integrated in almost every commercial colour laser printer. This means that almost every printout contains coded information about the source device, such as the serial number.

On the one hand, this tool gives the possibility to read out and decode these forensic features and on the other hand, it allows anonymisation to prevent arbitrary tracking.

If you use this software, please cite the paper: Timo Richter, Stephan Escher, Dagmar Schönfeld, and Thorsten Strufe. 2018. Forensic Analysis and Anonymisation of Printed Documents. In Proceedings of the 6th ACM Workshop on Information Hiding and Multimedia Security (IH&MMSec '18). ACM, New York, NY, USA, 127-138. DOI: https://doi.org/10.1145/3206004.3206019

0. Install

$ pip install .

1. Reading tracking data

Tracking data can be read and sometimes be decoded from a scanned image.
$ deda_parse_print INPUTFILE

2. Find a divergent printer in a set of scanned documents

$ deda_compare_prints INPUT1 INPUT2 [INPUT3] ...

3. Analysing an unknown tracking pattern

New patterns might not be recognised by parse_print. The dots can be extracted for further analysis.
$ libdeda/extract_yd.py INPUTFILE

4. Anonymise a scanned image

This (mostly) removes tracking data from a scan:
$ deda_clean_document INPUTFILE OUTPUTFILE

5. Anonymise a document for printing

  • Save your document as a PS file and call it DOCUMENT.PS. PDFs can be converted using pdf2ps:
    $ pdf2ps INPUT.PDF OUTPUT.PS

  • Print the testpage.ps file created by
    $ deda_anonmask_create -w
    without any page margin.

  • Scan the document and pass the file to
    $ deda_anonmask_create -r INPUTFILE
    This creates 'mask.json', the individual printer's anonymisation mask.

  • Now apply the anonymisation mask:
    $ deda_anonmask_apply mask.json DOCUMENT.PS
    This creates 'masked.ps', the anonymised document. It may be printed with a zero page margin setting.

Check whether a masked page covers your printer's tracking dots by using a microscope. The mask's dot radius, x and y offsets can be customised and passed to deda_anonmask_apply as parameters.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deda-1.0b1.tar.gz (43.0 kB view hashes)

Uploaded Source

Built Distributions

deda-1.0b1-py3.6.egg (81.6 kB view hashes)

Uploaded Source

deda-1.0b1-py3-none-any.whl (35.5 kB view hashes)

Uploaded Python 3

deda-1.0b1-py2.7.egg (59.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page