Проверить изображения на битые файлы
Открывает каждый файл, проверяет структуру и декодирование, а затем показывает список поврежденных снимков.
Что делает скрипт
Скрипт выполняет 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 ./photospython check_corrupt.py --dir ./photos --recursive --fail-on-error
Что понадобится
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
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.