New page wikitext, after the edit (new_wikitext) | '= 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:
<pre>
emerge --sync
emerge -uDNav @world
</pre>
Install essential build tools:
<pre>
emerge --ask dev-util/cmake dev-vcs/git sys-devel/gcc
</pre>
=== 2. Add Required USE Flags ===
Enable USE flags for Wayland and Qt:
<pre>
echo "gui-libs/qtwayland wayland" >> /etc/portage/package.use
echo "dev-qt/qtgui egl" >> /etc/portage/package.use
</pre>
Rebuild packages to apply the new USE flags:
<pre>
emerge --ask --newuse --deep @world
</pre>
=== 3. Clone the Maui Shell Repository ===
Clone the official Maui Shell repository from GitHub:
<pre>
git clone https://github.com/Nitrux/maui-shell.git
cd maui-shell
</pre>
=== 4. Build and Install ===
Create a build directory and configure the build:
<pre>
mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release
</pre>
Compile and install Maui Shell:
<pre>
make -j$(nproc)
make install
</pre>
=== 5. Configure Wayland ===
Ensure your system is configured for Wayland. Install `sddm` as a display manager if not already installed:
<pre>
emerge --ask x11-misc/sddm
</pre>
Edit `/etc/sddm.conf` to enable Wayland support:
<pre>
[Wayland]
Enable=true
</pre>
=== 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:
<pre>
cask -w
</pre>
This launches Cask in window mode, allowing you to emulate tablet or phone form factors.
For a Wayland session, use:
<pre>
startcask-wayland
</pre>
To generate logs for debugging:
<pre>
cask -l /tmp/cask.log
</pre>
Ensure your user is part of the `input` group for proper input functionality:
<pre>
sudo usermod -aG input $USER
</pre>
== Troubleshooting ==
- If the session fails to start, check logs in `~/.local/share/sddm`.
- Ensure all dependencies are installed correctly.
- Report issues on the [Maui Shell GitHub page](https://github.com/Nitrux/maui-shell).
== External Links ==
* [Maui Project Official Website](https://mauiproject.org)
* [GitHub Repository](https://github.com/Nitrux/maui-shell)
* [Gentoo Handbook](https://wiki.gentoo.org/wiki/Handbook:AMD64)
== See Also ==
* [[KDE Plasma]] - Another KDE-based desktop environment.
* [[Wayland]] - Information on configuring Wayland in Gentoo.
[[Category:Desktop environments]]
[[Category:Gentoo Linux]]
[[Category:Maui Project]]' |
Lines added in edit (added_lines) | [
0 => '= Installing Maui Shell on Gentoo Linux =',
1 => '',
2 => '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.',
3 => '',
4 => '== Overview ==',
5 => 'Maui Shell consists of two main components:',
6 => '- **Cask**: The shell container managing panels, popups, cards, and other UI elements.',
7 => '- **Zpace**: The compositor responsible for window layout and workspace management.',
8 => '',
9 => 'It is designed to adapt to different form factors, offering a seamless experience across desktops and mobile devices.',
10 => '',
11 => '== Dependencies ==',
12 => 'Before installing Maui Shell, ensure the following dependencies are installed:',
13 => '* **KDE Frameworks**: Provides integration with KDE technologies.',
14 => '* **Qt 5/6**: Required for graphical interface.',
15 => '* **Wayland**: For modern display protocol support.',
16 => '* **CMake**: To build the source code.',
17 => '',
18 => '== Installation Steps ==',
19 => '',
20 => '=== 1. Prepare Your System ===',
21 => 'Update your system to ensure all packages are up-to-date:',
22 => '<pre>',
23 => 'emerge --sync',
24 => 'emerge -uDNav @world',
25 => '</pre>',
26 => '',
27 => 'Install essential build tools:',
28 => '<pre>',
29 => 'emerge --ask dev-util/cmake dev-vcs/git sys-devel/gcc',
30 => '</pre>',
31 => '',
32 => '=== 2. Add Required USE Flags ===',
33 => 'Enable USE flags for Wayland and Qt:',
34 => '<pre>',
35 => 'echo "gui-libs/qtwayland wayland" >> /etc/portage/package.use',
36 => 'echo "dev-qt/qtgui egl" >> /etc/portage/package.use',
37 => '</pre>',
38 => '',
39 => 'Rebuild packages to apply the new USE flags:',
40 => '<pre>',
41 => 'emerge --ask --newuse --deep @world',
42 => '</pre>',
43 => '',
44 => '=== 3. Clone the Maui Shell Repository ===',
45 => 'Clone the official Maui Shell repository from GitHub:',
46 => '<pre>',
47 => 'git clone https://github.com/Nitrux/maui-shell.git',
48 => 'cd maui-shell',
49 => '</pre>',
50 => '',
51 => '=== 4. Build and Install ===',
52 => 'Create a build directory and configure the build:',
53 => '<pre>',
54 => 'mkdir build && cd build',
55 => 'cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release',
56 => '</pre>',
57 => '',
58 => 'Compile and install Maui Shell:',
59 => '<pre>',
60 => 'make -j$(nproc)',
61 => 'make install',
62 => '</pre>',
63 => '',
64 => '=== 5. Configure Wayland ===',
65 => 'Ensure your system is configured for Wayland. Install `sddm` as a display manager if not already installed:',
66 => '<pre>',
67 => 'emerge --ask x11-misc/sddm',
68 => '</pre>',
69 => '',
70 => 'Edit `/etc/sddm.conf` to enable Wayland support:',
71 => '<pre>',
72 => '[Wayland]',
73 => 'Enable=true',
74 => '</pre>',
75 => '',
76 => '=== 6. Launch Maui Shell ===',
77 => 'Reboot your system and select "Maui Shell" from the session options in your display manager.',
78 => '',
79 => '== Running Maui Shell ==',
80 => 'You can also test Maui Shell in an X11 session by running:',
81 => '<pre>',
82 => 'cask -w',
83 => '</pre>',
84 => 'This launches Cask in window mode, allowing you to emulate tablet or phone form factors.',
85 => '',
86 => 'For a Wayland session, use:',
87 => '<pre>',
88 => 'startcask-wayland',
89 => '</pre>',
90 => '',
91 => 'To generate logs for debugging:',
92 => '<pre>',
93 => 'cask -l /tmp/cask.log',
94 => '</pre>',
95 => '',
96 => 'Ensure your user is part of the `input` group for proper input functionality:',
97 => '<pre>',
98 => 'sudo usermod -aG input $USER',
99 => '</pre>',
100 => '',
101 => '== Troubleshooting ==',
102 => '- If the session fails to start, check logs in `~/.local/share/sddm`.',
103 => '- Ensure all dependencies are installed correctly.',
104 => '- Report issues on the [Maui Shell GitHub page](https://github.com/Nitrux/maui-shell).',
105 => '',
106 => '== External Links ==',
107 => '* [Maui Project Official Website](https://mauiproject.org)',
108 => '* [GitHub Repository](https://github.com/Nitrux/maui-shell)',
109 => '* [Gentoo Handbook](https://wiki.gentoo.org/wiki/Handbook:AMD64)',
110 => '',
111 => '== See Also ==',
112 => '* [[KDE Plasma]] - Another KDE-based desktop environment.',
113 => '* [[Wayland]] - Information on configuring Wayland in Gentoo.',
114 => '',
115 => '[[Category:Desktop environments]]',
116 => '[[Category:Gentoo Linux]]',
117 => '[[Category:Maui Project]]'
] |
New page text, stripped of any markup (new_text) | 'Contents
1 Installing Maui Shell on Gentoo Linux
1.1 Overview
1.2 Dependencies
1.3 Installation Steps
1.3.1 1. Prepare Your System
1.3.2 2. Add Required USE Flags
1.3.3 3. Clone the Maui Shell Repository
1.3.4 4. Build and Install
1.3.5 5. Configure Wayland
1.3.6 6. Launch Maui Shell
1.4 Running Maui Shell
1.5 Troubleshooting
1.6 External Links
1.7 See Also
Installing Maui Shell on Gentoo Linux[modifier]
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[modifier]
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[modifier]
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[modifier]
1. Prepare Your System[modifier]
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[modifier]
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[modifier]
Clone the official Maui Shell repository from GitHub:
git clone https://github.com/Nitrux/maui-shell.git
cd maui-shell
4. Build and Install[modifier]
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[modifier]
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[modifier]
Reboot your system and select "Maui Shell" from the session options in your display manager.
Running Maui Shell[modifier]
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[modifier]
- If the session fails to start, check logs in `~/.local/share/sddm`.
- Ensure all dependencies are installed correctly.
- Report issues on the [Maui Shell GitHub page](https://github.com/Nitrux/maui-shell).
External Links[modifier]
[Maui Project Official Website](https://mauiproject.org)
[GitHub Repository](https://github.com/Nitrux/maui-shell)
[Gentoo Handbook](https://wiki.gentoo.org/wiki/Handbook:AMD64)
See Also[modifier]
KDE Plasma - Another KDE-based desktop environment.
Wayland - Information on configuring Wayland in Gentoo.' |
Wiki