Извлечь палитру изображения
Показывает основные цвета снимка с долями в процентах и умеет сохранить результат в JSON.
Что делает скрипт
Скрипт приводит изображение к небольшой палитре методом медианного разрезания и считает, какую площадь занимает каждый цвет. Полученные HEX-коды удобно использовать для сайта, обложек и оформления. Файлы не изменяются, при необходимости отчет пишется в JSON.
Быстрый старт
python extract_palette.py --dir ./photos --colors 8
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python extract_palette.py --input ./cover.jpg --colors 6python extract_palette.py --dir ./photos --colors 10 --json palette.json --recursive
Что понадобится
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
extract_palette.py
#!/usr/bin/env python3
"""Извлечение доминирующих цветов изображения."""
from __future__ import annotations
import argparse
import json
import sys
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(source: Path, recursive: bool) -> list[Path]:
if source.is_file():
return [source]
pattern = "**/*" if recursive else "*"
return sorted(
path for path in source.glob(pattern)
if path.is_file() and path.suffix.lower() in EXTENSIONS
)
def colors_for(path: Path, count: int) -> list[dict]:
with Image.open(path) as opened:
image = ImageOps.exif_transpose(opened)
if "A" in image.getbands():
rgba = image.convert("RGBA")
background = Image.new("RGB", rgba.size, (255, 255, 255))
background.paste(rgba, mask=rgba.getchannel("A"))
image = background
else:
image = image.convert("RGB")
quantized = image.quantize(colors=count, method=Image.Quantize.MEDIANCUT)
palette = quantized.getpalette()
raw = quantized.getcolors(maxcolors=count) or []
total = sum(item[0] for item in raw) or 1
result = []
for amount, index in sorted(raw, reverse=True):
red, green, blue = palette[index * 3:index * 3 + 3]
result.append(
{
"hex": f"#{red:02x}{green:02x}{blue:02x}",
"percent": round(amount * 100 / total, 2),
}
)
return result
def main() -> int:
parser = argparse.ArgumentParser(description="Извлечь палитру изображения")
parser.add_argument("--input", type=Path)
parser.add_argument("--dir", type=Path)
parser.add_argument("--colors", type=int, default=8)
parser.add_argument("--recursive", action="store_true")
parser.add_argument("--json", type=Path)
args = parser.parse_args()
if bool(args.input) == bool(args.dir):
parser.error("Укажите либо --input, либо --dir")
if not 2 <= args.colors <= 64:
parser.error("--colors должен быть от 2 до 64")
source = (args.input or args.dir).expanduser().resolve()
if not source.exists():
parser.error(f"Источник не найден: {source}")
files = collect(source, args.recursive)
if not files:
print("Изображения не найдены.")
return 0
report = []
for path in files:
try:
colors = colors_for(path, args.colors)
except Exception as error:
print(f"Ошибка {path}: {error}")
continue
report.append({"file": str(path), "colors": colors})
print(f"{path.name}:")
for item in colors:
print(f" {item['hex']} {item['percent']:.2f}%")
if args.json:
report_path = args.json.expanduser().resolve()
report_path.parent.mkdir(parents=True, exist_ok=True)
report_path.write_text(
json.dumps(report, ensure_ascii=False, indent=2) + "\n",
encoding="utf-8",
)
print(f"Отчет сохранен: {args.json}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.