diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..b266669
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2026] [Frolov Ivan Olegovich(s13bby)]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTIONBALE ACTION, WHETHER IN CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/README.md b/README.md
index 232b85f..c9e8465 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,135 @@
-# labwc
+# Labwc Dotfiles
 
+Минималистичная и производительная Wayland-сборка на базе **Labwc** с динамической темой **Aether**.
+
+![Desktop Preview](https://i.ibb.co/YBh97H0T/image.png)
+
+## ✨ Особенности
+
+-   **Композитор:** Labwc
+-   **Тема:** Aether — динамическая цветовая схема, применяемая ко всем приложениям
+-   **Панель:** Waybar
+-   **Уведомления:** Mako
+-   **Лаунчер:** Wofi
+-   **Блокировка:** Hyprlock + Hypridle
+-   **Звук:** PipeWire + EasyEffects (EQ для DT 990 Pro)
+-   **Сеть:** V2RayA с переключением прямо из панели
+-   **Буфер обмена:** Cliphist с поддержкой текста и изображений
+
+## ⌨️ Горячие клавиши
+
+| Сочетание | Действие |
+| :--- | :--- |
+| `Super + Space` | Открыть меню приложений (Wofi) |
+| `Super + Return` | Терминал (Alacritty) |
+| `Super + E` | Файловый менеджер (Dolphin) |
+| `Super + L` | Заблокировать экран |
+| `Super + W` | Закрыть окно |
+| `Super + F` | Максимизировать / восстановить окно |
+| `Shift + Super + F` | Полноэкранный режим |
+| `Shift + Ctrl + F` | Свернуть окно |
+| `Super + ;` | Прикрепить окно влево |
+| `Super + '` | Прикрепить окно вправо |
+| `Super + 1..4` | Переключить рабочий стол |
+| `Shift + Super + S` | Скриншот области (в буфер обмена) |
+| `Ctrl + Super + V` | Менеджер буфера обмена (с картинками) |
+| `AltGr + S` | Play/Pause (Spotify / любой плеер) |
+| `AltGr + D` | Следующий трек |
+| `AltGr + A` | Предыдущий трек |
+
+## 📁 Структура репозитория
+
+```
+labwc/
+├── install.sh              # Bootstrap-скрипт установки
+├── pkglist-repo.txt        # Пакеты из официальных репозиториев
+├── pkglist-aur.txt         # Пакеты из AUR
+├── README.md               # Этот файл
+├── easyeffects/            # Пресеты эквалайзера
+│   ├── dt990.json
+│   └── Beyerdynamic DT 990 Pro (250 Ohm) ParametricEq.txt
+└── config/
+    ├── aether/             # Тема Aether (цвета, обои, конфиги приложений)
+    ├── labwc/              # Конфигурация композитора
+    │   ├── rc.xml          # Бинды, правила окон
+    │   ├── autostart       # Автозапуск сервисов
+    │   ├── environment     # Переменные окружения
+    │   ├── menu.xml        # Контекстное меню
+    │   ├── update_theme.sh # Скрипт применения темы Aether
+    │   └── themes/DynamicAether/
+    ├── hypr/               # Hypridle + Hyprlock конфиги
+    ├── waybar/             # Панель + v2raya-toggle
+    ├── wofi/               # Лаунчер + cliphist-img
+    ├── mako/               # Уведомления
+    ├── qt6ct/              # Qt6 тема
+    ├── dolphinrc           # Dolphin настройки
+    ├── kdeglobals          # KDE глобальные настройки
+    └── sddmthemeinstallerrc
+```
+
+## 🚀 Установка
+
+### Чистая установка (рекомендуется)
+
+1.  Установите базовую систему через `archinstall` или вручную
+2.  Клонируйте репозиторий:
+    ```bash
+    git clone https://zenithcode.duckdns.org/s13bby/labwc.git ~/labwc
+    cd ~/labwc
+    ```
+3.  Запустите установку:
+    ```bash
+    chmod +x install.sh
+    ./install.sh
+    ```
+4.  Перезагрузитесь
+
+### Обновление существующей конфигурации
+
+```bash
+cd ~/labwc && git pull && ./install.sh
+```
+
+> ⚠️ Скрипт использует `cp -rn` (не перезаписывает существующие файлы). Для полного сброса удалите целевые директории в `~/.config/` перед запуском.
+
+## 🎨 Как работает тема Aether
+
+Тема применяется **динамически** через скрипт `update_theme.sh`:
+
+1.  Читает цвета из `~/.config/aether/theme/waybar.css`
+2.  Генерирует `themerc-override` для Labwc (цвета рамок, заголовков)
+3.  Устанавливает обои через `swaybg`
+4.  Вызывается автоматически при старте и через контекстное меню → **reconfigure**
+
+Все приложения (Waybar, Wofi, Hyprlock, Alacritty) импортируют цвета из CSS/TOML файлов темы Aether, поэтому смена темы обновляет **всё** одновременно.
+
+## 🔧 Зависимости
+
+| Компонент | Назначение |
+| :--- | :--- |
+| `labwc` | Wayland-композитор |
+| `uwsm` | Менеджер Wayland-сессий |
+| `waybar` | Статус-бар |
+| `wofi` | Лаунчер приложений |
+| `mako` | Уведомления |
+| `hyprlock` + `hypridle` | Блокировка экрана и idle-менеджмент |
+| `cliphist` + `wl-clipboard` | Буфер обмена |
+| `grim` + `slurp` + `swappy` | Скриншоты |
+| `pipewire` + `wireplumber` | Аудио-стек |
+| `easyeffects` | Эквалайзер / DSP |
+| `v2raya-bin` | Прокси-клиент |
+| `playerctl` | Управление медиаплеерами |
+| `sddm` | Display manager |
+
+Полные списки пакетов: [`pkglist-repo.txt`](pkglist-repo.txt) и [`pkglist-aur.txt`](pkglist-aur.txt).
+
+## 📝 Примечания
+
+-   **NVIDIA:** Используется открытый драйвер `nvidia-open`. Убедитесь, что `mkinitcpio -P` выполнен после установки
+-   **SDDM:** Тема Monochrome устанавливается автоматически. Если не применилась: `sudo cp /usr/share/sddm/themes/monochrome /usr/share/sddm/themes/` и выберите в настройках
+-   **V2RayA:** Требует настройки через веб-интерфейс (`http://localhost:2017`) после первого запуска
+-   **EasyEffects:** Пресет DT 990 Pro загружается автоматически. Откройте EasyEffects для активации
+
+## 📄 Лицензия
+
+MIT — делайте с этими конфигами что хотите.
\ No newline at end of file