If you can't pinpoint/see the error you can run au run --dev to get the full error message or alternatively run au log, then open a issue on Github or ask in our Discord

This issue can be caused by using an outdated version of Quickshell. Please make sure you have the latest version installed, which can be installed with the quickshell-git package.

Make sure Quickshell is installed and accessible in your $PATH. Try running quickshell --version to verify. If it's missing, follow the install guide for your distro.

This is usually caused by a missing or misconfigured Hyprland setup. Make sure you're running Aureli inside a Hyprland session. Also check that your hyprland.conf does not have conflicting exec-once entries for other bars or shells.

This typically means a component file is corrupted or a submodule wasn't initialized. Run:

git submodule update --init --recursive

inside the Aureli directory to fix missing submodules.

The au binary may not be in your $PATH. Try running:

export PATH="$PATH:/usr/local/bin"

or add it permanently to your shell config (~/.bashrc, ~/.zshrc, etc.).

Make sure your monitors are detected by Hyprland. Check hyprctl monitors to confirm. Another possibility is that your hyprland.conf does not launch Aureli, check if you are missing /usr/local/bin/au run in your exec-once section.

Install the Quickshell polkit agent and make sure no other polkit agent (like gnome-polkit or lxpolkit) is running at the same time, as they can conflict.

The easiest way is via the install script:

curl -fsSL https://eqsh-wiki.github.io/get | bash
au run

For a manual install, see the Install Guide.

Aureli works on any distro that can run Hyprland and Quickshell. Arch Linux is the most tested and recommended. NixOS, Fedora, and Guix are also supported via their respective Quickshell packages.

Yes — you need Hyprland and Quickshell installed first. Optionally, install the recommended icon and GTK themes for the full look.

Simply run:

au update aureli

Then restart with au restart.

Git is required for the manual install and updates. The curl install script handles everything for you, but Git is still used under the hood.

By default, Aureli is installed to ~/.local/share/equora/eqsh/.

Remove the install directory and the au binary:

rm -rf ~/.local/share/equora/eqsh
sudo rm /usr/local/bin/au

You can change your Wallpaper inside the system settingsCTRL+Super+R or run au settings under the wallpaper section

Yes! You can change the wallpaper folder using au set wallpaper.folder /home/yourName/wallpapers

By running au set wallpaper.path /home/yourName/wallpapers To get your current one run au get wallpaper.path

The default wallpapers are located at ~/.local/share/equora/wallpapers/

Press CTRL+Super+R or run au settings from a terminal.

The user settings file is stored as JSON at ~/.config/aureli/config.json. You can edit it manually or use au set and au get from the terminal.

You can do that by using the cli:

au reset [setting e.g. wallpaper.folder]
au restart # Very important

Open the Settings app (CTRL+Super+R) and navigate to the Appearance section, where you can pick a custom accent color.

Yes, open Settings > Dock and toggle it off, or run:

au set dock.enabled false

As of now we don't support that. :(

You can open the Launchpad from the cli au launchpad or by pressing the configured keybind (default: CTRL+Super+P).

Click the Sigrid icon in the panel to open the AI chatbot panel. Sigrid uses a local or configured AI backend to answer questions directly from your desktop.

Use the built-in screenshot tool via the keybind Super+Shift+5, or use the cli au msg screenshot open.

Open the Widget Picker from the desktop and drag widgets onto your desktop. Widgets can be repositioned and resized freely.

Notifications appear as popups and are collected in the notification center. Click the date and time to view the center.

The notch is a macOS-inspired interactive element at the top center of your screen. It houses quick controls, app shortcuts, media info, and more. Click or hover it to expand.

Aureli exposes an IPC interface for launching popups from scripts or other apps. go to Development > Popup.

Yes. Aureli renders the panel and notch on each connected monitor.

The system tray lives in the panel and auto-discovers tray icons from running apps via the StatusNotifierItem protocol. No manual configuration is needed.

Kavo (.kvo) is the declarative, hierarchical format used for Aureli plugins. It lets you define components, properties, event handlers, and widgets in a human-readable structure.

Place your .kvo plugin files in ~/.config/aureli/plugins/. Aureli will detect and load them on the next restart.

A minimal plugin defines a metadata section and at least one widget or event handler in Kavo format. See the Plugin documentation for more.

Yes. Plugins can use built-in Kavo functions and event hooks to read system state such as battery level, network status, and running processes.

Run au plugin reload to hot-reload plugins without a full restart. Note that some plugin types may still require a full restart.

Yes — plugins are self-contained .kvo files. You can share them directly or publish them to the community repository.

MacTahoe Icon Theme is the recommended icon theme for the full Apple-inspired look.

MacTahoe GTK Theme pairs perfectly with Aureli's visual style.

You can set the GTK theme using gsettings:

gsettings set org.gnome.desktop.interface gtk-theme "MacTahoe"

Yes. Toggle between light and dark mode in Settings > Appearance, or run:

au set general.darkMode false

Some common defaults:

• CTRL+Super+R — Open Settings
• CTRL+Super+P — Open App Drawer
• CTRL+Super+Q — Lock screen
• Super+Shift+5 — Screenshot tool

Edit the relevant entry in ~/.config/hypr/Keys/customkeys.conf.

Press CTRL+Super+Q or run au lock from the terminal.

Aureli is a next-generation desktop shell for Hyprland — providing a panel, notch, lockscreen, wallpaper engine, app drawer, notifications, widgets, AI chatbot, and more, all in one polished package.

Yes. Aureli is released under the Apache 2.0 License. You are free to use, modify, and distribute it as long as changes remain open source.

Quickshell is the QML-based shell toolkit that Aureli is built on top of. It handles rendering and IPC.

No. Aureli is an independent open-source project. The Apple-inspired aesthetic is a design choice only — there is no affiliation with Apple Inc.

• Open an issue on GitHub
• Join the Discord
• Read the Wiki

Fork the repository, make your changes, and open a pull request on GitHub. Contributions of all kinds — code, docs, themes, plugins — are welcome.

Yes. Aureli is built specifically for Hyprland, which is a Wayland compositor. X11 is not supported.

Yes. We already support Hyprland and Niri, but some features are not yet supported in Niri.