# MarkLord
MarkLord is a tool to add a visible watermark to images or PDF files
on documents (e.g. ID card, salary slips, etc. ) you need to send to
third parties. If the said third party is victim of a data breach, it
will be more difficult for attackers to use those documents to steal
your identity. Also if you put the name of the third party into the
watermark, you can identify the source of the leak, or the third party
that shared or sold your files without your consent.
## Installation
### From PyPI
```bash
pip install marklord
```
### From GitHub
```bash
git clone https://github.com/secdev/marklord.git
cd marklord
pip install .
```
## Usage
```
usage: marklord [-h] [--output OUTPUT] [--font-name FONT_NAME] [--angle ANGLE] [--watermark_lines WATERMARK_LINES] [--interlining INTERLINING] [--separator SEPARATOR] [--no-noise] [--color COLOR] [--alpha ALPHA] [--quiet] input text [text ...]
positional arguments:
input
text
options:
-h, --help show this help message and exit
--output, -o OUTPUT
--font-name, -f FONT_NAME
--angle, -a ANGLE
--watermark_lines, -l WATERMARK_LINES
--interlining, -I INTERLINING
--separator, -s SEPARATOR
--no-noise
--color, -c COLOR RGBA color as 4 comma separated decimal numbers from 0 to 255
--alpha, -A ALPHA transparency coefficient between 0 and 255
--quiet, -q
```
## Examples
```
$ marklord idcard.jpg "only for ACME company 2025-12-04"
INFO:MarkLord:Opening [/home/specimen/idcard.jpg] (53.2 KB)
INFO:MarkLord:Watermarking [only for ACME company 2025-12-04]
INFO:MarkLord:Result saved to [/home/specimen/idcard-wm.jpg] (60.1 KB)
```
Raw data
{
"_id": null,
"home_page": null,
"name": "marklord",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "watermark, watermarking",
"author": null,
"author_email": "phil@secdev.org",
"download_url": "https://files.pythonhosted.org/packages/3e/60/d28950ced304bf6c747ef53e8969d5b4e2073da783d14b589e087b09a585/marklord-0.1.4.tar.gz",
"platform": null,
"description": "# MarkLord\n\nMarkLord is a tool to add a visible watermark to images or PDF files\non documents (e.g. ID card, salary slips, etc. ) you need to send to\nthird parties. If the said third party is victim of a data breach, it\nwill be more difficult for attackers to use those documents to steal\nyour identity. Also if you put the name of the third party into the\nwatermark, you can identify the source of the leak, or the third party\nthat shared or sold your files without your consent.\n\n## Installation\n\n### From PyPI\n\n```bash\npip install marklord\n```\n\n### From GitHub\n\n```bash\ngit clone https://github.com/secdev/marklord.git\ncd marklord\npip install .\n```\n\n## Usage\n\n```\nusage: marklord [-h] [--output OUTPUT] [--font-name FONT_NAME] [--angle ANGLE] [--watermark_lines WATERMARK_LINES] [--interlining INTERLINING] [--separator SEPARATOR] [--no-noise] [--color COLOR] [--alpha ALPHA] [--quiet] input text [text ...]\n\npositional arguments:\n input\n text\n\noptions:\n -h, --help show this help message and exit\n --output, -o OUTPUT\n --font-name, -f FONT_NAME\n --angle, -a ANGLE\n --watermark_lines, -l WATERMARK_LINES\n --interlining, -I INTERLINING\n --separator, -s SEPARATOR\n --no-noise\n --color, -c COLOR RGBA color as 4 comma separated decimal numbers from 0 to 255\n --alpha, -A ALPHA transparency coefficient between 0 and 255\n --quiet, -q\n```\n\n\n## Examples\n\n```\n$ marklord idcard.jpg \"only for ACME company 2025-12-04\"\nINFO:MarkLord:Opening [/home/specimen/idcard.jpg] (53.2 KB)\nINFO:MarkLord:Watermarking [only for ACME company 2025-12-04]\nINFO:MarkLord:Result saved to [/home/specimen/idcard-wm.jpg] (60.1 KB)\n```\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Watermarking tool for images or PDF",
"version": "0.1.4",
"project_urls": {
"Issues": "https://github.com/secdev/marklord/issues",
"Repository": "https://github.com/secdev/marklord/"
},
"split_keywords": [
"watermark",
" watermarking"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3399e18bbbcd4dc3da3be79a124ed7d57ab5020f6cb0a788582a10b515b50994",
"md5": "8cf7710d275f1904fc88b9b9b0af8156",
"sha256": "363c68b2f1e0942a6cc88c4eb2a1124e459af031f7702b9c63b1eda4dbf57b86"
},
"downloads": -1,
"filename": "marklord-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8cf7710d275f1904fc88b9b9b0af8156",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 11547,
"upload_time": "2025-07-12T09:56:21",
"upload_time_iso_8601": "2025-07-12T09:56:21.596225Z",
"url": "https://files.pythonhosted.org/packages/33/99/e18bbbcd4dc3da3be79a124ed7d57ab5020f6cb0a788582a10b515b50994/marklord-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3e60d28950ced304bf6c747ef53e8969d5b4e2073da783d14b589e087b09a585",
"md5": "0482c74f30f963c3c62b792c67b3561e",
"sha256": "91be2e9e882b4a2a3f342451f955b9df8f68961545b49cc9cf8bf949f5f340ae"
},
"downloads": -1,
"filename": "marklord-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "0482c74f30f963c3c62b792c67b3561e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 11127,
"upload_time": "2025-07-12T09:56:22",
"upload_time_iso_8601": "2025-07-12T09:56:22.745786Z",
"url": "https://files.pythonhosted.org/packages/3e/60/d28950ced304bf6c747ef53e8969d5b4e2073da783d14b589e087b09a585/marklord-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 09:56:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "secdev",
"github_project": "marklord",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "pillow",
"specs": []
},
{
"name": "pdf2image",
"specs": []
},
{
"name": "numpy",
"specs": []
}
],
"lcname": "marklord"
}
JSON
