macOS

Миниатюры Quick Look

Создаёт PNG-превью файлов через qlmanage и складывает их в указанную папку

Shell macOS Новичок
Скачать quicklook_thumbnails.sh
Описание

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

Quick Look умеет отрисовывать превью для документов, изображений и видео без открытия приложений. Скрипт вызывает qlmanage -t для файлов или папки и сохраняет PNG заданного размера. Оригиналы не изменяются, создаются только новые файлы превью.

Перед запуском
  • Создаёт PNG-файлы в папке вывода.
  • Существующие превью не перезаписываются без флага --force.
Запуск

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

bash quicklook_thumbnails.sh ~/Documents --out ~/Desktop/previews

Скачайте файл, откройте терминал в папке со скриптом и выполните команду.

Примеры

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

  • bash quicklook_thumbnails.sh ~/Documents --out ~/Desktop/previews
  • bash quicklook_thumbnails.sh ~/Pictures/photo.jpg --size 512 --out ./preview
  • bash quicklook_thumbnails.sh ~/Projects --recursive --out /tmp/ql --force
Зависимости

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

Bash 4+ Скрипт совместим с системным /bin/bash 3.2 на macOS
macOS brew install bash
Исходник

quicklook_thumbnails.sh

#!/usr/bin/env bash
set -euo pipefail

out="./quicklook"
size=1024
recursive=0
force=0
inputs=()

while [[ $# -gt 0 ]]; do
    case "$1" in
        --out)
            out="${2:?нужен путь}"
            shift 2
            ;;
        --size)
            size="${2:?нужно число}"
            shift 2
            ;;
        --recursive)
            recursive=1
            shift
            ;;
        --force)
            force=1
            shift
            ;;
        -h|--help)
            echo "Использование: quicklook_thumbnails.sh PATH... [--out DIR] [--size PX] [--recursive] [--force]"
            exit 0
            ;;
        -*)
            echo "Неизвестный аргумент: $1" >&2
            exit 2
            ;;
        *)
            inputs+=("$1")
            shift
            ;;
    esac
done

if [[ ${#inputs[@]} -eq 0 ]]; then
    echo "Укажите хотя бы один файл или папку." >&2
    exit 2
fi

if [[ ! "$size" =~ ^[0-9]+$ ]] || [[ "$size" -lt 64 ]] || [[ "$size" -gt 4096 ]]; then
    echo "Размер должен быть от 64 до 4096 пикселей." >&2
    exit 2
fi

if ! command -v qlmanage >/dev/null 2>&1; then
    echo "qlmanage не найден." >&2
    exit 1
fi

mkdir -p "$out"
out=$(cd "$out" && pwd)
created=0
skipped=0
failed=0

for input in "${inputs[@]}"; do
    if [[ "$input" == "~"* ]]; then
        input="$HOME/${input#\~}"
    fi
    if [[ ! -e "$input" ]]; then
        echo "Пропуск, не найдено: $input" >&2
        failed=$((failed + 1))
        continue
    fi

    if [[ -d "$input" ]]; then
        if [[ "$recursive" -eq 1 ]]; then
            list=$(find "$input" -type f -not -path "$out/*" -print)
        else
            list=$(find "$input" -maxdepth 1 -type f -not -path "$out/*" -print)
        fi
    else
        list="$input"
    fi

    while IFS= read -r file; do
        [[ -z "$file" ]] && continue
        name=$(basename "$file")
        if [[ -e "$out/$name.png" && "$force" -eq 0 ]]; then
            echo "  уже есть: $out/$name.png"
            skipped=$((skipped + 1))
            continue
        fi
        qlmanage -t -s "$size" -o "$out" "$file" >/dev/null 2>&1 || true
        if [[ -f "$out/$name.png" ]]; then
            printf '  %s\n' "$out/$name.png"
            created=$((created + 1))
        else
            echo "  нет превью: $file" >&2
            failed=$((failed + 1))
        fi
    done <<< "$list"
done

echo
echo "Создано превью: $created. Уже было: $skipped. Не удалось: $failed."

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

CLI 1.0.0

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

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

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

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

Категория

macOS

Shell, Python и автоматизация macOS без лишних приложений.