wallpaper_zones

! 100% вайбкод !

1. В меню ПКМ на рабочем столе и в файловом менеджере добавляет опции claude и claude remote control. Они открывают клод в текущей папке, не спрашивая, доверяете ли вы ей.
2. Перехватывает ПКМ по рабочему столу и определяет, в какой папке должны открываться claude, claude remote control и open terminal here
3. Позволяет редактировать какая папка относится к каким кликам с помощью десктоп приложения "Зоны рабочего стола"

Установка

Debian / Ubuntu с XFCE (Thunar), сеанс X11. Пакет собирается из каждого коммита в main и лежит в apt-репозитории https://git.shubbe.me (подробно — home-server/docs/packages.md). Один раз подключить репозиторий:

sudo curl -fsSL -o /etc/apt/keyrings/shubbe.asc https://git.shubbe.me/api/packages/eva/debian/repository.key
echo "deb [signed-by=/etc/apt/keyrings/shubbe.asc] https://git.shubbe.me/api/packages/eva/debian trixie main" \
  | sudo tee /etc/apt/sources.list.d/shubbe.list
sudo apt update
sudo apt install wallpaper-zones

Дальше обновления приходят с обычным apt upgrade. Из домашней сети git.shubbe.me открывается, только если в /etc/hosts есть 192.168.10.232 git.shubbe.me.

После установки выйти из сеанса и войти снова — или выполнить от своего пользователя wallpaper_zones_setup. Он добавляет то, что пакет не может положить в систему: пункты «Claude» в ~/.config/Thunar/uca.xml, терминал по умолчанию XFCE (~/.config/xfce4/helpers.rc) и ярлык на рабочем столе. При входе он срабатывает один раз; старую установку из ~/.local (через install.sh) он убирает сам. sudo apt remove wallpaper-zones убирает и эти настройки; разметка в ~/.config/wallpaper_zones остаётся.

Нужен Claude Code: curl -fsSL https://claude.ai/install.sh | bash, потом один раз claude и вход в аккаунт (для Remote Control — через claude.ai, не API-ключ).

Собрать пакет локально: packaging/build-deb.sh → dist/wallpaper-zones_<версия>_all.deb.

Запуск Claude

  Правый клик по папке в Thunar -> «Claude»
      откроется терминал, и в нём Claude Code в этой папке.

  Правый клик по пустому месту рабочего стола -> «Claude»
      Claude откроется в папке той зоны, где был клик
      (если у зоны нет своей папки — в «папке по умолчанию»).

  «Claude (Remote Control)» — то же, но в терминале появится ссылка и QR-код.
      Открой ссылку на телефоне (или в приложении Claude / на claude.ai/code),
      и можно писать Claude оттуда. Работает, пока открыт терминал на компьютере.

  Правый клик по рабочему столу -> «Открыть терминал здесь» (Open Terminal Here)
      терминал откроется в папке той зоны, где был клик, — той же, что у «Claude».
      Для этого wallpaper_zones_setup делает терминалом по умолчанию XFCE обёртку
      wallpaper_zones_terminal (Настройки -> Предпочтительные приложения -> Утилиты ->
      «Xfce Terminal (зоны рабочего стола)»). Обычные запуски терминала
      (Ctrl+Alt+T, «Открыть терминал здесь» в Thunar, меню) работают как раньше.
      Если выбрать там другой терминал, на рабочем столе снова будет ~/Desktop.

Разметка зон

  Открой «Зоны рабочего стола». При первом запуске экран уже поделён
  на 4 четверти (папки ~/Claude/red, blue, green, yellow) — их можно переделать.

  Окно открывается во весь экран, и картинка в нём совпадает с рабочим столом
  точка в точку. Кнопки — в панели, которая выезжает, если увести мышь к самому
  верхнему краю экрана; уведёшь мышь вниз — панель спрячется. При открытии окна
  панель показывается на пару секунд и сама уезжает наверх. Цвет панели
  берётся из обоев: оттенок их преобладающего цвета, затемнённый так, чтобы
  белый текст хорошо читался. Подсказки всплывают, если задержать мышь на кнопке
  (на «Зоны» / «Значки» — список всех действий мышью). Точка на «Применить •»
  значит, что есть несохранённые изменения. «Не сохранять» в панели или Esc —
  закрыть окно без сохранения (если есть правки, редактор переспросит:
  «Не сохранять» / «Продолжить»). Alt+F4 — закрыть с вопросом «Сохранить?».

  Картинка…        — выбрать картинку для обоев (PNG, JPEG, WebP, AVIF, HEIC,
                     GIF, BMP, TIFF, SVG и др.)
  Кнопка с папкой  — папка по умолчанию: её получает каждая область без своей
                     папки (в том числе только что созданная)
  Названия         — впечатать имена папок в обои
  Применить        — поставить обои, сохранить разметку и закрыть окно
                     (Ctrl+S — то же, но окно остаётся открытым)

  Разметка — это сетка из точек и рёбер; зона — область, ограниченная рёбрами.

  Клик по зоне                      — выбрать для неё папку
  Двойной клик по пустому месту     — новая точка, соединённая с двумя
                                      ближайшими; она едет за мышкой до клика
  Клик по точке                     — переместить её (до следующего клика);
                                      можно и просто перетащить
  Двойной клик по точке             — удалить точку и её рёбра
  Двойной клик по ребру             — удалить ребро, соседние зоны сливаются
  Правый клик по точке, потом клик
  по другой точке                   — провести между ними ребро
  Esc                               — отменить перемещение / новое ребро;
                                      если отменять нечего — закрыть
                                      без сохранения
  Ctrl+Z                            — отменить последнее действие

  Подсказки:
  - Углы экрана — неподвижные точки, их нельзя удалить или сдвинуть.
  - Точку у края экрана притягивает к краю; точка на краю двигается вдоль него.
  - Точку, отпущенную рядом с другой, притягивает к ней, и точки сливаются.
  - Если рёбра пересеклись, на пересечении сама появится точка.
  - Зона без своей папки подписана курсивом именем папки по умолчанию.
    В меню зоны: «Другая папка…» — выбрать свою, «Новая папка…» — придумать
    имя (и выбрать, где её создать): папка создастся при «Применить»,
    «По умолчанию» — вернуть.

