Skip to content


Hyprland is a dynamic tiling Wayland compositor based on wlroots that doesn’t sacrifice on its looks. Note: it’s in beta.

In Athena OS, Hyprland has been been set up to make the user experience smoother in a window manager environment.

It doesn’t work in virtual machines out of the box, so it is suggested to use it on bare metal.

Athena’s Hyprland config is based on the wonderful dotfiles from @end-4.


The environment consists of several applications distributed between the top bar and the desktop environment.

Top Bar

Hyprland Top Bar From left to right, we have

  • Focused window title
  • RAM usage (Swap and CPU will be shown when there’s no playing media)
  • Media title
  • Workspace indicator: Displays focused and occupied workspaces. Scroll to switch between them.
  • Time & date
  • Utility buttons + battery indicator (on a desktop with no battery, these two widgets are replaced with a weather widget)
  • Other status indicators: System tray, Network, Bluetooth (and connected Bluetooth devices)

The media controls in the middle can be opened by clicking the media title on the bar or hitting Super+M


While they’re pretty self-explanatory, we have:

  • Left sidebar: AI assistants: Gemini and ChatGPT (and other bots with compatible API) (API key required, but it’ll guide you)
  • Right sidebar:
    • Quick settings, like wifi/bluetooth toggles
    • Notifications
    • Calendar and To-Do list


A clean desktop view looks like this:

Hyprland Desktop

Typically, you launch apps either using the terminal or the launcher. With default keybindings:

  • Hit Super+Enter to spawn a terminal
  • Hit Super for the overview/launcher
    • This shows you open apps across workspaces
    • To search for apps, simply start typing. Use arrow keys to pick your desired app and hit Enter

Hyprland Activity Overview

Hyprland App Search


Power Settings

You can change the inactivity duration after which the system will be locked by editing ~/.config/hypr/hypridle.conf Edit the lines that say timeout=NUMBER. The number is in seconds.

For example, if you want your device to sleep after 15 minutes, the listener entry for it should look like this:

listener {
timeout = 900 # = 15 × 60 seconds
on-timeout = $suspend_cmd


Changing wallpaper

  • Hit Super to open the launcher and type in >img. A popup will show up, allowing you to select an image.
    • The color of shell elements will change according to the chosen wallpaper


To configure your environment, take a look at these directories:

  • ~/.config/hypr: Config files for Hyprland and its utilities
    • hyprland
      • env.conf: Environment variables
      • execs.conf: Programs to run at startup
      • keybinds.conf: Keybinds
      • general.conf: General behavior
    • hypridle.conf: Power settings, as mentioned above
    • hyprlock.conf: Lock screen
  • ~/.config/ags: AGS stands for “Aylur’s Gtk Shell”. This folder contains the config of shell elements like bars and sidebars. Normal users would want to edit user_options.js, while advanced users might want to edit the code in there.
  • ~/.local/bin: Contains scripts and possibly binaries



To view them any time, hit Super + /. Here are some common ones:


Super + COpen VSCodium (editor)
Super + EnterOpen the Terminal
Super + TOpen Foot (terminal)
Super + EOpen the File Manager
Super + WOpen the Browser


Super + QClose the active window
Super + Ctrl + VOpen pavucontrol
Ctrl + Shift + EscapeOpen GNOME System Monitor
Super + Shift + Alt + STake screenshot and open the image editor. Files will be saved in Desktop
PrintTake screenshot and copy it in clipboard
Super + Shift + STake screenshot and copy it in clipboard
Super + Alt + RToggle recording desktop
Ctrl + Alt + RToggle recording desktop with audio
Super + Shift + Alt + RToggle recording desktop on fullscreen
Super + VShow clipboard content
Super + Shift + CRun Hyprpicker
Super + Ctrl + TSwitch wallpaper
Super + KShow virtual keyboard
Super + LLock screen
Super + Ctrl + RReset AGS
Super + TabToggle View
Super + MToggle Music Popup
Super + NToggle Sidebar
Ctrl + Alt + DeletePower menu
Ctrl + Shift + Alt + DeleteLogout
Super + Ctrl + Shift + Alt + DeletePower off

Windows and Workspaces

Super + DMaximize active window
Super + Shift + Alt + SpaceToggle floating
Super + Shift + LeftMove window to left
Super + Shift + RightMove window to right
Super + Shift + UpMove window to up
Super + Shift + DownMove window to down
Super + LeftMove focus to left
Super + RightMove focus to right
Super + UpMove focus to up
Super + DownMove focus to down
Super + Ctrl + LeftMove to the previous workspace
Super + Ctrl + RightMove to the next workspace
Super + Ctrl + Shift + LeftMove the active window to the previous workspace
Super + Ctrl + Shift + RightMove the active window to the next workspace
Super + ScrollDownMove to the previous workspace
Super + ScrollUpMove to the next workspace
Super + Ctrl + Shift + ScrollDownMove the active window to the previous workspace
Super + Ctrl + Shift + ScrollUpMove the active window to the next workspace
Super + FSwitch active window to fullscreen
Super + <N>Switch to the workspace <N> where N is a number (Super+0 switches to workspace 10)
Alt + TabSwitch focus among windows
Super + LeftMouseButtonDrag the window

Other keybindings can be found in ~/.config/hypr/keybindings.conf

Side Installation

To install Athena OS Hyprland environment on side of an existing environment, run:

Terminal window
sudo pacman -S athena-hyprland-config
dconf load /org/gnome/desktop/ < /usr/share/athena-hyprland-config/dconf-desktop.ini

Then reboot. On Login Manager, select Hyprland session and login.

If your theme is not correctly displayed, run athena-theme-tweak to set or change the current environment theme.