Datenmaske Secure manual
Everything you need to work with Datenmaske Secure: from installation through reviewing individual findings to the verified export. The software runs entirely on your Windows machine. The films in this manual were recorded in the real app with fictional sample data.
- Windows 10 and 11
- Processing fully local
- Covers version 0.8.17
Contents
Quick start
From the first launch to your first redacted file in three steps.
- Run the installer and start Datenmaske Secure. On first launch you paste your license key and load the local detection models.
- Drag a PDF into the library and choose “Process”. Detection runs on your machine.
- Review the suggestions, mark anything that was missed and export. Datenmaske reopens the result and only releases the file once the check passes.
Scan locally
Review and redact
Export with proof
Installation and first launch
Datenmaske Secure needs no server and no cloud account.
| Requirement | Details |
|---|---|
| Operating system | Windows 10 or Windows 11 |
| Disk space | The local detection models take about 2.8 GB in total. |
| Internet | Only for license checks, model downloads and update checks. Document content is never transmitted. |
| Optional | Ghostscript for PDF/A output. Datenmaske does not install it and detects an existing installation automatically. |
- Open the download link from your confirmation email or visit the download page and run the signed Windows installer.
- Start Datenmaske Secure and enter your license key (see next section).
- The setup assistant offers the local detection models. Every model file is checked against a signed list before use. Without models Datenmaske works with the fixed rules only (checksums and formats).
- After that the software also works without an internet connection.
Activating your license
The license key is verified locally. Machines without a network use the license file.
- At launch you see “Lizenzschlüssel eingeben” (enter license key). Paste the key from the email and choose “Aktivieren”.
- Alternatively drop a license file onto the field above, for example from a USB stick or inside an RDP session.
- Under “Account” you see status and validity. You can also export the license file there to move it to a machine without internet.
| License | What applies |
|---|---|
| Trial license | 7 days, every feature, one workstation. It then ends by itself, nothing is charged. Files you already exported stay redacted. |
| Pilot program for law firms | 60 days on up to 3 workstations, after application and approval. |
| Online-confirmed license | Without a connection you work for 14 days without limits. After that only export is locked until the license is confirmed online again. Reviewing and marking keep working. |
The workflow
Open, detect, review, export. Every step stays under your control.
Open documents by dragging them into the library, with “Open document”, by right-clicking in Windows Explorer (when the Explorer integration is on) or automatically from a watched folder. Accepted formats: PDF, Word (DOCX), Excel (XLSX), TIFF scans, photos and screenshots (JPG, PNG) and emails in MSG and EML format.
“Process” starts text extraction and detection. Fixed rules with checksums and formats come first, then local language models for names and addresses in running text. Scanned pages are read by local OCR. A small window at the bottom right shows progress.
The review screen shows the “Suggestions” panel on the right. Identical entries, such as a name in the letterhead of every page, appear as one group with an occurrence count. One decision applies to every occurrence. Type filters (name, date, phone, address, email and more) let you review category by category.
- Accept or reject per occurrence, per group, or with “Accept all” and “Reject all”.
- “Review next” jumps to the next page with open suggestions.
- “Manual” (key D) draws an area that is redacted like a finding. If there is text underneath, Datenmaske asks whether to redact every occurrence in the document.
- “Search & mark” finds a term on the page or across the document and creates suggestions you confirm in the panel.
- “Preview” (key V) shows the page as the recipient will see it.
“Export” (Ctrl+E) asks for a location and removes the confirmed content from the PDF. Datenmaske then reopens the new file and searches it for leftovers. If the check passes you see “Verified” with “Compare”, “Open result” and “Reveal in folder”. If it finds a leftover, the output file is deleted and no export is offered.
| Export option | Effect |
|---|---|
| Style | Black, white, blur or pixel. The text is removed from the file in every case; the style only changes the look. |
| Anonymize | Replaces entries with placeholders such as [NAME_1]. The mapping is saved as a confidential text file next to the PDF. |
| TR-RESISCAN | Turns every page into a pure image. The text layer is removed entirely. |
| Watermark | Vertical stamp on every exported page, for example “CONFIDENTIAL”. Text under Settings, General. |
| PDF/A | Additional archival conversion of the redacted PDF. Only available when Ghostscript is installed locally. |
| Companion documents | By default a redaction log (types, pages, detection confidence, checksums, no original text), a certificate of local processing and an entry for your record of processing activities (Art. 30 GDPR) are written next to the PDF. |
Anonymize instead of blacking out
What Datenmaske detects
Every data type has its own check. The profile decides which types appear as suggestions.
| Data type | Examples and checks |
|---|---|
| Name | First and last name, also with title (“Dr. med. Anna Mustermann”) and initials. Detected in running text by the local language models, backed by a list of common German names. |
| Address | Street and number, postcode and town, also across two lines. A town without a street is deliberately not marked. |
| Date | 13.08.1985, 13/08/1985, 1985-08-13, 13 August 1985, with calendar validation. Without a birthday context it is suggested with lower confidence. |
| Email and phone | Addresses with umlauts, German and international numbers in common notations. |
| IBAN | Only with a valid checksum (mod 97), German and international. |
| Credit card | Visa, Mastercard, Amex with Luhn check. |
| Social security, tax and health insurance numbers | German pension insurance number, 11-digit tax ID, health insurance number, each with check digit. |
| ID card and passport | German and common international formats with plausibility check. |
| Customer and file numbers | Only with a recognisable label such as “Kunden-Nr.” or “Aktenzeichen”. |
| Licence plates | German plates, for example in accident files. |
| Profile | Data types suggested |
|---|---|
| GDPR (default) | Name, email, phone, address, date, IBAN, social security number, health insurance number, ID document, URL, tax ID, customer/file numbers, credit card, licence plates |
| BDSG (Germany) | as GDPR, without URL |
| HIPAA | Name, email, phone, address, date, social security number, insurance number, credit card, URL |
| FOIA / IFG | Name, email, phone, address, date, social security number, IBAN, ID document |
| Custom | Your own selection from all data types |
| Setting | Meaning |
|---|---|
| AI model mode | Auto (recommended) uses the locally benchmarked model with fallback stages. Full: the same model without fallbacks. Lite: smaller model for machines with little memory, finds clearly less. PII: specialised model for diagnosis and compatibility. |
| Minimum confidence | How certain a finding must be to appear as a suggestion. Higher means fewer but more precise suggestions. Default: 50 %. |
Custom rules, dictionaries and search
Teach Datenmaske your internal references, party names or staff lists once.
- Open Settings, Detection and go to “Custom regex patterns”.
- Type an example into the assistant, such as an internal reference, and choose “Suggest pattern”. Datenmaske explains the pattern in words (for example “2 capital letters, hyphen, 4 digits”).
- Test the pattern on your own text in the test field, give it a name and a type, and choose “Add”.
- In the document choose “Re-detect”. New documents use the rule automatically.
Custom patterns with the assistant
- Import a dictionary: names, parties, staff or customers as CSV/TXT or pasted, one entry per line, up to 2,000 entries. Everything stays local.
- Patterns are linear regular expressions (safe against runaway matching). Lookahead is not supported.
- Learn from manual redactions: redact the same value twice by hand and Datenmaske offers to turn it into a rule.
Manual marks become a rule
Mark once, redact everywhere
Case templates
Save settings per case type and apply them in one click.
Under Settings, Detection you save the current detection and export settings as a named template, for example “Medical malpractice” or “Insolvency”. When you work on a file you apply the matching template instead of setting profiles and options again.
Watched folders
For busy mailrooms: new files in a folder are processed on their own.
- Open Settings, Folders and choose “Add folder”.
- Choose the mode: “Review” places every new document, processed, in the library. “Automatic” exports without review to an output folder and requires an explicit confirmation.
- Under “Window close behaviour” decide whether Datenmaske keeps running in the system tray after closing. “Smart” stays active while a watched folder is set up.
Watch a folder
Every setting
Six tabs. Changes apply from the next processing run; “Save” keeps them.
| Tab | Setting | Effect |
|---|---|---|
| Detection | Redaction profile | GDPR, BDSG, HIPAA, FOIA/IFG or Custom (see above). |
| Detection | Local PII models | Additional name and address detection by the local language models. |
| Detection | AI model mode, minimum confidence | See the detection section. |
| Detection | Learn from manual redactions | Rule suggestion after the same value was redacted twice by hand. |
| Detection | Custom regex patterns, dictionary, case templates | See the sections above. |
| OCR | Engine | Auto (default) chooses between Paddle (faster, robust with rotated pages) and ocrs (stronger on upright German scans). |
| OCR | Resolution | 300 DPI suits most scans. Higher is slower and rarely better. |
| Appearance | Theme and language | Light, dark or follow Windows. Interface in German, English or French. |
| Appearance | Folder panel | Show the folder sidebar in the library by default. |
| General | Export mode | Redact (black areas) or anonymize (placeholders) as the default. |
| General | Retention | Library entries and saved reviews older than N days are deleted. 0 means never. |
| General | Watermark | Vertical stamp on every exported page. |
| Folders | Watched folders, window close behaviour | See watched folders. |
| System | Local API | REST interface on 127.0.0.1 only, for partner integrations (POST /api/v1/detect and /api/v1/redact with a bearer token). It does not start without an API key. |
| System | Windows Explorer integration | Adds the right-click entry “Schwärzen mit Datenmaske” for PDFs and supported documents. |
| System | TOM documentation | Creates a PDF with the technical and organisational measures (Art. 32 GDPR), including your retention period. |
| System | Updates | Check automatically at launch or manually with “Check for updates”. Updates are signed. |
| System | Local engine | Model packages for digital PDFs and for scans: check status, update one or all. |
| System | PDF/A, Ghostscript | Shows whether Ghostscript was found. Only then is PDF/A output available at export. Datenmaske does not install Ghostscript. |
| System | Experimental mode | Unlocks flagged early features. Off by default. |
| System | Full reset | Deletes all local data including sign-in and license, and the models if you choose. |
Keyboard shortcuts
Open the full list in the app at any time with “?”.
| Key | Action |
|---|---|
| A / R | Accept / reject the selection |
| Shift + A / Shift + R | Accept all / reject all |
| N | Next page to review |
| Shift + N | Next page with open suggestions |
| ← / → | Previous / next page |
| D | Draw mode (manual redaction) |
| Del | Delete the selected manual box |
| V | Toggle preview |
| B | Show or hide suggestions |
| F | Search field |
| + / − / 0 | Zoom in / out / reset |
| 9 | Fit the whole page |
| Ctrl + mouse wheel | Zoom |
| Ctrl + Z / Ctrl + Shift + Z | Undo / redo |
| Ctrl + E | Start export |
| Esc | Leave draw mode |
| ? | Keyboard shortcut help |
Data protection and § 203 StGB
What the software transmits and what never leaves the machine.
| Content | |
|---|---|
| Transmitted | Email address and plan for the license check. A SHA-256 hash of the license key and a random device ID (no hardware fingerprint), at most once a day. Trial status. For update checks and model downloads only software metadata. |
| Never transmitted | PDF content, detected data, redactions, settings, the activity log and your custom patterns. |
| Where data is stored | Locally under %APPDATA%\de.datenmaske.desktop. |
The “Compliance” area of the app shows every outgoing connection of the software, the activity log with a SHA-256 chain (any change would be visible) and a local checker for Datenmaske certificates.
Troubleshooting
The most common questions from daily use.
The export shows “Unsichere Ausgabedatei entfernt” (unsafe output removed).
The second check still found a possible leftover in the new file, so Datenmaske deleted it. Check the page it names and redact the spot. A suggestion you deliberately rejected is allowed: it no longer blocks the export and is reported afterwards as deliberately left visible.
My custom rule finds nothing.
Test the pattern in the test field on a line from the document, check that the rule is enabled, then choose “Re-detect”.
Scanned pages show no suggestions.
Under Settings, System, Local engine the package “Scans & image PDFs” should be ready. Under OCR you can switch the engine. 300 DPI is usually enough.
Export is locked but reviewing still works.
The license has expired or could not be confirmed online for more than 14 days. Connect the machine to the internet briefly or enter a new key.
Datenmaske keeps running after I close it.
With a watched folder the app stays in the system tray. Set the window close behaviour to “Exit” under Settings, Folders.
How do I get PDF/A?
Install Ghostscript (free, ghostscript.com). Datenmaske detects it under Settings, System and additionally converts the redacted PDF to PDF/A at export. If the conversion fails, the redacted PDF is kept and you see a notice.
How do I remove all data from the machine?
Settings, System, “Full reset” deletes documents, suggestions, log, settings and license. Then uninstall the app through Windows settings.
Still have questions?
Write to us through the contact form. Please do not attach real client documents; a description or a screenshot with sample data is enough.
Systemhaus oder Kanzlei-IT? Automatisierung & Integration (lokale API, Hotfolder, GPO).