Значки рабочего стола

  В «Зонах рабочего стола» переключись на «Значки» (кнопка слева вверху).
  Редактор покажет значки с рабочего стола на тех же местах, что и на экране,
  поверх обоев и зон, с сеткой клеток.

  Перетащить значок            — в другую клетку; на занятую — значки меняются
                                 местами
  ПКМ по значку                — что это за значок; у ссылки — «Убрать с
                                 рабочего стола» (удаляется только ссылка),
                                 у ярлыка приложения — то же (файл ярлыка
                                 уходит в корзину, программа остаётся)
  ПКМ по пустой клетке         — положить сюда ссылку на файл или папку
  «Добавить…»                  — окно выбора: можно выделить и файлы, и папки
                                 (ничего не выделено — добавится открытая папка);
                                 место на столе выберется само
  «Приложение…»                — ярлык любой программы из меню: список
                                 с поиском (Enter или двойной клик — добавить)
  ПКМ по пустой клетке         — «Ярлык приложения…»: ярлык встанет сюда
  Перетащить файлы из Thunar   — в окно редактора: ссылки встанут, куда бросил
  Размер значков               — чем меньше значки, тем мельче сетка
  Ctrl+Z                       — отменить; «Применить» — сохранить и закрыть,
                                 Ctrl+S — сохранить, не закрывая

  Подсказки:
  - Файлы добавляются ССЫЛКОЙ: в папке рабочего стола появляется ярлык
    (symlink), а сам файл остаётся, где был. Новые ссылки помечены зелёным «+»
    и создаются только по «Применить».
  - Ярлык приложения — копия его файла .desktop в папке рабочего стола,
    сразу помеченная как доверенная: XFCE не спросит «запускать ли».
  - Значки встают только в клетки — так устроен рабочий стол XFCE, свободной
    расстановки он не умеет.
  - При «Применить» рабочий стол на секунду перезапускается (xfdesktop):
    по-другому места значков сохранить нельзя.
  - Настоящие файлы, лежащие на рабочем столе, редактор только переставляет —
    удалять их он не умеет и не будет (кроме ярлыков приложений, и те —
    только в корзину).
  - В режиме «Зоны» значки тоже видны (с несохранёнными правками), чтобы было
    понятно, как они лягут на зоны; двигать их можно только в «Значках».

Если что-то не работает

  Claude открывается не в той папке при клике по рабочему столу:
      проверь, что запущен трекер правого клика:
          pgrep -af wallpaper_zones_tracker
      если нет — выйди из сеанса и зайди снова (он стартует автоматически)
      или запусти wallpaper_zones_setup.

  «Открыть терминал здесь» на рабочем столе открывает ~/Desktop, а не зону:
      проверь терминал по умолчанию:
          grep TerminalEmulator ~/.config/xfce4/helpers.rc
      должно быть  TerminalEmulator=wallpaper_zones_terminal  (иначе — wallpaper_zones_setup)

  Какая папка у точки экрана:
          wallpaper_zones lookup X Y 1920 1080

  «Зоны рабочего стола» не открываются, в терминале — «Не найден PySide6»:
      редактор написан на Qt; поставь его пакеты (или переустанови пакет):
          sudo apt install python3-pyside6.qtwidgets qt6-svg-plugins

  Терминал открывается, но пишет «claude: команда не найдена»:
      Claude Code не установлен или не в PATH — см. «Требования».

  Разметка хранится в:  ~/.config/wallpaper_zones/config.json
  Места значков (их пишет сам XFCE):  ~/.config/xfce4/desktop/icons.screen0.yaml

  После «Применить» в режиме «Значки» пропал рабочий стол:
      запусти его вручную:   xfdesktop &