Что такое pawlette?

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

Pawlette — это универсальный менеджер тем для Meowrch, который использует инновационную Git-based систему управления темами. Каждая тема представляет собой отдельную ветку, что обеспечивает безопасность ваших настроек и полную историю изменений.

🌟 Основные возможности

Безопасность данных — невозможно потерять пользовательские настройки при смене тем
Модульная архитектура — изменяются только релевантные файлы конфигурации
Git-based версионность — полная история изменений для каждой темы
Система патчей — частичное изменение конфигураций
XDG совместимость — полная поддержка стандартов

🚀 Установка и настройка

Установка Pawlette

Установите пакет из AUR:
```
yay -S pawlette
```
или
```
paru -S pawlette
```
Генерация конфигурации

Создайте базовую конфигурацию:
```
pawlette generate-config
```
Просмотр доступных тем

Посмотрите список доступных тем из удалённого магазина:
```
pawlette get-store-themes
```
Установка темы

Установите нужную тему:
```
pawlette install-theme catppuccin-mocha
```
Применение темы

Активируйте установленную тему:
```
pawlette apply catppuccin-mocha
```

🎛 Управление темами

Основные команды

Команда	Описание
`pawlette get-themes`	Список установленных тем
`pawlette set-theme <name>` или `pawlette apply <name>`	Применить тему
`pawlette current-theme`	Показать активную тему
`pawlette status`	Показать статус и изменения
`pawlette restore`	Восстановить оригинальный вид
`pawlette reset-theme <name>`	Сбросить тему к чистому состоянию

Установка, обновление и удаление тем

Команда	Описание
`pawlette get-store-themes`	JSON со всеми доступными темами из удалённого магазина
`pawlette get-themes-info`	JSON с информацией об установленных темах
`pawlette install-theme <name/url/path>`	Установить тему
`pawlette update-theme <name>`	Обновить тему
`pawlette update-all-themes`	Обновить все темы
`pawlette uninstall-theme <name>`	Удалить тему (локальные файлы и кэш)

Создание собственных тем

Подробная документация по созданию собственных тем в Pawlette находится здесь.

Работа с версиями (Git)

Команда	Описание
`pawlette history [theme] [--limit N]`	История коммитов (по умолчанию показывает 10)
`pawlette user-changes [theme]`	Пользовательские изменения
`pawlette restore-commit <hash> [theme]`	Восстановить коммит

🔄 Git-based управление версиями

Pawlette автоматически создает внутренний Git-репозиторий для отслеживания изменений:

Проверка статуса

pawlette status
# ➤ Current theme: catppuccin-mocha
# ⚠️  You have 3 uncommitted changes
# Modified files:
#   - kitty/kitty.conf
#   - waybar/config.json
#   - hypr/hyprland.conf

Просмотр истории

pawlette history
# 📜 History for theme: catppuccin-mocha
# 👤 a1b2c3d Персональные настройки шрифтов [USER]
# 🔧 e4f5g6h Обновление конфигурации waybar
# 🔧 h7i8j9k Первоначальное применение темы

# Ограничить количество коммитов
pawlette history --limit 5

Работа с пользовательскими изменениями

# Посмотреть какие файлы изменены
pawlette user-changes
# 🔍 User changes for theme: catppuccin-mocha
# Found 2 modified files:
#   📝 kitty/kitty.conf
#   📝 waybar/style.css

# Восстановить конкретный коммит
pawlette restore-commit a1b2c3d
# ✅ Successfully restored commit a1b2c3d for theme catppuccin-mocha

🛠️ Прямая работа с Git-репозиторием

Pawlette хранит всю информацию о темах в Git-репозитории по адресу ~/.local/state/pawlette/config_state.git.

Подключение к Git-репозиторию

# Перейти в директорию конфигов
cd ~/.config

# Использовать Git с указанием нашего репозитория
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Теперь можно выполнять любые Git команды
git status
git log
git diff

Полезные команды

Просмотр всех веток (тем)

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git
git branch --all

# Вывод:
# * catppuccin-mocha
#   catppuccin-latte
#   catppuccin-mocha-v1.3.1-backup-20251024-165427
#   main

Просмотр полного diff ваших изменений

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Посмотреть все uncommitted изменения в текущей теме
git diff

# Посмотреть staged изменения
git diff --cached

# Посмотреть изменения относительно последнего коммита темы
git diff HEAD

# Сохранить diff в файл
git diff > my-changes.patch

Просмотр детальной истории

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Подробная история с файлами
git log --stat

# История с полным diff
git log -p

# История конкретного файла
git log -- kitty/kitty.conf

# Красивое дерево коммитов
git log --graph --oneline --all

Сравнение веток (тем)

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Сравнить две темы
git diff catppuccin-mocha..catppuccin-latte

# Посмотреть какие файлы отличаются
git diff --name-only catppuccin-mocha..catppuccin-latte

🗂️ Управление бэкапами тем

При обновлении темы Pawlette автоматически создаёт бэкап старой версии.

Просмотр бэкапов

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Посмотреть все бэкапы
git branch --list '*-backup-*'

# Вывод:
#   catppuccin-mocha-v1.3.1-backup-20251024-165427
#   catppuccin-mocha-v1.2.0-backup-20251020-120000

Восстановление изменений из бэкапа

Способ 1: Переключиться на бэкап

# Применить бэкап как обычную тему
pawlette apply catppuccin-mocha-v1.3.1-backup-20251024-165427

Способ 2: Скопировать изменения через cherry-pick

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Посмотреть коммиты в бэкапе
git log catppuccin-mocha-v1.3.1-backup-20251024-165427

# Скопировать нужный коммит в текущую ветку
git cherry-pick <commit-hash>

Способ 3: Создать patch-файл

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Экспортировать все изменения из бэкапа
git diff main..catppuccin-mocha-v1.3.1-backup-20251024-165427 > my-customizations.patch

# Применить patch к текущей теме
git apply my-customizations.patch

Удаление старых бэкапов

cd ~/.config
set -gx GIT_DIR ~/.local/state/pawlette/config_state.git

# Удалить конкретный бэкап
git branch -D catppuccin-mocha-v1.2.0-backup-20251020-120000

# Удалить все старые бэкапы (оставить последние 3)
# Для этого можно использовать скрипт или делать вручную
git branch --list '*-backup-*' | sort -r | tail -n +4 | xargs -r git branch -D

🔗 Автоматическое создание симлинков

При применении темы Pawlette автоматически создает символические ссылки:

Отладка проблем

При проблемах с применением темы используйте pawlette restore
Для сброса темы к исходному состоянию: pawlette reset-theme <name>
Проверяйте логи и статус после каждого изменения
Используйте pawlette user-changes для просмотра ваших модификаций

Совместимость

Система Pawlette делает кастомизацию meowrch простой и безопасной, позволяя легко экспериментировать с внешним видом системы без риска потерять важные настройки.