➤ Overview
Elysium is a modern desktop customization ecosystem built on top of Conky, designed with a modular architecture that emphasizes performance, flexibility, and ease of use. Its dynamic grid-based layout allows modules to be added, removed, or rearranged effortlessly, while the built-in runtime and automatic hot reload ensure that changes are applied instantly without restarting Conky.
Combined with the Elysium GTK Manager, configuring themes, layouts, and modules becomes simple and intuitive, making desktop customization faster, cleaner, and more enjoyable.
➤ Before You Proceed
Before installing Elysium, it is recommended to verify that your system is compatible. This helps ensure a smooth installation and the best desktop experience.
Compatibility Test
If you're new to Elysium or unsure whether your system is fully supported, try the lightweight Ely_test theme first. It provides a quick way to verify that Conky and your desktop environment are working correctly before installing the full package.
Display Server
Elysium is designed and tested for X11. While some desktop environments allow Conky to run under Wayland, visual behavior such as transparency, window stacking, and desktop integration may vary depending on your compositor.
Conky
For the best compatibility, install the conky-all package. It includes the Lua and Cairo features required by Elysium.
Once your system meets these requirements, you're ready to install Elysium.
System Dependencies
The Elysium installer verifies that all required software is available before installation begins. If any dependency is missing, the installation will stop and report which package needs to be installed manually.
➤ Download
Elysium Core is distributed as a premium package and includes the complete runtime, GTK Manager, installer, and all essential assets required to get started.
Additional modules are released separately and are available free of charge through my Pling Store. This allows you to expand your desktop with new widgets while keeping the core installation lightweight and modular.
By separating the core package from optional modules, Elysium remains easy to maintain, quick to update, and flexible enough to fit different desktop layouts and workflows.
➤ Requirements
Before installing Elysium, make sure the following packages are available on your system. The installer will verify these dependencies before installation and report any missing packages.
System Packages
Debian / Ubuntu
sudo apt install \
conky-all \
python3 \
python3-gi \
gir1.2-gtk-4.0 \
gir1.2-adw-1 \
curl \
jq \
fontconfig \
playerctlArch Linux
sudo pacman -S \
conky \
python \
python-gobject \
gtk4 \
libadwaita \
curl \
jq \
fontconfig \
playerctl
Optional: playerctl is only required if you want to use media player modules.
Note: All fonts required by Elysium are installed automatically by the installer, so no additional font installation is necessary.
➤ Installation
Installing Elysium only takes a few steps. The installer will automatically copy the required files, install fonts and icons, create the application launcher, and verify that the installation completed successfully.
1. Extract the Package
After downloading Elysium Core, extract the archive to any location you prefer.
2. Open a Terminal
Open the extracted Elysium folder, then right-click anywhere inside the folder and select Open in Terminal.
3. Run the Installer
Run the installer using the following command:
bash ./install.shThe installer will automatically:
- Check all required dependencies.
- Install the Elysium runtime.
- Install the GTK Manager.
- Install fonts and icons.
- Create the application launcher.
- Verify the installation.
4. Launch Elysium Manager
After the installation is complete, open Elysium Manager from your desktop's application menu to configure and launch Elysium.
You're Ready to Go!
Congratulations! Elysium has been successfully installed and is ready to use.
Launch Elysium Manager from your application menu to configure your desktop, manage modules, customize layouts, and start or stop Elysium whenever you need.
Ready to explore more? Continue with the Elysium Manager Guide to discover customization options, module management, themes, and other advanced features.
0 Comments