Elysium Project — Customization with Elysium-home

⌘ Overview

Elysium-home is the central interface for controlling and customizing your Elysium setup, designed to simplify how you interact with your desktop. It allows you to start and manage your session, assign modules to a structured grid layout, and shape your interface with consistent control. You can adjust the global palette, scale widgets to match your display, configure measurement units, and manage autostart behavior — all from a single, streamlined environment without the need for manual configuration.

Elysium-home dashboard

⌘ Dependencies

Elysium-home is a terminal-based interface (TUI) and requires a compatible environment to run properly.

• Terminal emulator with ncurses support
• ncurses library
• Monospace font for optimal alignment and readability
• Compiled binary (if building from source)
• Chafa (optional, for preview rendering – experimental)

Preview rendering is currently in development and uses Chafa for terminal-based image output. Future versions may switch to ueberzugpp for improved visual quality and performance.

If you are using a prebuilt package, no additional setup is required. Otherwise, make sure all dependencies are available before building Elysium-home manually.

⌘ Launch

Once your environment is ready, you can start Elysium-home from your system to access the control interface.

Launching Elysium-home will open a terminal-based session where you can manage your entire setup, including running or restarting Elysium, configuring modules, and adjusting system behavior.

This interface acts as the central hub for all interactions, allowing you to control your desktop without manually editing configuration files.

Before launching Elysium-home, make sure the script has executable permissions:

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

Once ready, start the control interface:

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

If you encounter issues running Elysium-home, you can build it manually from source:

gcc ~/.config/conky/Elysium/src/*.c -lncursesw -o ~/.config/conky/Elysium/elysium-home

After compiling, run the start command again.

⌘ Interface

The interface provides direct access to core controls, allowing you to manage and customize your Elysium setup from a single place. Each option is designed to be simple and responsive, giving you full control without unnecessary complexity.

➤ Start / Restart
Launch or reload Elysium to apply changes instantly. This allows you to quickly test adjustments without restarting your system or reloading configurations manually.

➤ Module Manager
Assign modules to specific grid slots (A1–D2), forming a structured layout across your desktop. This system ensures that every module has a defined position, making your setup predictable and easy to maintain.

➤ Palette Manager
Modify the global color scheme used throughout Elysium. Changes are applied consistently across all modules, helping maintain a unified visual style.

➤ Scale Control
Adjust the overall interface scale to better fit your screen size and resolution. This ensures that elements remain properly sized and readable on different displays.

➤ Unit Settings
Define measurement units such as temperature or speed. These settings are applied globally, so all supported modules follow the same standard.

➤ Autostart
Enable Elysium to start automatically when your system boots, allowing your setup to run seamlessly without manual launch.

⌘ Modules

Elysium modules are lightweight, modular, and easy to integrate into your layout. You can explore and download additional modules from the official page:

https://pling.com/u/closebox73x

➤ Download & Install

Download a module from the link above, then extract it into the following directory:

~/.config/conky/Elysium/modules/

Make sure the module folder contains a module.lua file.

After installing, open Elysium-home and assign the module to a grid slot using the Module Manager.

Once assigned, Elysium will automatically reload and apply the changes.

Each module runs independently, so adding or removing modules will not affect the core system.

⌘ How It Works

Each grid slot is mapped to a module through configuration files. Elysium-home handles these mappings automatically, removing the need for manual editing.

This approach keeps the system clean, modular, and easy to maintain.

⌘ Tips

• Keep your layout minimal for better performance
• Use consistent module sizes for visual balance
• Changes are applied automatically after assigning modules

⌘ Final Notes

Elysium-home gives you full control over your desktop. Experiment with different modules and layouts to build a setup that fits your workflow.