Изображения

Подготовить email-версии фотографий

Подбирает качество и размер JPEG, чтобы каждый файл уложился в заданный лимит килобайт.

Python Windows macOS Linux Продвинутый
Скачать email_versions.py
Описание

Что делает скрипт

Скрипт уменьшает снимок до разумной ширины, затем пробует разное качество JPEG и при необходимости дополнительно снижает разрешение. Прозрачность заменяется белым фоном, метаданные не переносятся. Результаты пишутся отдельно, оригиналы не меняются.

Запуск

Быстрый старт

python email_versions.py --dir ./photos --out ./email --max-size-kb 500

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python email_versions.py --dir ./photos --out ./email --max-size-kb 300
  • python email_versions.py --dir ./photos --out ./email --max-size-kb 900 --max-width 2000 --recursive
Зависимости

Что понадобится

Python 3.10+ Интерпретатор Python
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Pillow Открытие, обработка и сохранение изображений
Windows py -m pip install Pillow
macOS python3 -m pip install Pillow
Linux python3 -m pip install Pillow
Исходник

email_versions.py

#!/usr/bin/env python3
"""Подготовка JPEG-версий для отправки по электронной почте."""
from __future__ import annotations

import argparse
import sys
from io import BytesIO
from pathlib import Path

try:
    from PIL import Image, ImageOps
except ImportError:
    sys.exit("Нужен Pillow: python3 -m pip install Pillow")

EXTENSIONS = {".jpg", ".jpeg", ".png", ".webp", ".bmp", ".tif", ".tiff"}


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 EXTENSIONS
    )


def flatten(image: Image.Image) -> Image.Image:
    if image.mode in ("RGBA", "LA") or (image.mode == "P" and "transparency" in image.info):
        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 != "RGB":
        return image.convert("RGB")
    return image


def resize_to_width(image: Image.Image, width: int) -> Image.Image:
    if image.width <= width:
        return image
    height = max(1, round(image.height * width / image.width))
    return image.resize((width, height), Image.Resampling.LANCZOS)


def encode(image: Image.Image, quality: int) -> bytes:
    buffer = BytesIO()
    image.save(buffer, format="JPEG", quality=quality, optimize=True, progressive=True)
    return buffer.getvalue()


def main() -> int:
    parser = argparse.ArgumentParser(description="Подготовить email-версии фотографий")
    parser.add_argument("--dir", type=Path, required=True)
    parser.add_argument("--out", type=Path, required=True)
    parser.add_argument("--max-size-kb", type=int, default=500)
    parser.add_argument("--max-width", type=int, default=1600)
    parser.add_argument("--recursive", action="store_true")
    parser.add_argument("--overwrite", action="store_true")
    args = parser.parse_args()

    if args.max_size_kb < 10:
        parser.error("--max-size-kb должен быть не меньше 10")
    if args.max_width < 100:
        parser.error("--max-width должен быть не меньше 100")
    target_bytes = args.max_size_kb * 1024
    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 / f"{path.stem}_email.jpg"
        if target.exists() and not args.overwrite:
            skipped += 1
            continue
        try:
            with Image.open(path) as opened:
                original = flatten(ImageOps.exif_transpose(opened))
            best = b""
            best_size = (0, 0)
            for scale in (1.0, 0.85, 0.72, 0.6, 0.5):
                candidate = resize_to_width(original, max(100, round(args.max_width * scale)))
                for quality in range(85, 39, -5):
                    data = encode(candidate, quality)
                    if len(data) <= target_bytes:
                        best = data
                        best_size = candidate.size
                        break
                if best:
                    break
            if not best:
                fallback = resize_to_width(original, max(100, round(args.max_width * 0.5)))
                best = encode(fallback, 40)
                best_size = fallback.size
            target.write_bytes(best)
            size_kb = len(best) / 1024
            note = "" if len(best) <= target_bytes else " (лимит не достигнут)"
            print(f"Готово: {path.name} -> {target.name}, {best_size[0]}x{best_size[1]}, {size_kb:.1f} КБ{note}")
        except Exception as error:
            print(f"Ошибка {path}: {error}")
            failed += 1
            continue
        done += 1
    print(f"Итог: {done} готово, {skipped} пропущено, {failed} ошибок")
    return 1 if failed else 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get images-email-versions
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Изображения

Конвертация, сжатие, водяные знаки, каталоги и пакетная обработка фото.