Datenmaske

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
  1. Quick start
  2. Installation and first launch
  3. Activating your license
  4. The workflow
  5. What Datenmaske detects
  6. Custom rules, dictionaries and search
  7. Case templates
  8. Watched folders
  9. Every setting
  10. Keyboard shortcuts
  11. Data protection and § 203 StGB
  12. Troubleshooting

Quick start

From the first launch to your first redacted file in three steps.

  1. Run the installer and start Datenmaske Secure. On first launch you paste your license key and load the local detection models.
  2. Drag a PDF into the library and choose “Process”. Detection runs on your machine.
  3. 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

Drag an expert report into the library, process it, open the result. Waiting time sped up.

Review and redact

Accept grouped suggestions, keep a date on purpose, mark a missed spot by hand, open the preview.

Export with proof

Export with a second check, before and after comparison, companion documents for the file.

Installation and first launch

Datenmaske Secure needs no server and no cloud account.

RequirementDetails
Operating systemWindows 10 or Windows 11
Disk spaceThe local detection models take about 2.8 GB in total.
InternetOnly for license checks, model downloads and update checks. Document content is never transmitted.
OptionalGhostscript for PDF/A output. Datenmaske does not install it and detects an existing installation automatically.
  1. Open the download link from your confirmation email or visit the download page and run the signed Windows installer.
  2. Start Datenmaske Secure and enter your license key (see next section).
  3. 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).
  4. 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.

  1. At launch you see “Lizenzschlüssel eingeben” (enter license key). Paste the key from the email and choose “Aktivieren”.
  2. Alternatively drop a license file onto the field above, for example from a USB stick or inside an RDP session.
  3. Under “Account” you see status and validity. You can also export the license file there to move it to a machine without internet.
LicenseWhat applies
Trial license7 days, every feature, one workstation. It then ends by itself, nothing is charged. Files you already exported stay redacted.
Pilot program for law firms60 days on up to 3 workstations, after application and approval.
Online-confirmed licenseWithout 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.

Library with an imported expert report in review status

“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.

Expert report with marked findings and type labels

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.

Suggestions panel with grouped names and accept and reject buttons
  • 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.
Preview with black bars over the accepted spots

“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 bar with Verified, Compare and Open result
Before and after comparison with a movable divider
Export optionEffect
StyleBlack, white, blur or pixel. The text is removed from the file in every case; the style only changes the look.
AnonymizeReplaces entries with placeholders such as [NAME_1]. The mapping is saved as a confidential text file next to the PDF.
TR-RESISCANTurns every page into a pure image. The text layer is removed entirely.
WatermarkVertical stamp on every exported page, for example “CONFIDENTIAL”. Text under Settings, General.
PDF/AAdditional archival conversion of the redacted PDF. Only available when Ghostscript is installed locally.
Companion documentsBy 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

Accept the suggestions, choose Anonymize, export: the comparison shows placeholders such as [NAME_1] instead of black boxes.

What Datenmaske detects

Every data type has its own check. The profile decides which types appear as suggestions.

Data typeExamples and checks
NameFirst 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.
AddressStreet and number, postcode and town, also across two lines. A town without a street is deliberately not marked.
Date13.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 phoneAddresses with umlauts, German and international numbers in common notations.
IBANOnly with a valid checksum (mod 97), German and international.
Credit cardVisa, Mastercard, Amex with Luhn check.
Social security, tax and health insurance numbersGerman pension insurance number, 11-digit tax ID, health insurance number, each with check digit.
ID card and passportGerman and common international formats with plausibility check.
Customer and file numbersOnly with a recognisable label such as “Kunden-Nr.” or “Aktenzeichen”.
Licence platesGerman plates, for example in accident files.
ProfileData 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
HIPAAName, email, phone, address, date, social security number, insurance number, credit card, URL
FOIA / IFGName, email, phone, address, date, social security number, IBAN, ID document
CustomYour own selection from all data types
SettingMeaning
AI model modeAuto (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 confidenceHow 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.

  1. Open Settings, Detection and go to “Custom regex patterns”.
  2. 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”).
  3. Test the pattern on your own text in the test field, give it a name and a type, and choose “Add”.
  4. In the document choose “Re-detect”. New documents use the rule automatically.

Custom patterns with the assistant

One example becomes a rule that finds the internal reference on both pages.
  • 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

Redact the clinic's name twice by hand and accept the suggested rule: it then appears in Settings.

Mark once, redact everywhere

An area marked by hand can be searched across the whole document. Search marks document-wide as well.

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.

  1. Open Settings, Folders and choose “Add folder”.
  2. 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.
  3. 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

A new file in the inbox folder shows up in the library, processed and ready for review.

Every setting

Six tabs. Changes apply from the next processing run; “Save” keeps them.

TabSettingEffect
DetectionRedaction profileGDPR, BDSG, HIPAA, FOIA/IFG or Custom (see above).
DetectionLocal PII modelsAdditional name and address detection by the local language models.
DetectionAI model mode, minimum confidenceSee the detection section.
DetectionLearn from manual redactionsRule suggestion after the same value was redacted twice by hand.
DetectionCustom regex patterns, dictionary, case templatesSee the sections above.
OCREngineAuto (default) chooses between Paddle (faster, robust with rotated pages) and ocrs (stronger on upright German scans).
OCRResolution300 DPI suits most scans. Higher is slower and rarely better.
AppearanceTheme and languageLight, dark or follow Windows. Interface in German, English or French.
AppearanceFolder panelShow the folder sidebar in the library by default.
GeneralExport modeRedact (black areas) or anonymize (placeholders) as the default.
GeneralRetentionLibrary entries and saved reviews older than N days are deleted. 0 means never.
GeneralWatermarkVertical stamp on every exported page.
FoldersWatched folders, window close behaviourSee watched folders.
SystemLocal APIREST 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.
SystemWindows Explorer integrationAdds the right-click entry “Schwärzen mit Datenmaske” for PDFs and supported documents.
SystemTOM documentationCreates a PDF with the technical and organisational measures (Art. 32 GDPR), including your retention period.
SystemUpdatesCheck automatically at launch or manually with “Check for updates”. Updates are signed.
SystemLocal engineModel packages for digital PDFs and for scans: check status, update one or all.
SystemPDF/A, GhostscriptShows whether Ghostscript was found. Only then is PDF/A output available at export. Datenmaske does not install Ghostscript.
SystemExperimental modeUnlocks flagged early features. Off by default.
SystemFull resetDeletes 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 “?”.

KeyAction
A / RAccept / reject the selection
Shift + A / Shift + RAccept all / reject all
NNext page to review
Shift + NNext page with open suggestions
← / →Previous / next page
DDraw mode (manual redaction)
DelDelete the selected manual box
VToggle preview
BShow or hide suggestions
FSearch field
+ / − / 0Zoom in / out / reset
9Fit the whole page
Ctrl + mouse wheelZoom
Ctrl + Z / Ctrl + Shift + ZUndo / redo
Ctrl + EStart export
EscLeave draw mode
?Keyboard shortcut help

Data protection and § 203 StGB

What the software transmits and what never leaves the machine.

Content
TransmittedEmail 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 transmittedPDF content, detected data, redactions, settings, the activity log and your custom patterns.
Where data is storedLocally 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).