Installation

This is the installation guide for colorshell! Thanks for being interested on it ❤️

Installing a Display Manager

Display Managers are the Login Screen you see when you bootup your GNU/Linux OS. Already have one? Skip to the next step!
If you want to know more, go to the Arch Linux's Display Manager Wiki page.

Some of them are:

• sddm (recommended): QML-based DM, can be styled to your liking.
• gdm: Gnome's Display Manager.
• lightdm: Can use various front-ends written in any toolkit. (from Arch Wiki)

Choose one of them, install and enable their respective systemd service.

Dependencies

You'll need to install all the packages listed in Wiki/Dependencies for your system before installing colorshell, quickly install all of them if you're using an Arch Linux, or an Arch-based system, with the command available in Wiki/Dependencies#Quick Install.

Installing the Shell

Now you can start the installation! You can both run:

bash -c "bash <(curl -s https://raw.githubusercontent.com/retrozinndev/colorshell/refs/heads/ryo/install.sh)"

Or use a less-URLed version:

git clone https://github.com/retrozinndev/colorshell && cd colorshell && bash ./install.sh

...and you're done installing! Now, proceed to the next step.

Starting Hyprland

The recommended way to start Hyprland is by using UWSM(Universal Wayland Session Manager). If you installed a Display Manager, select the Hyprland (uwsm-managed) session in the sessions list. Or, if you don't want to use Hyprland with UWSM, just use the regular session. Not using a Display Manager? You can add to your user profile:

With UWSM:

if uwsm may-start && uwsm select; then
    uwsm start default
fi

No UWSM:

Hyprland

If you want an official guide, follow Systemd Startup in the Hyprland Wiki.

That's just it, now you can enjoy colorshell in your system!! If you run into an issue, consider creating a new issue in the Issues page, thanks for using colorshell! ❤️