> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/ru/useful-resources/gh0stzk-bspwm-dotfiles.md). # Настройка Arch Linux для хакера с BSPWM Руководство по настройке Arch Linux для хакера с dotfiles gh0stzk BSPWM, быстрой установкой, темами, Polybar, Rofi, ZSH, Neovim, командами и сочетаниями клавиш. [gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) — это полноценная среда рабочего стола BSPWM для Arch Linux и дистрибутивов на базе Arch. Она включает темы, панели, лаунчеры, настройки терминала, ZSH, Neovim, апплеты Rofi, обои и вспомогательные скрипты для быстрого переключения стилей.
gh0stzk BSPWM dotfiles desktop screenshot with terminal and Linux fetch output

Пример среды рабочего стола BSPWM из README проекта.

{% hint style="warning" %} Устанавливайте это только на личной лабораторной машине или на свежей Linux-рабочей станции. Dotfiles заменяют множество пользовательских конфигурационных файлов, поэтому перед запуском проверьте установщик и сделайте резервную копию текущей конфигурации. {% endhint %} ## Где это уместно Это относится к `Полезные ресурсы` потому что это ресурс для настройки рабочей станции, а не инструмент для пентестинга. Используйте его, когда вам нужна чистая BSPWM-среда на базе Arch для ежедневных заметок, лабораторных работ, CTF, разработки и процессов, активно использующих терминал. ## Что вы получите | Компонент | Что это означает | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | BSPWM | Плиточный оконный менеджер для быстрой среды, управляемой с клавиатуры. | | 18 тем | Готовые визуальные стили, которые можно переключать на лету. | | Polybar | Панель рабочего стола с рабочими пространствами, модулями, системной информацией и цветами темы. | | Апплеты Rofi | Меню для приложений, питания, скриншотов, буфера обмена, сети, Bluetooth, обоев и многого другого. | | Терминалы | Поддержка тем для Alacritty, Kitty, Ghostty, ST и Xfce Terminal. | | Конфиг ZSH | Быстрая настройка оболочки с автодополнением, поиском по истории и предпросмотром fzf-tab. | | Конфиг Neovim | Готовая настройка редактора с LSP, автодополнением, форматированием, файловым обозревателем, строкой состояния и панелью приветствия. | | RiceEditor | Вспомогательное приложение для настройки визуальных параметров без ручного редактирования каждого конфига. | ## Визуальный предпросмотр Проект очень визуальный, поэтому перед установкой посмотрите скриншоты и демонстрацию.
gh0stzk dotfiles theme selector screenshot

Выбор темы.

gh0stzk dotfiles wallpaper selector screenshot

Выбор обоев.

gh0stzk dotfiles RiceEditor screenshot

RiceEditor для настройки темы.

