Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -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/mangowm" },
{ slug: "users/desktops/window-managers/niri" },
{ slug: "users/desktops/window-managers/sway" },
],
},
Expand Down
32 changes: 32 additions & 0 deletions src/content/docs/Users/Desktops/window-managers/hyprland.mdx
Original file line number Diff line number Diff line change
@@ -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/)
6 changes: 4 additions & 2 deletions src/content/docs/Users/Desktops/window-managers/index.mdx
Original file line number Diff line number Diff line change
@@ -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, MangoWM, Niri, and Sway. Choose a window manager below for installation, startup, and configuration instructions.

<DirectoryList/>
32 changes: 32 additions & 0 deletions src/content/docs/Users/Desktops/window-managers/mangowm.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: 'MangoWM'
lastUpdated: 2026-08-16T00:00:00Z
description: "Install and configure the MangoWM Wayland compositor"
license: "CC-BY-SA-4.0"
copyright: "Copyright © 2026 aerynOS Developers"
---

[MangoWM](https://mangowm.github.io/) is a minimal Wayland compositor focused on simplicity and performance.

## Installing MangoWM

Install MangoWM with `moss`:

```bash
sudo moss install mangowm
```

## Starting MangoWM

After installation, select the MangoWM 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/)
32 changes: 32 additions & 0 deletions src/content/docs/Users/Desktops/window-managers/niri.mdx
Original file line number Diff line number Diff line change
@@ -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)
35 changes: 29 additions & 6 deletions src/content/docs/Users/Desktops/window-managers/sway.mdx
Original file line number Diff line number Diff line change
@@ -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)