firemark 0.1.0

Why watermark your documents?

Every year, millions of people fall victim to identity fraud that starts with a simple document exchange. A common scenario: you're looking for a flat to rent. The landlord — or someone posing as one — asks for a copy of your ID, a pay stub, a tax notice. You send them unmarked. The "landlord" disappears, and your documents are now used to open bank accounts, take out loans, or forge identities in your name.

Watermarking every document you send out is the single most effective defence. A visible overlay that reads "Sent to XYZ agency — March 2026 — flat rental application only" makes the document useless for any other purpose. If it leaks, you know exactly where it came from.

firemark makes this effortless: one command, any image or PDF, 17 visual styles, cryptographic filigrane patterns that resist editing, and batch processing for entire folders.

Install

From crates.io:

cargo install firemark

From source:

git clone https://github.com/Vitruves/firemark.git
cd firemark
cargo install --path .

Produces a single optimized binary (~5 MB).

Quick start

# Watermark a single image
firemark photo_id.png -m "Flat rental — SCI Dupont — March 2026"

# Watermark a PDF
firemark tax_notice.pdf -m "CONFIDENTIAL" -s "Do not distribute"

# Watermark an entire folder recursively
firemark ./documents/ -R -m "Sent to Agency X" -t stamp

# Preview without writing files
firemark id_card.jpg -m "Draft" -n

Output is saved alongside the input as {name}-watermarked.{ext} by default. Use -o to set an explicit output path, or -S for a custom suffix.

Watermark types

firemark doc.pdf -t stamp -m "CONFIDENTIAL" --border --color red

Security filigrane

firemark overlays cryptographic filigrane patterns inspired by banknote security features. These fine geometric patterns are extremely difficult to remove with image editors.

firemark id.png -m "Rental application" --filigrane moire
firemark id.png -m "Rental application" --filigrane none   # disable

Common options

-m, --main-text       Primary watermark text
-s, --secondary-text  Secondary text line
-t, --type            Watermark style (see table above)
-o, --output          Output file path
-S, --suffix          Custom output suffix (default: "watermarked")
-c, --color           Color — name or #RRGGBB (default: #808080)
-O, --opacity         Opacity 0.0–1.0 (default: 0.5)
-r, --rotation        Angle in degrees (default: -45)
-p, --position        center, top-left, top-right, bottom-left, bottom-right, tile
-f, --font            Font name or path to .ttf/.otf
-I, --image           Overlay an image as watermark
    --qr-data         Embed a QR code with custom data
    --border          Draw a border around the watermark
    --shadow          Add a drop shadow
    --filigrane       Security filigrane style (default: guilloche)

PDF options

    --pages           Pages to watermark (e.g. 1,3-5 or "all")
    --skip-pages      Pages to skip
    --behind          Place watermark behind content
    --no-flatten      Keep layers separate (flattened by default)
    --dpi             Render resolution (default: 150)

Batch processing

# Process all images and PDFs in a folder
firemark ./inbox/ -m "INTERNAL" -t tile

# Recursive, 8 threads, custom suffix
firemark ./docs/ -R -j 8 -m "Draft" -S draft

# Dry run — list what would be processed
firemark ./docs/ -R -m "Draft" -n

Already-watermarked files (matching the suffix) are automatically skipped on re-runs.

Configuration file

Save options in a TOML file to avoid repeating flags:

# firemark.toml
main_text = "CONFIDENTIAL"
watermark_type = "stamp"
color = "#CC0000"
opacity = 0.4
filigrane = "guilloche"
border = true

[presets.rental]
main_text = "Flat rental application only"
watermark_type = "diagonal"
color = "#336699"

[presets.internal]
main_text = "INTERNAL — DO NOT DISTRIBUTE"
watermark_type = "tile"

firemark doc.pdf --config firemark.toml
firemark doc.pdf --config firemark.toml --preset rental
firemark doc.pdf --save-preset mypreset    # save current flags
firemark --list-presets                     # list available presets

Format support

Cross-format conversion is supported (e.g. firemark photo.png -o out.pdf).

License

MIT