This article has been flagged for not conforming to the wiki guidelines. Please help Gentoo out by starting fixing things.

Installing Maui Shell on Gentoo Linux

Maui Shell is a modern, convergent desktop shell designed for Linux desktops, tablets, and phones. It offers a clean, adaptable interface built on KDE technologies and supports both X11 and Wayland. This guide outlines how to install Maui Shell on Gentoo Linux.

Overview

Maui Shell consists of two main components: - **Cask**: The shell container managing panels, popups, cards, and other UI elements. - **Zpace**: The compositor responsible for window layout and workspace management.

It is designed to adapt to different form factors, offering a seamless experience across desktops and mobile devices.

Dependencies

Before installing Maui Shell, ensure the following dependencies are installed:

**KDE Frameworks**: Provides integration with KDE technologies.
**Qt 5/6**: Required for graphical interface.
**Wayland**: For modern display protocol support.
**CMake**: To build the source code.

Installation Steps

1. Prepare Your System

Update your system to ensure all packages are up-to-date:

emerge --sync
emerge -uDNav @world

Install essential build tools:

emerge --ask dev-util/cmake dev-vcs/git sys-devel/gcc

2. Add Required USE Flags

Enable USE flags for Wayland and Qt:

echo "gui-libs/qtwayland wayland" >> /etc/portage/package.use
echo "dev-qt/qtgui egl" >> /etc/portage/package.use

Rebuild packages to apply the new USE flags:

emerge --ask --newuse --deep @world

3. Clone the Maui Shell Repository

Clone the official Maui Shell repository from GitHub:

git clone https://github.com/Nitrux/maui-shell.git
cd maui-shell

4. Build and Install

Create a build directory and configure the build:

mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release

Compile and install Maui Shell:

make -j$(nproc)
make install

5. Configure Wayland

Ensure your system is configured for Wayland. Install `sddm` as a display manager if not already installed:

emerge --ask x11-misc/sddm

Edit `/etc/sddm.conf` to enable Wayland support:

[Wayland]
Enable=true

6. Launch Maui Shell

Reboot your system and select "Maui Shell" from the session options in your display manager.

Running Maui Shell

You can also test Maui Shell in an X11 session by running:

cask -w

This launches Cask in window mode, allowing you to emulate tablet or phone form factors.

For a Wayland session, use:

startcask-wayland

To generate logs for debugging:

cask -l /tmp/cask.log

Ensure your user is part of the `input` group for proper input functionality:

sudo usermod -aG input $USER

Troubleshooting

- If the session fails to start, check logs in `~/.local/share/sddm`. - Ensure all dependencies are installed correctly.

Maui shell

Contents