-
-
Notifications
You must be signed in to change notification settings - Fork 10
Add new window manager documentation #129
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| 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/) | ||
| 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. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| <DirectoryList/> | ||||||
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,32 @@ | ||||||
| --- | ||||||
| title: 'MangoWC' | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
| lastUpdated: 2026-08-16T00:00:00Z | ||||||
| description: "Install and configure the MangoWC Wayland compositor" | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
| 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. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ## Installing MangoWC | ||||||
|
|
||||||
| Install MangoWC with `moss`: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ```bash | ||||||
| sudo moss install mangowm | ||||||
| ``` | ||||||
|
|
||||||
| ## Starting MangoWC | ||||||
|
|
||||||
| After installation, select the MangoWC session from your display manager or start it from a TTY: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ```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/) | ||||||
| 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`: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ```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) | ||||||
| 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. | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ### Base installation | ||||||
|
|
||||||
| ```bash | ||||||
| sudo moss install sway | ||||||
| ``` | ||||||
|
|
||||||
| ### Optional AerynOS configuration and branding | ||||||
|
|
||||||
| Install the minimal preconfigured setup and AerynOS branding with: | ||||||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ```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) | ||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.