noctalia README

The project's README from github.com/noctalia-dev/noctalia. As one markdown file: README.md.

Noctalia

Noctalia is a native Wayland desktop shell for people who want a polished, configurable Linux desktop without stitching together a separate bar, launcher, notification daemon, lock screen, wallpaper tool, and settings UI.

It provides the shell layer around your compositor: bars, widgets, dock, launcher, control center, notifications, wallpaper, lock screen, session actions, clipboard history, OSDs, tray integration, and desktop widgets. The project is built directly on Wayland and OpenGL ES with no Qt or GTK dependency, so the UI, rendering, configuration, and IPC model are designed as one cohesive shell instead of a collection of unrelated panels and scripts.


Noctalia Logo

Install Noctalia


Last commit GitHub stars Documentation Discord

Why Noctalia?

Most Wayland setups leave the desktop shell to a stack of small tools: one bar, another launcher, another notification daemon, a lock screen, a wallpaper daemon, scripts for session actions, and separate config formats for each piece. That can be flexible, but it also makes a complete desktop feel fragile and hard to keep visually consistent.

Noctalia solves that by providing one configurable shell layer that owns the common desktop surfaces and services while still fitting into compositor-driven Wayland workflows. It is meant for users who want the control of a custom desktop environment with fewer moving parts and a consistent UI.

To understand the values and philosophy guiding the project, read our ethos.

What It Includes

Wayland Compositor Support

Noctalia supports Wayland compositors that provide the layer-shell protocols it needs for shell surfaces. Workspace integration works through compositor-native backends where needed, or through ext-workspace-v1 on compositors that implement it.

Current compositor integrations include Niri, Hyprland, Sway, Scroll, Mango, Labwc, Triad, dwl, and other compatible Wayland compositors. Other compositors may run Noctalia but can have reduced workspace, window, output, or session-action integration depending on the protocols and IPC they expose.

Scope

Noctalia is a desktop shell, not a full desktop environment. It provides the visual and service layer around your Wayland compositor: bars, panels, launcher, notifications, dock, lock screen, idle behavior, OSDs, theming, wallpapers, desktop widgets, and multi-monitor shell surfaces.

Window management, tiling, compositor configuration such as monitor arrangement and positions, file management, removable-drive mounting, printers management, and screen mirroring/casting belong to the compositor, dedicated desktop applications, or system services.

Display/login greeter support lives in the separate Noctalia Greeter project. Noctalia may integrate with those pieces when useful, but it does not replace them.

Core Noctalia is non-invasive: it does not manage your compositor settings or take over your dotfiles. Compositor-specific controls can be provided as opt-in plugins rather than becoming core shell behavior.

The plugin system is available for user-installed extensions. Features that are useful to some users but not essential to the core shell can live there: extra bar widgets, launcher providers, desktop widgets, panels, shortcuts, background services, compositor-specific extras and controls, hardware-specific controls, and third-party service integrations.

Build from source

Source dependencies, distro-specific package commands, build modes, and install layouts live in BUILDING.md.

Configuration

A ready-to-use starting config with all defaults is at example.toml. The full configuration reference lives in the documentation site. The source MDX files are in docs/user/; sync them to a local docs checkout with tools/sync-docs.sh.

Contributing

Developer notes, architecture overview, code style, project layout, and debugging commands live in CONTRIBUTING.md.

Bug reports, fixes, documentation updates, themes, and configuration examples are welcome. For general help and design discussion, join the community on Discord.

Credits

Thank you to the contributors and community members who test Noctalia, report issues, share configurations, and help shape the project.

Donations

Donations are appreciated but completely optional.

Buy Me a Coffee Ko-fi

License

MIT License. See LICENSE for details.

Packaging

Distro packaging notes (description, deps, install layout, Meson options) live in PACKAGING.md.

Star History

Star History

noctalia (noctalia-dev/noctalia)

Searching Database…

11.4K ·GitHub
Noctalia
Что это?Noctalia — это нативная оболочка рабочего стола для Wayland, предоставляющая панели, лаунчер, док, центр управления, уведомления, выбор обоев, экран блокировки, OSD, трей и виджеты рабочего стола одним цельным пакетом вместо отдельных инструментов.
Это полноценная среда рабочего стола или что-то иное?Это слой оболочки рабочего стола, а не полноценная DE: управление окнами, тайлинг, настройка композитора, управление файлами и монтирование дисков оставлены композитору или другим приложениям. Он построен непосредственно на Wayland/OpenGL ES без зависимости от Qt или GTK.
Как его установить и настроить?Соберите из исходников, используя зависимости и команды для конкретного дистрибутива из BUILDING.md, или используйте пакетную сборку согласно PACKAGING.md. Конфигурация хранится в TOML-файле, готовый стартовый конфиг — в example.toml, с поддержкой горячей перезагрузки.
С какими Wayland-композиторами он работает?Нужен Wayland-композитор с протоколами layer-shell. Текущие интеграции включают Niri, Hyprland, Sway, Scroll, Mango, Labwc, Triad и dwl.
Будет ли он одинаково работать на любом Wayland-композиторе?Другие композиторы могут его запускать, но с урезанной интеграцией рабочих пространств, окон, выводов или действий сессии — в зависимости от того, какие протоколы и IPC они предоставляют.
Для кого это?Для пользователей Linux на Wayland (особенно со связками Niri/Hyprland), которым нужна согласованная, настраиваемая оболочка рабочего стола с меньшим числом движущихся частей, чем при сборке из отдельных инструментов панели/лаунчера/уведомлений.
Можно ли расширить его кастомными функциями сверх стандартных?Да, есть система плагинов для пользовательских расширений: дополнительные виджеты панели, провайдеры лаунчера, виджеты рабочего стола, панели и элементы управления под конкретный композитор или оборудование.
А как насчёт экрана входа?Им занимается отдельный проект, Noctalia Greeter, а не ядро Noctalia.
Управляет ли он настройками моего композитора или dotfiles?Нет, Noctalia ненавязчива и не управляет настройками композитора и не забирает ваши dotfiles себе; элементы управления под конкретный композитор — это опциональные плагины.
Где найти полный список опций конфигурации?Полный справочник по конфигурации опубликован на сайте документации, исходные MDX-файлы лежат в docs/user/ и могут быть синхронизированы локально через tools/sync-docs.sh.
What are similar projects?shell, serpantinum, dots-hyprland, strata, omarchy, AgentOS, omarchy-workspace-layout, omarchy-lock-explorer
Which topics is it in?hyprland, wayland, theme, customization, c++, productivity, gui, desktop-app, self-hosted, cross-platform, mit, linux
Creator
noctalia-dev
Size
120.6 MB
Stars
11.4K
Updated
CommitOct 18Releasev5.3.0Oct 15
Age
1y
Commits · 90 Days