diff --git a/astro.config.mjs b/astro.config.mjs index 92aae807..f6811aea 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -139,6 +139,9 @@ export default defineConfig({ label: "Window Managers", items: [ { slug: "users/desktops/window-managers" }, + { slug: "users/desktops/window-managers/hyprland" }, + { slug: "users/desktops/window-managers/mangowc" }, + { slug: "users/desktops/window-managers/niri" }, { slug: "users/desktops/window-managers/sway" }, ], }, diff --git a/src/content/docs/Users/Desktops/window-managers/hyprland.mdx b/src/content/docs/Users/Desktops/window-managers/hyprland.mdx new file mode 100644 index 00000000..c72f6140 --- /dev/null +++ b/src/content/docs/Users/Desktops/window-managers/hyprland.mdx @@ -0,0 +1,32 @@ +--- +title: 'Hyprland' +lastUpdated: 2026-08-16T00:00:00Z +description: "Install and configure the Hyprland Wayland compositor" +license: "CC-BY-SA-4.0" +copyright: "Copyright © 2026 aerynOS Developers" +--- + +[Hyprland](https://hypr.land/) is a dynamic tiling Wayland compositor with a strong focus on customization, visual polish, and modern Wayland features. It is well suited to users who want a highly configurable tiling workflow. + +## Installing Hyprland + +Hyprland is available in the AerynOS repositories and can be installed with `moss`: + +```bash +sudo moss install hyprland +``` + +## Starting Hyprland + +After installation, select the Hyprland session from your display manager or start it from a TTY: + +```bash +start-hyprland +``` + +## Configuration + +Refer to the official Hyprland documentation: + +- [Getting started](https://wiki.hypr.land/Getting-Started/) +- [Configuration](https://wiki.hypr.land/Configuring/) diff --git a/src/content/docs/Users/Desktops/window-managers/index.mdx b/src/content/docs/Users/Desktops/window-managers/index.mdx index 1772bad6..e7022034 100644 --- a/src/content/docs/Users/Desktops/window-managers/index.mdx +++ b/src/content/docs/Users/Desktops/window-managers/index.mdx @@ -1,11 +1,13 @@ --- title: 'Window Managers' -lastUpdated: 2025-03-09T00:00:00Z -description: Lightweight window manager environments +lastUpdated: 2026-08-16T00:00:00Z +description: Install and configure lightweight window manager environments license: "CC-BY-SA-4.0" copyright: "Copyright © 2025 aerynOS Developers" --- import DirectoryList from '@components/DirectoryList.astro'; +AerynOS provides documentation for Hyprland, MangoWC, Niri, and Sway. Choose a window manager below for installation, startup, and configuration instructions. + diff --git a/src/content/docs/Users/Desktops/window-managers/mangowc.mdx b/src/content/docs/Users/Desktops/window-managers/mangowc.mdx new file mode 100644 index 00000000..9108f6ae --- /dev/null +++ b/src/content/docs/Users/Desktops/window-managers/mangowc.mdx @@ -0,0 +1,32 @@ +--- +title: 'MangoWC' +lastUpdated: 2026-08-16T00:00:00Z +description: "Install and configure the MangoWC Wayland compositor" +license: "CC-BY-SA-4.0" +copyright: "Copyright © 2026 aerynOS Developers" +--- + +[MangoWC](https://mangowm.github.io/) is a minimal Wayland compositor focused on simplicity and performance. + +## Installing MangoWC + +Install MangoWC with `moss`: + +```bash +sudo moss install mangowm +``` + +## Starting MangoWC + +After installation, select the MangoWC session from your display manager or start it from a TTY: + +```bash +mango +``` + +## Configuration + +Refer to the official Mango documentation: + +- [Quick start](https://mangowm.github.io/docs/quick-start/) +- [Configuration basics](https://mangowm.github.io/docs/configuration/basics/) diff --git a/src/content/docs/Users/Desktops/window-managers/niri.mdx b/src/content/docs/Users/Desktops/window-managers/niri.mdx new file mode 100644 index 00000000..16e094c2 --- /dev/null +++ b/src/content/docs/Users/Desktops/window-managers/niri.mdx @@ -0,0 +1,32 @@ +--- +title: 'Niri' +lastUpdated: 2026-08-16T00:00:00Z +description: "Install and configure the Niri Wayland compositor" +license: "CC-BY-SA-4.0" +copyright: "Copyright © 2026 aerynOS Developers" +--- + +[Niri](https://niri-wm.github.io/niri/) is a scrollable tiling Wayland compositor designed around horizontally scrollable workspaces. It provides a keyboard-driven workflow with a different paradigm from traditional tiling window managers. + +## Installing Niri + +Niri is available in the AerynOS repositories and can be installed with `moss`: + +```bash +sudo moss install niri +``` + +## Starting Niri + +After installation, select the Niri session from your display manager or start it from a TTY: + +```bash +niri-session +``` + +## Configuration + +Refer to the official Niri documentation: + +- [Getting started](https://niri-wm.github.io/niri/Getting-Started.html) +- [Configuration introduction](https://niri-wm.github.io/niri/Configuration%3A-Introduction.html) diff --git a/src/content/docs/Users/Desktops/window-managers/sway.mdx b/src/content/docs/Users/Desktops/window-managers/sway.mdx index e7492f67..0ee1a3d6 100644 --- a/src/content/docs/Users/Desktops/window-managers/sway.mdx +++ b/src/content/docs/Users/Desktops/window-managers/sway.mdx @@ -1,20 +1,43 @@ --- title: 'Sway' -lastUpdated: 2025-03-09T00:00:00Z -description: "Sway Wayland window manager" +lastUpdated: 2026-08-16T00:00:00Z +description: "Install and configure the Sway Wayland compositor" license: "CC-BY-SA-4.0" copyright: "Copyright © 2025 aerynOS Developers" --- -[Sway](https://swaywm.org/) is a dynamic tiling window manager designed as a drop-in replacement for i3, but built for Wayland. It offers a lightweight workflow that is well suited to machines where users prefer keyboard driven navigation over graphical shell integrations. +[Sway](https://swaywm.org/) is a dynamic tiling window manager designed as a drop-in replacement for i3, built for Wayland. It provides a lightweight, keyboard-driven workflow without relying on a full desktop environment. -### Installing Sway on AerynOS +## Installing Sway -Sway is currently packaged as a single minimal session that you can add to any existing AerynOS installation. Install the package set with `moss`: +Sway can be installed as a standalone compositor or with an AerynOS-provided minimal configuration and branding. + +### Base installation + +```bash +sudo moss install sway +``` + +### Optional AerynOS configuration and branding + +Install the minimal preconfigured setup and AerynOS branding with: ```bash sudo moss install pkgset-aeryn-sway-minimal sudo moss install branding-aeryn-sway ``` -After installation you can select the Sway session from your display manager, or start it directly from a TTY with `exec sway`. +## Starting Sway + +After installation, select the Sway session from your display manager or start it from a TTY: + +```bash +exec sway +``` + +## Configuration + +Sway uses a configuration format similar to i3. Refer to the official resources for full configuration details: + +- [Sway documentation](https://swaywm.org/docs/) +- [Sway wiki](https://github.com/swaywm/sway/wiki)