Добавить текстовый водяной знак
Накладывает подпись или копирайт на фото в выбранном углу с настраиваемой прозрачностью.
Что делает скрипт
Скрипт рисует текст поверх изображения, автоматически подбирает размер шрифта и добавляет легкую тень для читаемости. Можно выбрать угол, цвет, прозрачность и свой TTF-шрифт. Результаты сохраняются отдельно, оригиналы не перезаписываются.
Быстрый старт
python watermark_text.py --dir ./photos --out ./watermarked --text "(c) example.com"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python watermark_text.py --dir ./photos --out ./out --text "(c) example.com" --position bottom-rightpython watermark_text.py --dir ./photos --out ./out --text "demo" --opacity 0.25 --color #fef3c7
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install Pillow
python3 -m pip install Pillow
python3 -m pip install Pillow
watermark_text.py
#!/usr/bin/env python3
"""Наложение текстового водяного знака на изображения."""
from __future__ import annotations
import argparse
import sys
from pathlib import Path
try:
from PIL import Image, ImageDraw, ImageFont, ImageOps
except ImportError:
sys.exit("Нужен Pillow: python3 -m pip install Pillow")
FORMATS = {
".jpg": "JPEG",
".jpeg": "JPEG",
".png": "PNG",
".webp": "WEBP",
".tif": "TIFF",
".tiff": "TIFF",
}
FONT_CANDIDATES = (
"DejaVuSans.ttf",
"Arial.ttf",
"arial.ttf",
"C:/Windows/Fonts/arial.ttf",
"/System/Library/Fonts/Supplemental/Arial.ttf",
)
def parse_color(value: str) -> tuple[int, int, int]:
text = value.strip().lstrip("#")
if len(text) != 6:
raise argparse.ArgumentTypeError("цвет нужен в формате #rrggbb")
try:
return tuple(int(text[index:index + 2], 16) for index in (0, 2, 4))
except ValueError as error:
raise argparse.ArgumentTypeError(f"неверный цвет: {value}") from error
def load_font(size: int, custom: str | None) -> ImageFont.ImageFont:
candidates = (custom,) if custom else FONT_CANDIDATES
for name in candidates:
if not name:
continue
try:
return ImageFont.truetype(name, size)
except OSError:
continue
try:
return ImageFont.load_default(size=size)
except TypeError:
return ImageFont.load_default()
def text_position(position: str, size: tuple[int, int], box: tuple[int, int, int, int], margin: int) -> tuple[int, int]:
width, height = size
left, top, right, bottom = box
text_width = right - left
text_height = bottom - top
if position == "top-left":
return margin - left, margin - top
if position == "top-right":
return width - text_width - margin - left, margin - top
if position == "bottom-left":
return margin - left, height - text_height - margin - top
if position == "center":
return (width - text_width) // 2 - left, (height - text_height) // 2 - top
return width - text_width - margin - left, height - text_height - margin - top
def collect(root: Path, recursive: bool) -> list[Path]:
pattern = "**/*" if recursive else "*"
return sorted(
path for path in root.glob(pattern)
if path.is_file() and path.suffix.lower() in FORMATS
)
def flatten(image: Image.Image) -> Image.Image:
if image.mode in ("RGBA", "LA"):
rgba = image.convert("RGBA")
canvas = Image.new("RGB", rgba.size, (255, 255, 255))
canvas.paste(rgba, mask=rgba.getchannel("A"))
return canvas
if image.mode not in ("RGB", "L"):
return image.convert("RGB")
return image
def main() -> int:
parser = argparse.ArgumentParser(description="Добавить текстовый водяной знак")
parser.add_argument("--dir", type=Path, required=True)
parser.add_argument("--out", type=Path, required=True)
parser.add_argument("--text", required=True)
parser.add_argument(
"--position",
choices=["top-left", "top-right", "bottom-left", "bottom-right", "center"],
default="bottom-right",
)
parser.add_argument("--opacity", type=float, default=0.35)
parser.add_argument("--color", type=parse_color, default=(255, 255, 255))
parser.add_argument("--font-size", type=int, default=0)
parser.add_argument("--font", default=None)
parser.add_argument("--recursive", action="store_true")
parser.add_argument("--overwrite", action="store_true")
args = parser.parse_args()
if not 0 < args.opacity <= 1:
parser.error("--opacity должен быть больше 0 и не больше 1")
root = args.dir.expanduser().resolve()
if not root.is_dir():
parser.error(f"Папка не найдена: {root}")
out_dir = args.out.expanduser().resolve()
out_dir.mkdir(parents=True, exist_ok=True)
files = collect(root, args.recursive)
if not files:
print("Изображения не найдены.")
return 0
done = skipped = failed = 0
for path in files:
target = out_dir / path.name
if target.exists() and not args.overwrite:
skipped += 1
continue
try:
with Image.open(path) as opened:
image = ImageOps.exif_transpose(opened).convert("RGBA")
size = args.font_size or max(18, min(image.size) // 22)
font = load_font(size, args.font)
overlay = Image.new("RGBA", image.size, (0, 0, 0, 0))
draw = ImageDraw.Draw(overlay)
box = draw.textbbox((0, 0), args.text, font=font)
while box[2] - box[0] > image.width * 0.9 and size > 12:
size -= 2
font = load_font(size, args.font)
box = draw.textbbox((0, 0), args.text, font=font)
margin = max(12, min(image.size) // 30)
x, y = text_position(args.position, image.size, box, margin)
alpha = int(255 * args.opacity)
draw.text((x + 2, y + 2), args.text, font=font, fill=(0, 0, 0, min(alpha, 160)))
draw.text((x, y), args.text, font=font, fill=(*args.color, alpha))
result = Image.alpha_composite(image, overlay)
fmt = FORMATS[path.suffix.lower()]
if fmt == "JPEG":
flatten(result).save(
target, format="JPEG", quality=92, optimize=True, progressive=True
)
elif fmt == "PNG":
result.save(target, format="PNG", optimize=True)
elif fmt == "WEBP":
result.save(target, format="WEBP", quality=90, method=6)
else:
if result.mode not in ("RGB", "RGBA"):
result = result.convert("RGB")
result.save(target, format="TIFF", compression="tiff_deflate")
except Exception as error:
print(f"Ошибка {path}: {error}")
failed += 1
continue
done += 1
print(f"Готово: {path.name}")
print(f"Итог: {done} готово, {skipped} пропущено, {failed} ошибок")
return 1 if failed else 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.