thumbgener 0.1.6

Simple Python tool and library for generating stylish blog post thumbnails and covers

Thumbgener

thumbgener — это простой и удобный инструмент на Python для автоматической генерации стильных обложек (thumbnail) для статей, видео или постов в соцсетях.

Библиотека позволяет генерировать изображения как через командную строку (CLI), так и программно, интегрируя её в ваши скрипты.

Особенности

• Генерация "Blobs": Создание абстрактных фонов с мягкими цветными каплями и размытием.
• Умный перенос текста: Автоматическое разбиение длинных заголовков на строки.
• Встроенные шрифты: Включает семейство шрифтов Ubuntu для корректного отображения текста "из коробки".
• Гибкая настройка: Управление размерами, отступами, шрифтами и цветами.

Установка

pip install thumbgener

Использование

Как CLI инструмент

После установки вам будет доступна команда thumbgener-cli.

Пример создания обложки с "каплями":

thumbgener-cli "Lorem Ipsum is simply dummy text of the printing and typesetting industry" cover.webp

Доступные параметры:

• title: Текст заголовка (обязательно).
• filename: Имя выходного файла (обязательно).
• --width: Ширина изображения (default: 800).
• --height: Высота изображения (default: 400).
• --padding: Отступы от края обложки (default: 50).
• --font-size Размер шрифта (default: 50).
• --line-padding Межстрочный отступ (default: 10).

Как библиотека в коде

Вы можете использовать в своих Python-скриптах:

from thumbgener import ThumbgenerBlob

# Инициализация генератора
tg = ThumbgenerBlob(width=1200, height=630)

# Генерация и сохранение
tg.draw("Заголовок потрясающей статьи", "thumb.webp")

Структура проекта

• Thumbgener: Базовый абстрактный класс для создания своих стилей.
• ThumbgenerBlob: Реализация стиля с цветными каплями и размытием.
• fonts/: Встроенные шрифты Ubuntu.

Разработка

# Установка зависимостей для разработки
uv sync

# Запуск CLI локально
uv run thumbgener-cli --help

Лицензия

Распространяется под лицензией MIT.