Изображения

Проверить изображения на битые файлы

Открывает каждый файл, проверяет структуру и декодирование, а затем показывает список поврежденных снимков.

Python Windows macOS Linux Средний
Скачать check_corrupt.py
Описание

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

Скрипт выполняет verify и повторное чтение пикселей, поэтому ловит обрезанные и поврежденные JPEG, PNG, WebP и TIFF. Ошибочные файлы не удаляются и не перемещаются, только попадают в отчет. Можно сохранить результат в JSON и включить ненулевой код возврата для автоматизации.

Запуск

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

python check_corrupt.py --dir ./photos --json report.json

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

Примеры

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

  • python check_corrupt.py --dir ./photos
  • python check_corrupt.py --dir ./photos --recursive --fail-on-error
Зависимости

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

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
Исходник

check_corrupt.py

#!/usr/bin/env python3
"""Проверка изображений на повреждения и неполное декодирование."""
from __future__ import annotations

import argparse
import json
import sys
from pathlib import Path

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

EXTENSIONS = {".jpg", ".jpeg", ".png", ".webp", ".bmp", ".gif", ".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 check(path: Path) -> str | None:
    try:
        with Image.open(path) as image:
            image.verify()
        with Image.open(path) as image:
            image.load()
        return None
    except Exception as error:
        return str(error)


def main() -> int:
    parser = argparse.ArgumentParser(description="Проверить изображения на битые файлы")
    parser.add_argument("--dir", type=Path, required=True)
    parser.add_argument("--recursive", action="store_true")
    parser.add_argument("--json", type=Path)
    parser.add_argument("--fail-on-error", action="store_true")
    args = parser.parse_args()

    root = args.dir.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Папка не найдена: {root}")
    files = collect(root, args.recursive)
    if not files:
        print("Изображения не найдены.")
        return 0

    corrupt: list[dict[str, str]] = []
    for path in files:
        error = check(path)
        if error:
            print(f"Поврежден: {path} ({error})")
            corrupt.append({"file": str(path), "error": error})

    valid = len(files) - len(corrupt)
    print(f"Итог: {valid} исправно, {len(corrupt)} повреждено")
    if args.json:
        payload = {"checked": len(files), "valid": valid, "corrupt": corrupt}
        report_path = args.json.expanduser().resolve()
        report_path.parent.mkdir(parents=True, exist_ok=True)
        report_path.write_text(
            json.dumps(payload, ensure_ascii=False, indent=2) + "\n",
            encoding="utf-8",
        )
        print(f"Отчет сохранен: {args.json}")
    if corrupt and args.fail_on_error:
        return 1
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Изображения

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