Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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/mangowc" },
{ 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`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Hyprland is available in the AerynOS repositories and can be installed with `moss`:
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, MangoWC, Niri, and Sway. Choose a window manager below for installation, startup, and configuration instructions.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
AerynOS provides documentation for Hyprland, MangoWC, Niri, and Sway. Choose a window manager below for installation, startup, and configuration instructions.
aerynOS provides documentation for Hyprland, MangoWC, 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/mangowc.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: 'MangoWC'

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: 'MangoWC'
title: 'MangoWM'

lastUpdated: 2026-08-16T00:00:00Z
description: "Install and configure the MangoWC Wayland compositor"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: "Install and configure the MangoWC Wayland compositor"
description: "Install and configure the MangoWM 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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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


## Installing MangoWC

Install MangoWC with `moss`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Install MangoWC with `moss`:
Install MangoWM 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:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
After installation, select the MangoWC session from your display manager or start it from a TTY:
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`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Niri is available in the AerynOS repositories and can be installed with `moss`:
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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Sway can be installed as a standalone compositor or with an AerynOS-provided minimal configuration and branding.
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:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Install the minimal preconfigured setup and AerynOS branding with:
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)