Skip to content
AxOS Docs

Sleex

Sleex

Sleex (based on Hyprland) is the third desktop environment for AxOS. It is the most aesthetic and feature-rich desktop environment of the 3. It has a lot of features, smooth animations and a lot of cool stuff.

In this page, you will learn how to use Sleex, how to customize it and how to fix some common issues.

Installation

When installing AxOS, you can choose Sleex as your desktop environment. If you didn’t choose it during the installation, you can install it by running the following command:

Terminal window
epsi i sleex

or

Terminal window
epsi install sleex

You can also install it with pacman.

To install Sleex on another arch-based os, follow the instructions on the README of the github page.

Keybinds

Like Calla, it is a tiling window manager, so you can manage your windows with a keyboard. It is also better if used with keybindings, so you can manage your windows with a keyboard. You can find them by pressing Super + F1. If you need, you can add keybinds in the ~/.config/hypr/custom/keybinds.conf file. The configuration method can be found in the Hyprland documentation

Widgets

Sleex has a built-in widget system. You can add, remove and change the code of these in /usr/share/sleex/. You can also add your own widgets by creating a new file in this folder and editing /usr/share/sleex/shell.qml.

Bar

The bar is the top bar of Sleex. Several modules can be found on it.

  • The title module, named spaceleft shows the process’s title (big and white) and the process class/id (small and grey). Scroll on it to change the screen brightness.
  • The resources module shows the current usage of CPU, SWAP and RAM. If the percentage is over 90%, it turns orange.
  • The Workspace module shows the workspaces, if they’re used and the primary app of each. It can be customized in the settings app to show numbers, show the icons, and others.
  • The clock module shows the date and time. The formats can be changed in the settings app.
  • The tray module shows the applications tray. It can be opened with a right click.
  • The system icons module, named sideright, shows dynamic icons such as the mute status, bluetooth status and connected device, the wifi strenght and, if compatible, the battery. Scroll on it to change the audio volume, middle click to mute and right click to go to the next track if something is playing.

Dashboard

The dashboard is a widget with several modules. You can open it by clicking on the right side of the bar, or by pressing Super + D.

Home tab

In the home tab, you will find simple display elements:

  • User greeting, because we are polite. You must set the profile icon in the settings app.
  • Clock. Well, do I need to explain ?
  • Contribution number using the github API. Add your username in the settings app.
  • Notification center with the list of notifications. Click on the arrow to expand them. There is also a button to enable DnD, so you won’t get notification popups.
  • Music controller to control the music. Surprising, isn’t it ?
  • Weather module based on your current location according to your public IP.
  • Calendar that doesn’t do much…

Todo tab

It’s a simple todo list, nothing more nothing less

AI panel

The AI panel (called sidebarLeft) is a panel where you can use LLMs with your API keys.

Note: Sleex is not affiliated with any of the providers included in the sidebarLeft.

Desktop

On the desktop, you can find:

  • A discrete watermark at the bottom right (that can be disabled in the settings app)
  • A desktop clock, that can be moved, toggled and themed (dark or light) in the settings app.

Dock

The dock is a widget where you can pin apps to access them rapidely.

When an app is open, the icon shows at the right of it. If you right click on it, the app will be pined and will be there even if it is not opened.

Overview

The overview is a widget where you can see the current workspaces and the apps of each workspaces.

This widget is also an app launcher. Search for the app you want to open, then press enter or click on it. The search bar is also a calculator, a web search and a convertor.

Settings

The settings app is a primary element of Sleex. On It, you can find multiple tabs with different functions:

  • The Appearence tab is to configure simple elements such as the wallpaper, the color scheme and the light/dark mode.
  • The Interface tab is to configure the sleex shell elements.
  • The Behavior tab is to configure some shell backend / system elements.
  • The Bluetooth tab is to configure bluetooth and connect devices.
  • The About tab contains basic infos about AxOS and Sleex.

Developers

You want to contribute to the developement of Sleex? Cool! here are some things you might want to know:

  • The code of the sleex shell is located in /usr/share/sleex/. You can also find it on the github repository: Sleex
  • The Sleex interface and widgets are made with Quickshell.

Pull requests are really appreciated! If you have any question, you can ask them on the AxOS Discord server.