wmk
github.com
What it is
wmk is a free, open-source Python command-line tool for applying image or text watermarks to image files. It runs on Linux, macOS, and Windows, with the CLI as its primary interface and an optional Python library available. You can process individual files, recurse through folders, or use glob patterns for batch jobs. Watermarks can be placed in any corner or at the center, with opacity from 0 to 100. Supported input and output formats are JPG, JPEG, PNG, WEBP, TIFF, BMP, and GIF; GIF handling covers only the first frame. A dry-run mode prints intended outputs without writing files. Batch results normally go to a watermarked directory while retaining relative paths, and existing files are protected unless overwrite is selected, using a _watermarked suffix to avoid collisions. The README describes offline processing, keeping images on your machine. Install with pip, pipx, or a repository clone; Python 3.10 or newer is required.
Spec sheet
- Purpose
- wmk is a Python command-line tool for adding image or text watermarks to images.Read 11 Oct 2026 · github.com
- Privacy
- The README describes wmk as an offline tool and says images stay on the user's machine.Read 11 Oct 2026 · github.com
- License
- The repository provides the software under the MIT License, which permits use, copying, modification, distribution, sublicensing, and sale subject to its conditions.Read 11 Oct 2026 · github.com
- Automation
- The CLI is scriptable and the README describes it for repeatable workflows such as product photos and photography delivery.Read 11 Oct 2026 · github.com
- Batch processing
- It can process folders recursively or accept glob patterns for batch watermarking.Read 11 Oct 2026 · github.com
- Dry run
- A dry-run option prints planned outputs without writing files.Read 11 Oct 2026 · github.com
- GIF limitation
- GIF processing handles only the first frame.Read 11 Oct 2026 · github.com
- Image formats
- It supports JPG, JPEG, PNG, WEBP, TIFF, BMP, and GIF input and output.Read 11 Oct 2026 · github.com
- Input formats
- The listed input and output formats are JPG, JPEG, PNG, WEBP, TIFF, BMP, and GIF.Read 11 Oct 2026 · github.com
- Install
- The package can be installed with pip or pipx, or from a repository clone.Read 11 Oct 2026 · github.com
- Installation
- The package can be installed with pip or pipx, or from a cloned source repository.Read 11 Oct 2026 · github.com
- Intended audience
- The package metadata classifies the project for desktop end users and multimedia graphics.Read 11 Oct 2026 · github.com
- Local processing
- The README describes the CLI as offline and says images stay on the user's machine.Read 11 Oct 2026 · github.com
- Output behavior
- By default, batch folder output goes into a watermarked directory and preserves the folder's relative structure.Read 11 Oct 2026 · github.com
- Overwrite behavior
- Without the overwrite option, existing destination files are not replaced and a _watermarked suffix is used to avoid collisions.Read 11 Oct 2026 · github.com
- Placement and opacity
- Watermarks can be positioned at the top-left, top-right, bottom-left, bottom-right, or center, with opacity set from 0 to 100.Read 11 Oct 2026 · github.com
- Python library
- The project also provides an optional Python library interface, while identifying the CLI as its primary interface.Read 11 Oct 2026 · github.com
- Python requirement
- The package metadata requires Python 3.10 or newer.Read 11 Oct 2026 · github.com
- Support channel
- The package metadata links to the repository's GitHub Issues page.Read 11 Oct 2026 · github.com
- Testing and checks
- The README lists a pytest suite and Ruff lint and formatting checks as project trust signals.Read 11 Oct 2026 · github.com
Plans and prices
Strong points and limits
Strong points
- Free MIT-licensed open-source software
- Batch processing supports folders and glob patterns
- Five watermark positions with adjustable opacity
- Offline processing keeps images on the machine
- Dry run previews outputs without writing files
Limits
- GIF processing handles only the first frame
- Requires Python 3.10 or newer
- Command-line interface is the primary workflow
Who it suits
wmk suits people who need scriptable, local watermarking for images, including repeatable product-photo or photography-delivery workflows. It also fits users who want a command-line tool on Linux, macOS, or Windows.
Verdict
wmk provides local, scriptable watermarking with broad image-format support and useful batch safeguards. Its first-frame-only GIF handling and Python requirement are the main constraints to check.
Where Specifiction places it
- Photo Watermarking Software#24 of 337.7