### Демо проекта {% embed url="" %} ### Пошаговая установка Arch Это видео автора полезно, если вы хотите чистую установку Arch перед применением dotfiles. {% embed url="" %} ### Канал проекта На канале автора есть ещё демонстрации BSPWM, Polybar, Eww, Rofi и тем. {% embed url="" %} ## Перед установкой Официальный установщик предназначен для Arch Linux и дистрибутивов на базе Arch. В README указано, что дистрибутивы без systemd, такие как Artix, не поддерживаются. Рекомендуемая отправная точка: | Требование | Заметки | | --------------------------------------- | ----------------------------------------------------------- | | Arch или дистрибутив на базе Arch | Самый безопасный вариант — чистая установка. | | Обычная пользовательская учётная запись | Не запускайте установщик от root. | | Рабочее интернет-соединение | Установщик загружает пакеты и репозитории. | | Менеджер входа | Проект рекомендует LightDM. | | NetworkManager | Требуется для сетевого апплета Rofi. | | Резервная копия | Сохраните копию существующих `~/.config` и файлов оболочки. | Полезная команда резервного копирования перед тестированием: ```bash mkdir -p "$HOME/dotfiles-backup" cp -a "$HOME/.config" "$HOME/dotfiles-backup/config-$(date +%F)" 2>/dev/null cp -a "$HOME/.zshrc" "$HOME/.gtkrc-2.0" "$HOME/.icons" "$HOME/dotfiles-backup/" 2>/dev/null ``` ## Быстрая настройка Arch Используйте это, если вы начинаете с чистой машины Arch или виртуальной машины и хотите максимально короткий практический путь. ### 1. Загрузитесь с Arch ISO Начните с официального Arch ISO. Если используете Wi-Fi, сначала подключитесь: ```bash iwctl ``` Внутри `iwctl`: ``` device list station wlan0 scan station wlan0 get-networks station wlan0 connect "SSID" exit ``` Проверьте интернет: ```bash ping -c 3 archlinux.org ``` Синхронизируйте время: ```bash timedatectl set-ntp true ``` ### 2. Быстро установите Arch Быстрый путь — `archinstall`: ```bash archinstall ``` Рекомендуемые варианты: | Параметр | Выберите | | --------------------- | ---------------------------------------------------------------------------- | | Разметка диска | По умолчанию или вручную, в зависимости от вашей VM/диска. | | Загрузчик | `systemd-boot` для UEFI; GRUB, если он вам больше нравится. | | Профиль | Минимального достаточно; рабочий стол необязателен. | | Сеть | NetworkManager. | | Аудио | PipeWire. | | Пользователь | Создайте обычного пользователя с доступом к sudo. | | Дополнительные пакеты | `git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager` | После установки: ```bash reboot ``` ### 3. Включите базовые службы Войдите под обычным пользователем, затем убедитесь, что базовые службы готовы: ```bash sudo pacman -Syu sudo pacman -S --needed git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager sudo systemctl enable --now NetworkManager sudo systemctl enable lightdm ``` Перезагрузитесь ещё раз, если только что включили LightDM: ```bash sudo reboot ``` ## Установка dotfiles Откройте терминал из домашнего каталога: ```bash cd "$HOME" ``` Скачайте официальный установщик: ```bash curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller ``` Проверьте установщик перед запуском: ```bash less RiceInstaller ``` Дайте ему права на выполнение: ```bash chmod +x RiceInstaller ``` Запустите его от обычного пользователя: ```bash ./RiceInstaller ``` Установщик интерактивный. Он может спросить, нужны ли вам включённые конфигурации Neovim и Firefox. Читайте каждый запрос, а не просто нажимайте Enter везде. ### Установка одним блоком Для быстрой лабораторной установки, когда у вас уже есть рабочий Arch: ```bash cd "$HOME" curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller less RiceInstaller chmod +x RiceInstaller ./RiceInstaller ``` ## Что делает установщик В общих чертах установщик: 1. Проверяет, что он не запущен от root. 2. Проверяет, что он запускается из `$HOME`. 3. Добавляет `gh0stzk-dotfiles` репозиторий пакетов. 4. Добавляет Chaotic-AUR. 5. Скачивает dotfiles. 6. Создаёт резервные копии существующих пользовательских конфигов, где это необходимо. 7. Устанавливает окружение BSPWM. 8. Включает MPD для музыкальных функций. 9. Меняет оболочку на ZSH. Скрипт также перемещает многие существующие папки конфигурации в каталог резервной копии перед заменой. Тем не менее, сначала сделайте свою собственную резервную копию. ## Первый вход После установки: 1. Перезагрузитесь или выйдите из системы. 2. Выберите сеанс BSPWM в менеджере входа. 3. Войдите как обычно. 4. Подождите, пока при первом запуске завершится автоконфигурация. 5. Проверьте терминал, Rofi, Polybar, выбор темы и выбор обоев. Если вы работаете в виртуальной машине и рабочий стол кажется сломанным или медленным, попробуйте сменить Picom с `glx` на `xrender` прежде чем считать, что установка не удалась. ## Что проверить в первую очередь После первого запуска проверьте переменные, связанные с оборудованием. Откройте: ```bash ~/.config/bspwm/config/system.ini ``` Проверьте значения для: | Значение | Почему это важно | | ----------------- | ---------------------------------------- | | Сетевой интерфейс | Модули сети на панели. | | Видеокарта | Некоторые визуальные и статусные модули. | | Батарея и адаптер | Модули батареи ноутбука и яркости. | Если у вас настольный ПК, обычно главным для проверки является сетевой интерфейс. ## Полезные команды | Команда | Используйте | | ----------------------------------- | ------------------------------------------------------------------------- | | `RiceSelector` | Откройте выбор темы. | | `RiceEditor` | Визуально отредактируйте текущую тему. | | `WallSelect` | Откройте выбор обоев. | | `Term --selecterm` | Выберите приложение терминала. | | `OpenApps --menu` | Откройте лаунчер приложений. | | `OpenApps --KeyHelp` | Откройте шпаргалку по сочетаниям клавиш. | | `OpenApps --screenshot` | Откройте инструмент для скриншотов. | | `OpenApps --netmanager` | Откройте апплет сетевого менеджера. | | `OpenApps --bluetooth` | Откройте апплет Bluetooth. | | `OpenApps --clipboard` | Откройте менеджер буфера обмена. | | `OpenApps --powermenu` | Откройте меню питания. | | `OpenApps --keyboard` | Откройте апплет раскладки клавиатуры. | | `OpenApps --scratch` | Откройте scratchpad. | | `HideBar -h` | Скрыть панели. | | `HideBar -u` | Показать панели. | | `SoftReload` | Выполните мягкую перезагрузку окружения. | | `ScreenLocker` | Заблокировать экран. | | `bspc wm -r` | Перезагрузить BSPWM. | | `pkill -USR1 -x sxhkd` | Перезагрузить привязки клавиш. | | `~/.config/bspwm/config/system.ini` | Переменные оборудования/модулей, которые нужно проверить после установки. | | `~/.config/bspwm/config/sxhkdrc` | Основной файл привязок клавиш. | ## Полный список горячих клавиш Проект показывает визуальную шпаргалку с помощью `Alt + F1`. `Super` означает клавишу Windows на большинстве клавиатур. Источник истины — установленный `~/.config/bspwm/config/sxhkdrc`; эта таблица следует текущему upstream-файлу и группирует все сочетания, чтобы их было легче просматривать. ### Справка | Клавиши | Действие | | ---------- | --------------------------------------- | | `Alt + F1` | Показать шпаргалку по горячим клавишам. | ### Основные приложения | Клавиши | Действие | | ---------------------- | ---------------------------------- | | `Super + Return` | Открыть обычный терминал. | | `Super + Alt + Return` | Открыть плавающий терминал. | | `Super + Space` | Откройте лаунчер приложений. | | `Alt + Space` | Открыть выбор темы. | | `Super + B` | Открыть браузер. | | `Super + E` | Открыть редактор. | | `Super + F` | Открыть файловый менеджер. | | `Super + Y` | Открыть Yazi. | | `Super + V` | Открыть Neovim. | | `Super + M` | Открыть музыкальный плеер/Ncmpcpp. | | `Super + P` | Открыть Pavucontrol. | | `Super + T` | Открыть Telegram. | | `Super + W` | Открыть WhatsApp. | | `Super + R` | Открыть RiceEditor. | ### Апплеты Rofi | Клавиши | Действие | | ------------------------------------------------ | ---------------------------- | | `Super + Alt + T` | Выбор терминала. | | `Super + Alt + W` | Выбор обоев. | | `Super + Alt + A` | Апплет монтирования Android. | | `Super + Alt + N` | Сетевой менеджер. | | `Super + Alt + B` | Менеджер Bluetooth. | | `Super + Alt + C` | Менеджер буфера обмена. | | `Super + Alt + S` | Инструмент для скриншотов. | | `Super + Alt + P` | Меню питания. | | `Super + Alt + L` | Выбор стиля лаунчера Rofi. | | `Super + Alt + K` | Апплет раскладки клавиатуры. | | `Super + Alt + X` | Апплет RofiPass/паролей. | | `Щёлкните правой кнопкой мыши по рабочему столу` | Откройте Jgmenu. | ### Система и окружение | Клавиши | Действие | | ------------------------ | --------------------------------------- | | `Super + Alt + O` | Scratchpad. | | `Ctrl + Super + Alt + P` | Выключить компьютер. | | `Ctrl + Super + Alt + R` | Перезагрузить компьютер. | | `Ctrl + Super + Alt + Q` | Выйти из системы. | | `Ctrl + Super + Alt + L` | Заблокировать экран. | | `Ctrl + Super + Alt + K` | Завершить приложение с помощью `xkill`. | | `Ctrl + Super + Alt + S` | Мягкая перезагрузка. | | `Super + Alt + H` | Скрыть панель. | | `Super + Alt + U` | Показать панель. | | `Ctrl + Alt + Plus` | Увеличить прозрачность активного окна. | | `Ctrl + Alt + Minus` | Уменьшить прозрачность активного окна. | | `Ctrl + Alt + T` | Сбросить прозрачность активного окна. | | `XF86MonBrightnessUp` | Увеличить яркость. | | `XF86MonBrightnessDown` | Уменьшить яркость. | | `XF86AudioRaiseVolume` | Увеличить громкость. | | `XF86AudioLowerVolume` | Уменьшить громкость. | | `XF86AudioMute` | Переключить беззвучный режим. | | `XF86AudioNext` | Следующий медиа-трек. | | `XF86AudioPrev` | Предыдущий медиа-трек. | | `XF86AudioPlay` | Воспроизведение/пауза медиаконтента. | | `XF86AudioStop` | Остановить мультимедиа. | ### Ядро BSPWM | Клавиши | Действие | | ------------------- | ------------------------------------ | | `Super + Alt + R` | Перезагрузить BSPWM. | | `Super + X` | Закрыть выбранный узел. | | `Super + Shift + X` | Убить выбранный узел. | | `Super + Escape` | Перезагрузить привязки клавиш sxhkd. | ### Состояния и флаги узлов | Клавиши | Действие | | ----------------- | ---------------------------------------------- | | `Alt + T` | Установить узел мозаичным. | | `Alt + Shift + T` | Установить узел псевдомозаичным. | | `Alt + A` | Установить узел плавающим. | | `Alt + F` | Установить узел полноэкранным. | | `Alt + M` | Переключить флаг marked. | | `Alt + X` | Переключить флаг locked. | | `Alt + S` | Переключить флаг sticky. | | `Alt + P` | Переключить флаг private. | | `Alt + H` | Скрыть выбранное окно. | | `Ctrl + Alt + H` | Показать меню для восстановления скрытых окон. | ### Рабочие пространства и фокус | Клавиши | Действие | | ---------------------------------------- | ---------------------------------------------------------------------------- | | `Ctrl + Tab` | Повернуть рабочий стол. | | `Super + Left` | Переключиться на предыдущее рабочее пространство. | | `Super + Right` | Переключиться на следующее рабочее пространство. | | `Super + 1` на `Super + 9` | Сфокусировать рабочее пространство 1–9. | | `Super + 0` | Сфокусировать рабочее пространство 10. | | `Super + Ctrl + 1` на `Super + Ctrl + 9` | Отправить выбранное окно в рабочее пространство 1–9. | | `Super + Ctrl + 0` | Отправить выбранное окно в рабочее пространство 10. | | `Super + Ctrl + Left` | Отправить выбранное окно в предыдущее рабочее пространство и перейти за ним. | | `Super + Ctrl + Right` | Отправить выбранное окно в следующее рабочее пространство и перейти за ним. | | `Alt + Tab` | Переключатель окон. | | `Super + Alt + Left` | Сфокусировать окно на запад, при неудаче — предыдущее. | | `Super + Alt + Down` | Сфокусировать окно на юг. | | `Super + Alt + Up` | Сфокусировать окно на север. | | `Super + Alt + Right` | Сфокусировать окно на восток, при неудаче — следующее. | | `Ctrl + Alt + Left` | Переместить выбранное окно на запад. | | `Ctrl + Alt + Down` | Переместить выбранное окно на юг. | | `Ctrl + Alt + Up` | Переместить выбранное окно на север. | | `Ctrl + Alt + Right` | Переместить выбранное окно на восток. | | `Ctrl + Shift + Comma` | Сфокусировать последний узел. | | `Ctrl + Shift + Period` | Сфокусировать последний рабочий стол. | ### Предвыбор | Клавиши | Действие | | ------------------ | ------------------------------------------------ | | `Super + Ctrl + H` | Предвыбрать горизонтальное/восточное разделение. | | `Super + Ctrl + V` | Предвыбрать вертикальное/южное разделение. | | `Super + Ctrl + Q` | Отменить предвыбор. | ### Перемещение и изменение размера | Клавиши | Действие | | ----------------------- | ---------------------------------- | | `Super + Ctrl + B` | Выровнять узлы рабочего стола. | | `Super + Alt + Plus` | Увеличить размер мозаичного узла. | | `Super + Alt + Minus` | Уменьшить размер мозаичного узла. | | `Super + Ctrl + Plus` | Увеличить размер плавающего узла. | | `Super + Ctrl + Minus` | Уменьшить размер плавающего узла. | | `Super + Shift + Left` | Переместить плавающее окно влево. | | `Super + Shift + Down` | Переместить плавающее окно вниз. | | `Super + Shift + Up` | Переместить плавающее окно вверх. | | `Super + Shift + Right` | Переместить плавающее окно вправо. | ### Множественная операция | Клавиши | Действие | | ----------------------------- | ------------------------------------------------------------------ | | `Super + Ctrl + X` | Закрыть все узлы на текущем рабочем столе. | | `Super + N`, затем `X` | Закрыть все несфокусированные локальные окна. | | `Super + N`, затем `K` | Убить все несфокусированные локальные окна. | | `Super + N`, затем `M` | Перенести все отмеченные окна на сфокусированный рабочий стол. | | `Super + N`, затем `1` на `9` | Перенести все окна с этого рабочего стола на текущий рабочий стол. | ## Общая настройка ### Изменить тему Используйте: ``` Alt + Space ``` Выберите тему в селекторе. Окружение обновится без необходимости перезапускать всю сессию. ### Изменить обои Используйте: ``` Super + Alt + W ``` Проект поддерживает случайные обои, пользовательские каталоги, фиксированные обои, анимированные обои и режим слайд-шоу. ### Редактировать текущую тему Используйте RiceEditor, если хотите настроить визуальные параметры, не редактируя вручную каждый модуль: ``` RiceEditor ``` Обычно редактируются границы, тени, анимации, прозрачность, поведение обоев и параметры модулей, специфичные для темы. ## Устранение неполадок | Проблема | Что проверить | | ----------------------------------------------- | ---------------------------------------------------------------------------------------------- | | После входа возвращает к диспетчеру отображения | Убедитесь, что сеанс BSPWM установлен, и проверьте `~/.xsession-errors`. | | Модули панели отображаются неправильно | Проверьте `~/.config/bspwm/config/system.ini`. | | Сетевой апплет не работает | Убедитесь, что NetworkManager установлен и запущен. | | Графика ВМ выглядит повреждённой | Попробуйте Picom `xrender` бэкенд вместо `glx`. | | Сочетания клавиш не работают | Проверьте `sxhkd` запущен, и проверьте `~/.config/bspwm/config/sxhkdrc`. | | Тема выглядит смещённой | Проект рассчитан на 1600x900 и 96 DPI; подстройте под свой монитор. | | Существующие конфигурации исчезли | Проверьте папку резервной копии, созданную установщиком, и вашу собственную `dotfiles-backup`. | ## Примечания по чистой переустановке Для самого безопасного повторного запуска: 1. Сделайте резервную копию текущих файлов. 2. Удалите или переместите старые каталоги dotfiles. 3. Снова загрузите последнюю версию `RiceInstaller`. 4. Ещё раз проверьте скрипт. 5. Запустите его из `$HOME` как обычный пользователь. Не запускайте случайные изменённые установщики из сторонних форков, если вы не проверили diff. ## Ссылки * [Официальный репозиторий gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) * [RiceInstaller](https://github.com/gh0stzk/dotfiles/blob/master/RiceInstaller) * [Первые шаги после установки](https://github.com/gh0stzk/dotfiles/wiki/First-steps-after-installation) * [Вики по сочетаниям клавиш](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts) * [Текущий файл привязок клавиш sxhkdrc](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc) * [Вики по настройке обоев](https://github.com/gh0stzk/dotfiles/wiki/Wallpapers-Configuration) * [ArchWiki: bspwm](https://wiki.archlinux.org/title/Bspwm) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://hacking-notes.jord4n.pro/ru/useful-resources/gh0stzk-bspwm-dotfiles.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.