Elysium Project — Modular Desktop Redefined

➤ Overview

Elysium is a modern Conky theme built with a modular approach, focusing on performance, flexibility, and aesthetics. Designed with a structured grid system, each component can be easily arranged without complex configuration, providing a fast, efficient, and consistent customization experience. Changes are applied automatically without manual restarts.

Default Elysium layout

➤ Before You Proceed

Before purchasing Elysium Core, please make sure your system meets the following conditions to ensure a smooth and consistent experience.

Compatibility Test:
Before purchasing, you can try the Elysium test theme (Ely_test) available on my Pling store profile. This allows you to verify that your system fully supports Elysium before making a purchase.

Download Ely_test Theme

Display Server:
Elysium is designed for X11 environments and delivers the best experience when running on X11. While it may run on Wayland, some features such as transparency, window layering, and desktop integration may not behave as intended.

Conky Support:
It is strongly recommended to use the conky-all package, as it includes all required features such as Lua and Cairo support. Minimal or custom builds of Conky may require additional configuration.

Basic Terminal Usage:
This setup involves running commands and editing configuration files. Basic familiarity with the terminal is recommended.

By proceeding, you acknowledge that your system meets these requirements.

➤ Download

The Elysium Core is available as a premium package. You can purchase and download it through my Ko-fi page.

Get Elysium Core (Ko-fi)

Additional modules are available for free and can be downloaded from the Pling Store.

Browse Free Modules (Pling)

Core and modules are distributed separately to keep the system modular and flexible.

➤ Requirements

Conky

Conky is the main engine that powers the Elysium interface. It renders system information, widgets, and all visual modules directly on your desktop.

Elysium runs smoothly when Conky is installed using the conky-all package, as it includes Lua and Cairo support. Other builds may require additional setup.

Install (Debian/Ubuntu):

sudo apt install conky-all

Install (Arch Linux):

sudo pacman -S conky

Lua

Lua acts as the scripting engine behind Elysium. All modules and rendering logic are written in Lua, enabling a flexible and modular system.

Install (Debian/Ubuntu):

sudo apt install lua5.4

Install (Arch Linux):

sudo pacman -S lua

Curl

Curl is used to retrieve data from external sources such as APIs, allowing Elysium to display dynamic information like weather and network data.

Install (Debian/Ubuntu):

sudo apt install curl

Install (Arch Linux):

sudo pacman -S curl

JQ

JQ processes JSON data from APIs. It works with Curl to extract and structure the required data efficiently.

Install (Debian/Ubuntu):

sudo apt install jq

Install (Arch Linux):

sudo pacman -S jq

Playerctl

Playerctl allows Elysium to interact with media players and display playback information such as track title and artist.

Install (Debian/Ubuntu):

sudo apt install playerctl

Install (Arch Linux):

sudo pacman -S playerctl

Wireless Tools

Wireless Tools are used to detect Wi-Fi information such as SSID, allowing Elysium to display the current network name.

Install (Debian/Ubuntu):

sudo apt install wireless-tools

Install (Arch Linux):

sudo pacman -S wireless_tools

lm-sensors (Optional)

lm-sensors provides access to hardware sensor data such as CPU temperature. It improves accuracy for system monitoring modules.

Install (Debian/Ubuntu):

sudo apt install lm-sensors

Install (Arch Linux):

sudo pacman -S lm_sensors

Fonts

Roboto is used as the primary font in Elysium, providing a clean and modern look across all modules.

Bebas Neue is used for bold headings and large numeric displays, giving a strong and stylish visual emphasis.
Download Bebas Neue (Google Fonts)

Feather is used as an icon font to provide lightweight and consistent iconography across the interface.

Material Design Icons Desktop can be used as an alternative icon set with a wider range of icons.
Download Material Design Icons
or download directly here: MaterialDesignIconsDesktop.ttf

Install Roboto (Debian/Ubuntu):

sudo apt install fonts-roboto

Install Roboto (Arch Linux):

sudo pacman -S ttf-roboto

Install Feather Icons:

mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts
curl -L -o feather.ttf https://raw.githubusercontent.com/AT-UI/feather-font/master/src/fonts/feather.ttf
fc-cache -fv

Feather is an icon font adaptation of Feather Icons, providing lightweight and consistent iconography across the interface.

Make sure all fonts are installed and available on your system to ensure proper rendering of text and icons.

➤ Installation

Follow the steps below to install Elysium on your system.

1. Download Elysium Core

Download the Elysium Core package from the official Ko-fi page.

2. Extract the Package

After downloading, extract the archive. You should get a folder named:

Elysium/

3. Move to Conky Directory

Move the extracted Elysium folder into your Conky configuration directory:

~/.config/conky/

If the ~/.config/conky/ directory does not exist, create it first.

Final structure should look like:

~/.config/conky/Elysium/

4. Set Script Permissions

Open a terminal and run the following commands:

chmod +x ~/.config/conky/Elysium/elysium-home
chmod +x ~/.config/conky/Elysium/scripts/*

5. Location Setup

Elysium uses geographic coordinates (latitude and longitude) to provide accurate data for modules such as weather.

By default, Elysium will attempt to detect your location automatically. However, you can set it manually for better accuracy.

To set your location manually, create or edit the following file:

~/.config/conky/Elysium/state/lat-lon.conf

Add your coordinates in the following format:

LAT="YOUR_LATITUDE"
LON="YOUR_LONGITUDE"

Manual configuration will override automatic detection and ensure consistent results.

6. Run Elysium

You can run Elysium using one of the following methods:

Basic

Run Elysium directly using the configuration file:

conky -c ~/.config/conky/Elysium/Elysium.conf

Advanced (Recommended)

Launch the Elysium control interface using Elysium-home:

~/.config/conky/Elysium/elysium-home

Once opened, you will be presented with a simple interface that allows you to run or restart Elysium and manage your setup more conveniently.

Alternative (GUI)

You can also use Conky Manager 2 to load the Elysium configuration through a graphical interface.

Result

If everything is set correctly, Elysium should now appear on your desktop.

Elysium is now ready. Customize your layout, install additional modules, and build your perfect desktop experience.

Looking to go further? Learn how to fully customize your setup using the Elysium control interface.

Customize with Elysium-home →