₍^. ̫ .^₎⟆

🐾 Что это такое?

Коллекция обоев для рабочего стола и пространство экспериментов в автоматизации и программировании!
Здесь вы сможете как насладиться красивыми изображениями, так и попробовать набор инструментов, написанных специально для удобного управления этим репозиторием.

🐾 Навигация по галерее

➤ 🏠 Главная

📚 subjects	🖥️ desktop	📱 mobile	☁️ other	🐾	🎨 artists
Общее	portrait	mobile	other	🐾	Grym3ik
	scene			🐾	HOJI
Touhou	desktop	mobile		🐾	Nakkar7
Vocaloid	desktop	mobile		🐾

🐾 А где?

А вот! Все картинки находятся внутри wallpapers/ и отсортированы по типам и формату:

/cuberbug-walls/
└── wallpapers  # Коллекция обоев
    ├── artists     # Именные директории для художников
    │   ├── Grym3ik     # Необычный стиль, вызывающий необычные эмоции
    │   ├── HOJI        # Потрясающая детализация
    │   └── Nakkar7     # Милое сочетание фотографии и графики
    ├── bucket      # Корзина: файлы в ней будут удалены через некоторое время
    ├── desktop     # Горизонтальный формат
    │   ├── scene       # Для гармонично проработанных артов
    │   └── portrait    # Для работ с упрощённым фоном
    ├── mobile      # Вертикальный формат
    ├── other       # Изображения без категории
    └── subjects    # Тематические подборки изображений
        ├── Touhou      # Всё, что связано с франшизой Touhou Project
        │   ├── desktop
        │   └── mobile
        └── Vocaloid    # Вокалоиды
            ├── desktop
            └── mobile

🐾 Клонирование

Со временем в репозитории может накапливаться мусор, поэтому рекомендую использовать дополнительный параметр --depth

git clone --depth 1 https://github.com/cuberbug/cuberbug-walls.git

Или клонировать только определённые директории:

git clone --filter=blob:none --no-checkout --depth=1 https://github.com/cuberbug/cuberbug-walls.git
cd cuberbug-walls
git sparse-checkout set wallpapers/mobile # Директория с обоями для телефонов, например
git checkout

🐾 Технические детали

Для оптимизации хранения используются инструменты апскейлинга и сжатия изображений.

• WebP выбранный мною формат в качестве основного
  • cwebp для работы со сжатием
• ImageMagick для создания превью
• waifu2x-ncnn-vulkan для апскейлинга

Для автоматической генерации таблиц с превью используется скрипт src/tables_generator.py и GitHub Actons. Он активируется после обновления директории с превью, которая управляется мною при помощи локальных скриптов.

---

🛠️ Инструменты

Сразу после клонирования директория tools/ будет пуста: всё так и должно быть! Если вам не хочется устанавливать инструменты — просто не запускайте tool-launcher.

Чтобы начать пользоваться инструментами, запустите скрипт tool-launcher из корня репозитория (например, tool-launcher). Он всё сделает сам:

• Автоматически загрузит или обновит набор инструментов Repo-Tools в директорию tools/.
• Запустит TUI-меню (tools/start) в новом окне терминала, если вы запустили его двойным кликом (тихий режим), или прямо в текущем, если запустили его командой в терминале.

Всё готово к использованию! Repo-Tools предложит вам установить виртуальное окружение и необходимые зависимости, чтобы вы сразу могли перейти к работе.

🐾 Технические детали

tool-launcher поддерживает использование опций:

• --help: покажет справочную информацию
• --version: покажет версию скрипта
• --debug: режим отладки с принудительным запуском целевого скрипта в новом окне терминала
• --no-window: отмена принудительного запуска целевого скрипта в новом окне терминала (только в режиме отладки)
• --no-color: активация режима бесцветного вывода текста в терминал, поддерживается переменная окружения NO_COLOR
• --branch [NAME]: позволяет при запуске загрузить версию утилит из указанной ветки

# Запуск в режиме отладки с бесцветным выводом
./tool-launcher --debug --no-color

# Запуска утилит из dev ветки
./tool-launcher --branch dev

🐾 Тихий режим

Если вы запустили tool-launcher двойным кликом, он автоматически определит ваш Desktop Environment или переберёт список поддерживаемых терминалов, чтобы открыть TUI-меню в новом окне.

🐾 Зависимости

• Git
• Python ≥ 3.10

🐾 Debian / Ubuntu

Для работы с виртуальным окружением требуется установить пакет python3-venv:

sudo apt install python3-venv

🐾 Поддерживаемые DE

• KDE Plasma
• GNOME
• 🐁 XFCE

⚙️ Repo-Tools

Repo-Tools — это отдельный репозиторий с набором инструментов, подключающийся сюда посредством установки сабмодуля. Для этого достаточно запустить tool-launcher — он всё сделает сам, а содержимое репозитория Repo-Tools окажется в директории tools/, после чего будет запущен скрипт tools/start, который предложет автоматически установить виртуальное окружение Python вместе с зависимостями и предложит запустить интерактивное TUI-меню, в котором доступен запуск любого из инструментов.

🐾 Menu

Интерактивное меню — это первое, что встретит вас после запуска инструментов. Вот что оно умеет:

• выполнять Git-операции (push / pull) через модуль GitOps;
• запускать Renamer для автоматического переименования изображений;
• быстро переключаться между режимами работы и завершать программу.

🐾 А ещё?

Можно и ещё! Подробнее об инструментах вы можете почитать в README.md репозитория Repo-Tools.

---

🌾 🌾 🌾 ₍^. ̫ .^₎⟆ 🌾 🌾 🌾

🐾 Именные директории

В коллекции со временем будут появляться директории, связанные с конкретными людьми, будь то источники или художники и их работы. В таком случае к каждой именной директории будет добавлен свой README.md с описанием и ссылками, если это возможно.

🐾 Спасибо? Спасибо!

Выражаю особую благодарность:

• Katze-942 — за помощь с идеями! ❤️
• KN13KOMETA — за вклад в кодовую базу и новый вектор для развития! ☄️