Разработчик Matthew Kosarek выпустил miracle-wm 0.10.0 — свежую версию мозаичного Wayland-композитора на базе Mir. Релиз усиливает систему WebAssembly-плагинов, добавляет shader pipeline для отдельных окон и экранов, улучшает совместимость с инструментами вроде wl-copy, xdg-desktop-portal-wlr и grimshot.
В версии 0.10 miracle-wm важную роль в оформлении рабочего стола играют плагины
miracle-wm 0.10.0 вышел 21 июня 2026 года и стал десятым релизом проекта до будущей версии 1.0.0. В официальных заметках автор пишет, что проект движется к стабильному выпуску, который ориентировочно планируется к концу года. Главная тема текущего обновления — расширение возможностей плагинов и более аккуратная интеграция с Wayland-инструментами, которые уже привычны пользователям Sway, wlroots-композиторов и современных Linux-окружений.
miracle-wm — это оконный менеджер и Wayland-композитор на базе Mir. По стилю работы он близок к i3 и Sway: окна можно раскладывать плиткой, управлять ими с клавиатуры, переносить между рабочими областями и сочетать плиточный режим с плавающими окнами. При этом проект делает ставку на анимации, визуальные эффекты и расширяемость через WebAssembly-плагины. Официальная страница проекта описывает miracle-wm как «hackable» Wayland window manager, то есть среду, которую можно глубоко настраивать и расширять без переписывания ядра композитора.
В релизе 0.10 разработчики сделали следующий практический шаг: плагины получили доступ к shader pipeline. Простыми словами, шейдеры позволяют менять то, как изображение окна или всего экрана проходит через графический конвейер перед выводом на монитор. Для пользователя это выражается в визуальных эффектах, ночном режиме, размытии активного или фонового содержимого и других сценариях, которые раньше требовали более жёсткой привязки к самому композитору.
Shader pipeline открывает дорогу к focus blur и nightlight
Самое заметное изменение miracle-wm 0.10 — возможность назначать shader pipeline на уровне отдельного окна. Благодаря этому появился плагин focus blur: он может применять эффект размытия к нужным окнам, сохраняя более гибкий контроль над визуальным поведением рабочего стола.
Вторая важная часть — output shader pipeline. Здесь речь идёт уже об обработке всего вывода на конкретный монитор. На этой основе появился nightlight-плагин, который может менять цветовую температуру изображения и делать экран комфортнее в вечернее время. Для обычного пользователя это похоже на ночной режим в популярных операционных системах, но реализованный через расширяемую систему miracle-wm.
Разница между оконным и экранным уровнем важна для разработчиков плагинов. Один тип шейдера подходит для эффектов вокруг конкретного приложения, другой — для фильтров, которые должны затрагивать весь монитор. В результате miracle-wm постепенно превращает плагины в полноценный механизм изменения поведения и внешнего вида среды.
WASM-плагины теперь загружаются автоматически из пользовательской папки
В miracle-wm 0.10 все .wasm-плагины автоматически подхватываются из каталога ~/.config/miracle-wm/plugins. Это снижает порог входа для пользователей, которые хотят попробовать расширения без ручной настройки каждого файла в конфигурации.
WebAssembly здесь используется как безопасный формат для запуска расширений. Плагин работает в более изолированной среде и может расширять композитор через заранее определённый API. В новом релизе этот API обновлён до версии 0.1.0, что важно для авторов сторонних расширений: старые экспериментальные плагины могут потребовать адаптации под новый интерфейс.
Автоматическая загрузка особенно полезна для будущей экосистемы расширений. Пользователь сможет положить WASM-файл в ожидаемую директорию, перезагрузить конфигурацию и быстрее проверить новый сценарий. Для проекта на раннем этапе это заметный шаг к более понятной модели распространения плагинов.
Новые Wayland-протоколы улучшают буфер обмена, скриншоты и порталы
miracle-wm 0.10 включает несколько Wayland-протоколов: ext_data_control_manager_v1, ext_image_copy_capture_manager_v1, ext_output_image_capture_source_manager_v1, ext_foreign_toplevel_list_v1 и zwp_input_method_v1. В официальных заметках отдельно указано, что это помогает wl-copy, xdg-desktop-portal-wlr и grimshot работать из коробки.
Для читателя без глубокого Linux-бэкграунда смысл простой: Wayland-композитор должен уметь договариваться с внешними программами о скриншотах, буфере обмена, списке окон, методах ввода и порталах рабочего стола. Если таких протоколов нет или они реализованы частично, привычные утилиты могут работать нестабильно, требовать обходных решений или вести себя иначе, чем в Sway и других окружениях.
wl-copy связан с копированием данных в буфер обмена. grimshot часто используют для создания скриншотов. xdg-desktop-portal-wlr нужен приложениям и Flatpak-средам для безопасного доступа к функциям рабочего стола. Поддержка этих компонентов делает miracle-wm удобнее для повседневной работы, особенно для тех, кто хочет экспериментировать с новым композитором без потери базовых сценариев.
GTK4-инструменты помогают находить ошибки конфигурации и отладки окон
В релиз добавлен визуальный GTK4-клиент для сообщений об ошибках конфигурации. Это полезно, когда пользователь меняет YAML-настройки и получает проблему в синтаксисе или параметрах. Вместо молчаливого сбоя появляется понятный визуальный сигнал, а сами ошибки транслируются через IPC-сокет miracle.
Ещё один новый инструмент — debug overlay на GTK4. Его можно вызвать командой miraclemsg debug overlay. Оверлей показывает информацию о позиционировании окон, input regions и других внутренних состояниях композитора. Для обычного пользователя это не ежедневная функция, а для разработчиков, тестировщиков и авторов баг-репортов — способ быстро понять, почему окно ведёт себя странно.
Такие инструменты обычно становятся особенно важными перед стабильными релизами. Когда проект приближается к версии 1.0.0, качество диагностики влияет на скорость исправления ошибок и на то, насколько уверенно пользователи смогут описывать проблемы разработчикам.
Исправления miracle-wm 0.10 затрагивают ввод, systemd-сессию и Snap-пакет
В miracle-wm 0.10 исправлена давняя проблема с «мёртвыми» input regions у окон. Input region — это область, в которой окно принимает ввод мыши или другого указателя. Если она определена неверно, пользователь может столкнуться с ситуацией, когда часть окна визуально видна, но клики по ней не срабатывают. Исправление делает поведение окон более предсказуемым.
Отдельный блок изменений связан с systemd-сессией. Snap-пакет теперь корректнее работает с графической systemd-сессией, а при падении miracle-wm сессия должна завершаться аккуратно. Это снижает риск зависших пользовательских сервисов и проблем после аварийного завершения композитора.
Также устранён конфликт LLVM из WasmEdge с llvmpipe, который мог приводить к пустому экрану при рендеринге. Для пользователя это звучит технически, но практический эффект понятен: меньше шансов получить чёрный или пустой экран из-за конфликта графических компонентов.
Мониторы без готовой конфигурации начинают работать сразу
В разделе прочих изменений разработчик отметил, что мониторы теперь становятся доступными сразу, даже если они отсутствуют в конфигурации. Раньше подобные ситуации могли создавать лишнюю ручную работу: подключил дисплей, а затем разбираешься, почему он не используется без явного описания в настройках.
Теперь новые или ранее неописанные мониторы должны включаться в работу быстрее. Для ноутбуков, док-станций, внешних экранов и тестовых стендов это заметное улучшение повседневного опыта. Особенно для Wayland-композитора, который хотят пробовать пользователи с разным оборудованием.
Ещё одно организационное изменение — перенос wiki из отдельного репозитория в основной репозиторий miracle-wm. Документация ближе к коду, а значит, её проще синхронизировать с изменениями проекта и релизами.
Версия 0.10 miracle-wm указывает на приближение к релизу 1.0
Версия 0.10 miracle-wm напоминает релиз, ориентированный на экспериментальные Wayland-композиторы. Она предлагает больше гибкости, чем традиционные плиточные среды. Основное новшество — это усовершенствованные плагины, которые теперь могут управлять визуальными эффектами окон и мониторов. Кроме того, улучшена совместимость с популярными Wayland-инструментами.
Miracle-wm всё ещё находится в стадии активного развития. Однако релиз 0.10 значительно улучшил его функциональность: скриншоты, буфер обмена, порталы, отладка, systemd-сессия и Snap-поставка получили заметные обновления. Если команда продолжит работать в том же духе, версия 1.0 может стать важным шагом вперёд для пользователей, ищущих современный плиточный Wayland-композитор с возможностью расширения через WebAssembly.
