ausweiskopie 0.1.4
Create privacy friendly and legal copies of your Ausweisdokument.
Requires Python: >=3.7
Keywords: Ausweiskopie, Personalausweis, PAuswG, Datensparsamkeit

# My identity card copy

> Easily watermark and hide information in copies of your (german) identity card!<br>
> 🇩🇪 [German language information is below.](#meine-ausweiskopie)

| Before                                                                                                                                                                                                               | After                                                                                                                                                                                                                      |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ![Screenshot of a computer program. There is a copy of a passport, which all fields marked. It is possible to toggle each fields](https://raw.githubusercontent.com/Varbin/ausweiskopie/trunk/doc/img_en_before.png) | ![Like the previous screenshot, but the selected fields are blacked out, the password is in greyscale and there is a watermark over it.](https://raw.githubusercontent.com/Varbin/ausweiskopie/trunk/doc/img_en_after.png) |

This tool allows watermarking copies of german identity documents.
You can also blacken information your recipient does not need (like the document number or CAN).

Currently, this tool supports the following identity documents:
- German identity cards (Personalausweis):
  - Current version with EU and biometric icon (issued since the 2nd August 2021)
  - Previous version with a dedicated field for the name at birth (issued from 19th December 2019 to 1st August 2021)
  - Previous version without a dedicated field for the name at birth (issued until 19th December 2019)
- Temporary German identity cards (Vorläufiger Personalausweis) issued on paper
- Regular biometric German passports 

## Installation

Select the most suitable installation option for you below.

### Flatpak for Linux

On Linux, you can install this application independent of your distribution with flatpak.
Follow the [initial setup guide](https://flathub.org/setup) if you haven't installed flatpak yet.

You can install it via the command line:
```flatpak install in.varb.Ausweiskopie```

Afterwards, you can run it with:
```flatpak run in.varb.Ausweiskopie```

Alternatively, visit the store page for further details:

[![Get it on Flathub](https://flathub.org/api/badge?locale=en)](https://flathub.org/apps/in.varb.Ausweiskopie)

### Binaries on GitHub Releases for Windows

You can download the latest Windows binaries from [the releases page](https://github.com/Varbin/Ausweiskopie/releases/latest/).
The binaries work without installation.

### From PyPI

[![PyPI](https://img.shields.io/badge/ausweiskopie-blue?style=for-the-badge&logo=pypi&label=PyPI&labelColor=white)](https://pypi.org/project/ausweiskopie)

Install with pip:

```pip install ausweiskopie```

You can now run it with `python -m ausweiskopie`.
Your Python installation must have the `tkinter`. 

Optional features:
 - **Modern theme**: This application will make use of _ttkbootstrap_ if available. Just run `pip install ausweiskopie[modern]`
 - **XDG Desktop Portals** (native file open/save-as dialogs on Linux): If your desktop manager provides XDG portals, just install `pip install ausweiskopie[portals]`.
 - **Drag-and-Drop**: If your Tk/Tcl environment has the `tkdnd` extension, Drag-and-drop support is automatically enabled.

# Meine Ausweiskopie

> Ausweiskopien schwärzen und einfach kenntlich machen.


| Vorher                                                                                                                                                                                               | Nacher                                                                                                                                                                                                             |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ![Screenshot eines Computerprogramms. Es ist eine Reisepasskarte abgebildet, und darunter alle möglichen Felder.](https://raw.githubusercontent.com/Varbin/ausweiskopie/trunk/doc/img_de_before.png) | ![Gleiches Programm, die Felder im Pass sind nun geschwärzt, außerdem ist er schwarz-weiß und mit einem Wasserzeichen versehen.](https://raw.githubusercontent.com/Varbin/ausweiskopie/trunk/doc/img_de_after.png) |

Nach [§&nbsp;20 PAuswG](https://www.gesetze-im-internet.de/pauswg/__20.html) gilt:

> (2) Der Ausweis darf nur vom Ausweisinhaber oder von anderen Personen mit Zustimmung des Ausweisinhabers in der Weise abgelichtet werden, dass die Ablichtung **eindeutig** und **dauerhaft als Kopie erkennbar** ist. Andere Personen als der Ausweisinhaber dürfen die Kopie nicht an Dritte weitergeben.

Dieses Werkzeug ermöglicht es eine Ausweiskopie als Kopie und eindeutigem Wasserzeichen zu kennzeichnen.
Für den Adressaten unwichtige Daten (z.&nbsp;B. die CAN oder die Ausweisnummer) können geschwärzt werden.

Folgende Ausweistypen werden unterstützt:
 - Vorläufiger Personalausweis
 - Neuer Personalausweis:
   - Aktuelle Fassung ab 2. August 2021 (mit EU-Logo und Biometriesymbol auf der Vorderseite)
   - Neuer Personalausweis mit gekennzeichnetem Geburtsnamen (ausgestellt vom 19. Dezember 2019 bis 1. August 2021)
   - Neuer Personalausweis (ursprüngliche Fassung)
 - Deutscher Reisepass (in Fassung ab 2017)

## Installation

### Flatpak für Linux

Unter Linux kann die Anwendung unabhängig von der Linuxdistribution mittels Flatpak installiert werden.
Sollte Flatpak noch nicht installiert sein, folge der [Einrichtungsanleitung](https://flathub.org/de/setup).

Danach kann "Meine Ausweiskopie" mittels Kommandozeile installiert werden:
```flatpak install in.varb.Ausweiskopie```

Nach der Installation kann sie wie folgt ausgeführt werden:
```flatpak run in.varb.Ausweiskopie```

Für weitere Details besuche die Marktplatzseite:

[![Jetzt auf Flathub](https://flathub.org/api/badge?locale=de)](https://flathub.org/apps/in.varb.Ausweiskopie)

### Windows-Dateien unter den GitHub Releases

Die neusten Pakete findest du unter [Releases](https://github.com/Varbin/Ausweiskopie/releases/latest/).
Du kannst die Anwendung direkt ohne Installation ausführen.

### Von PyPI

[![PyPI](https://img.shields.io/badge/ausweiskopie-blue?style=for-the-badge&logo=pypi&label=PyPI&labelColor=white)](https://pypi.org/project/ausweiskopie)

Du kannst die Anwendung auch mittels _pip_ installieren:
```
pip install ausweiskopie
```

Deine Python-Installation muss `tkinter` installiert haben.

Optionale-Features:
 - **Modernes Look-and-Feel**: Mittels *ttkbootstrap* kann der Anwendung ein modernes Aussehen übergestülpt werden, zur Installation `pip install ausweiskopie[modern]` ausführen.
 - **XDK Desktop Portals** (Natives Datei-Öffenen-/Speichern-Unter unter Linux): Die meisten Desktop-Umgebungen stellen diese mittlerweile bereit. Zur Installation `pip install ausweiskopie[portals]` durchführen.
 - **Drag-and-Drop**: Wenn `tkdnd` in deiner Tk/Tcl-Installation vorhanden ist, funktioniert Drag-und-Drop von Bildern.