https://github.com/meowrch/pawlette

😺 Utility for changing themes in the meowrch
https://github.com/meowrch/pawlette

arch customization linux meowrch palette rice theme theme-switcher

Last synced: 3 months ago
JSON representation

😺 Utility for changing themes in the meowrch

• Host: GitHub
• URL: https://github.com/meowrch/pawlette
• Owner: meowrch
• License: gpl-3.0
• Created: 2025-02-22T17:25:12.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-02-19T15:47:26.000Z (4 months ago)
• Last Synced: 2026-02-19T19:16:51.973Z (4 months ago)
• Topics: arch, customization, linux, meowrch, palette, rice, theme, theme-switcher
• Language: Python
• Homepage:
• Size: 58.4 MB
• Stars: 9
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🐾 Pawlette

Универсальный менеджер тем.

Легко переключайтесь между темами для своего рабочего стола, сохраняя индивидуальные настройки.

Под капотом — гибкая система патчей и атомарные операции.

> [!Warning]

> Проект находится в активной разработке.

> Для production-использования рекомендуется версия 1.0+

## 🌟 Особенности

- **Полная поддержка XDG**

- **Модульная архитектура** обработчиков конфигов

- **Поддержка пользовательских тем** через единый формат

- **Частичное изменение** конфигураций (patch)

- **Git-based управление версиями** пользовательских изменений

- **Умное игнорирование** временных файлов и кешей

- **Автоматическое сохранение** пользовательских настроек при переключении тем

## ⚡ Быстрый старт

Для установки на систему Arch Linux выполните команду:

```bash

yay -S pawlette-git

```

## 🛠 Архитектура тем

Темы хранятся в `/usr/share/pawlette/themes/` или в `~/.local/share/pawlette/themes/` со структурой:

```text

theme-name/

├── configs/           # Конфигурации приложений

│   ├── kitty/

│   │   └── kitty.conf.prepaw  # патч-файл

│   ├── waybar/

│   │   ├── style.css

│   │   └── config.json

│   └── ...

├── gtk-theme/     # Папка с темой GTK

├── gtk-theme/     # Папка с иконками

└── wallpapers/    # Папка с обоями

```

Папка `configs` должна иметь ту-же архитектуру, что и `~/.config`.

Вы можете создавать папки для каждого приложения, и добавлять конфигурации.

При этом не обязательно добавлять абсолютно все конфигурации.

Вы можете ограничиться лишь теми, которые должны изменяться от темы к теме.

Применение тем происходит в формате слияния двух директорий.

Если определенного файла/папки не было, то он создастся.

А если был, то изменит контент на тот, который был написан в вашей теме.

### Патчинг конфигураций

Если файл уже существует в `.config/.../`,

и вам нужно частично изменить его (вставить что-то в начало или конец), то

для вас мы реализовали систему патчинга (patch).

Она заключается в том, что вы создаете файл с абсолютно тем-же названием и расширением,

что и в `.config/.../`, но при этом добавляете в конце суффикс ".prepaw" или ".postpaw".

> [!NOTE]

> Например был `kitty/kitty.conf`, а станет `kitty/kitty.conf.prepaw` \

> Такой файл будет расцениваться как патч.

Если суффикс `.prepaw`, то содержимое этого файла вставится перед основной частью оригинальной конфигурации.

Соответственно, если суффикс `.postpaw`, то содержимое вставится после основной части оригинальной конфигурации.

Помимо вставок, доступен JSON merge-патч: создайте файл с суффиксом `.jsonpaw` рядом с целевым JSON (например, `waybar/config.json.jsonpaw`). Его содержимое должно быть JSON-объектом; он рекурсивно смержится в целевой файл:

- существующие ключи переопределяются значениями из `.jsonpaw`;

- отсутствующие ключи добавляются;

- вложенные объекты мержатся глубоко.

Пример:

Оригинал `~/.config/waybar/config.json`:

```json

{

  "layer": "bottom",

  "modules-left": ["menu"],

  "style": { "font": "Sans 10" }

}

```

Патч `configs/waybar/config.json.jsonpaw`:

```json

{

  "layer": "top",

  "style": { "font": "JetBrainsMono 11", "color": "#cba6f7" },

  "custom-key": true

}

```

Результат:

```json

{

  "layer": "top",

  "modules-left": ["menu"],

  "style": { "font": "JetBrainsMono 11", "color": "#cba6f7" },

  "custom-key": true

}

```

JSON merge применяется перед `.prepaw`/`.postpaw`.

## 🧠 Селективный менеджер тем

Pawlette использует инновационную систему селективного управления темами на базе Git. Это означает:

- **Каждая тема = отдельная ветка** в internal git-репозитории

- **Пользовательские изменения** автоматически сохраняются как uncommitted changes

- **Переключение между темами** сохраняет ваши индивидуальные настройки

- **История изменений** доступна для каждой темы

- **Умное игнорирование** временных файлов и кешей

