Morghulis

Get Started

Installation Guide

Morghulis is a Wayland desktop shell built with GTK4, Libadwaita and Astal. Install the requirements, then grab it from the AUR or build it from source.

Requirements

  • Compositor

    River or Hyprland

  • Build tools

    Vala, Meson, Just, Blueprint-Compiler

  • Toolkit

    GTK4, gtk4-layer-shell, Libadwaita and the Adwaita theme

  • Astal

    Tray, Wireplumber, Mpris, NotifD, Network, Bluetooth, Apps, Battery, Power Profiles, plus River or Hyprland

  • Libraries

    GSound, libgtop, muparser, CMark, JsonGLib, libsoup, libportal

The River and Hyprland Astal modules are optional when building from source; the binary release needs everything.

Install

Arch Linux

  1. Install from the AUR with any helper:
    yay -S morghulis-git
  2. Run it:
    morghulis --help

Prefer the latest release binary? Use the morghulis-bin PKGBUILD.

From source

  1. Clone the repository:
    git clone https://github.com/ARKye03/morghulis
    cd morghulis
  2. Set up the build and install:
    just init
    just install
A screenshot of the Morghulis desktop environment

After installing

  • Launch it

    Start morghulis from your River or Hyprland session. Run morghulis --help for the CLI commands that toggle windows and open the inspector.

  • Backlight

    Add your user to the video group to use backlight services.

  • On-screen display

    Append morghulis -r change_volume or morghulis -r change_brightness to your volume and brightness keybindings, for example in Hyprland:

    binde=, XF86MonBrightnessUp, exec, brightnessctl set +10% & morghulis -r change_brightness
  • Customize

    Restyle the shell with your own CSS. See the configuration guide.

Frequently Asked Questions

Installation fails with a dependency error. What do I do?
A library from the requirements list is missing. Building from source needs every listed library, including the Astal modules; only the River and Hyprland Astal modules are optional.
How can I have the bar at the top?

Either run gsettings set com.arkye.morghulis navbar-anchor "top" or change it in the Quick Menu, then reload Morghulis.

Brightness controls or the brightness OSD do nothing.
Your user must be in the video group to use backlight services, and the OSD only shows when your keybinding also runs morghulis -r change_brightness.
Does Morghulis work with NVIDIA proprietary drivers?
Yes, Morghulis is compatible with NVIDIA proprietary drivers. Make sure you're running the latest driver version for the best experience. Some Wayland-specific features may require driver version 495 or newer.