### Рабочий процесс:

1. **Применение темы** → создается ветка темы, применяются базовые конфигурации

2. **Ваши изменения** → отслеживаются как uncommitted changes в git

3. **Переключение темы** → автоматически сохраняет ваши изменения и переключается на другую ветку

4. **Возврат к теме** → восстанавливает вашу персонализированную версию

### Преимущества:

- 🔄 **Безопасность**: невозможно потерять пользовательские настройки

- 📚 **История**: полная история изменений для каждой темы

- 🎯 **Селективность**: изменяются только релевантные файлы

- 🧹 **Чистота**: автоматическое игнорирование "мусорных" файлов

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

| Команда                    | Описание                                      |

| -------------------------- | --------------------------------------------- |

| `pawlette generate-config` | Сгенерировать конфигурацию по умолчанию       |

| `pawlette get-themes`      | Список установленных тем                      |

| `pawlette get-themes-info` | JSON с информацией об установленных темах     |

| `pawlette set-theme `| Применить указанную тему                      |

| `pawlette apply `    | Применить указанную тему (алиас)              |

| `pawlette current-theme`   | Показать текущую активную тему                |

| `pawlette restore`         | Восстановить оригинальный вид                 |

| `pawlette reset-theme ` | Сбросить тему к чистому состоянию          |

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

| Команда                              | Описание                                 |

| ------------------------------------ | ---------------------------------------- |

| `pawlette get-store-themes`          | JSON со всеми темами из удалённого магазина |

| `pawlette install-theme ` | Установить тему по имени из репозитория, по ссылке на архив или из локального файла архива |

| `pawlette update-theme `       | Обновить тему из официального репозитория   |

| `pawlette update-all-themes`         | Обновить все темы                           |

| `pawlette uninstall-theme ` | Удалить тему (локальные файлы и кэш)      |

## 📜 Управление версиями и историей

| Команда                                      | Описание                                    |

| -------------------------------------------- | ------------------------------------------- |

| `pawlette status`                            | Показать статус и незакоммиченные изменения |

| `pawlette history [theme] [--limit N]`      | Показать историю коммитов для темы         |

| `pawlette user-changes [theme]`             | Показать информацию о пользовательских изменениях |

| `pawlette restore-commit  [theme]`    | Восстановить изменения из конкретного коммита |

### Примеры использования:

```bash

# Проверить текущий статус

pawlette status

# ➤ Current theme: dark-blue

# ⚠️  You have 3 uncommitted changes

# Modified files:

#   - kitty/kitty.conf

#   - waybar/config.json

#   - alacritty/alacritty.yml

# Посмотреть историю текущей темы

pawlette history

# 📜 History for theme: dark-blue

# 👤 a1b2c3d Персональные настройки шрифтов [USER]

# 🔧 e4f5g6h Обновление конфигурации waybar

# 🔧 h7i8j9k Первоначальное применение темы

# Посмотреть, какие файлы изменены в теме

pawlette user-changes dark-blue

# 🔍 User changes for theme: dark-blue

# Found 2 modified files:

#   📝 kitty/kitty.conf

#   📝 waybar/style.css

# Восстановить определенный коммит

pawlette restore-commit a1b2c3d

# ✅ Successfully restored commit a1b2c3d for theme dark-blue

```

## 🔄 Управление бэкапами

| Команда                                                             | Описание                       |

| ------------------------------------------------------------------- | ------------------------------ |

| `pawlette backup list ~/.config//config.conf`                  | Показать все версии файла      |

| `pawlette backup restore ~/.config//config.conf`               | Восстановить последнюю версию  |

| `pawlette backup restore ~/.config//config.conf --hash abc123` | Восстановить конкретную версию |

| `pawlette system-backup list`                                       | Показать системные бэкапы      |

| `pawlette system-backup create --comment "Before dark theme"`       | Создать полный бэкап           |

| `pawlette system-backup restore BACKUP_ID`                          | Откатить всю систему           |

## ☕ Поддержать проект

Если Pawlette делает ваш рабочий стол красивее:

| Криптовалюта | Адрес                                              |

| ------------ | -------------------------------------------------- |

| **TON**      | `UQB9qNTcAazAbFoeobeDPMML9MG73DUCAFTpVanQnLk3BHg3` |

| **Ethereum** | `0x56e8bf8Ec07b6F2d6aEdA7Bd8814DB5A72164b13`       |

| **Bitcoin**  | `bc1qt5urnw7esunf0v7e9az0jhatxrdd0smem98gdn`       |

| **Tron**     | `TBTZ5RRMfGQQ8Vpf8i5N8DZhNxSum2rzAs`               |

Ваша поддержка мотивирует нас делать больше крутых фич! ❤️

## 📊 Статистика

[![Star History Chart](https://api.star-history.com/svg?repos=meowrch/pawlette&type=Date)](https://star-history.com/#meowrch/pawlette&Date)