Warning
I would like to clarify one very important aspect of ricing. We use custom themes, and those might not get updated very often, if at all by their respective developers/artists, which might result in some parts of the system and apps not to get themed correctly. That, my friends, is unfortunately out of our hands.
diff --git a/site/search/search_index.json b/site/search/search_index.json
index 6104f5e..eb4b9d2 100644
--- a/site/search/search_index.json
+++ b/site/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Welcome","text":""},{"location":"#welcome-to-the-xero-wiki","title":"Welcome to the Xero Wiki","text":"
Welcome to XeroLinux Wiki ! Think of this page as your go-to hub for all things related to our scripts, tools, and configurations. Here, you'll find a comprehensive and centralized resource for every tweak, command, or customization option you've ever tinkered with.
Tip
Announcements regarding my tools will be shared on the XeroLinux main site. Please make sure you are subscibed to its RSS Feed for any future updates.
It's meticulously designed to keep everything organized and accessible, so you can focus more on experimenting and less on searching for that one-liner you swear you wrote down somewhere.
This wiki is built with intuitive section links that seamlessly navigate to specific parts of the documentation. Imagine needing to remember a specific customization: simply enter the Customization page and press i in the toolkit, to instantly jump to the relevant section.
The goal is to make this your primary reference, eliminating the need to hunt through disparate notes or scattered files. As I phase out the current GitHub wiki, this will become the central repository for all my projects\u2014better organized, more user-friendly, and directly integrated with the tools I use daily.
In order to cantact me, you can do so on either, Fosstodon, or Discord
"},{"location":"SUMMARY/","title":"SUMMARY","text":"
\ud83c\udfe0Home \ud83d\udcbfThe Distro \ud83d\udc27The Toolkit \ud83d\udcbbPlasma Install \ud83c\udfa8Layan KDE Rice \ud83c\udfadThe Grub Themes \u2734\ufe0fCosmic Install (Alpha) "},{"location":"cosmic/","title":"Cosmic Install Script (Alpha)","text":".//\u2734\ufe0f Cosmic Script (Alpha) \u2734\ufe0f\\\\.
Warning
The script shared herein is work-in-progress. Cosmic is still in Alpha stages; so it needs time to reach full maturity. Please do not use it on your production machine. If you want to test in a VM, for best performance I would highly recommend ProxmoxVe.
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#script-info","title":"Script info","text":"
Well, it does what title says, it installs Cosmic in one of 3 ways. I also discovered the Cosmic group on Arch does not include the xdg-user-dirs package which creates the Documents, Music, Pictures, Downloads & Videos folders in your home & system76-power is missing which the Cosmic Settings will prompt you for; so I added them.
Complete : Installs Cosmic from Extra Repos. Selective : Select pkgs you want yourselves. Development : Commit-based Install -DANGER-.
Included are some useful packages, like a freaking web browser eg. Firefox, an archive manager, Meld and so much more. It's a start. We shall add more if you wish, just keep in mind that only packages coming from the official Arch Repositories are supported, none from the AUR.
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#execution-blockers","title":"Execution Blockers","text":"
I have also implemented some checks making sure script is being run in chroot and on ArchLinux blocking execution anywhere else. This helps me in the long run not having to bang my head against the wall trying to provide support in case it was run on Distros I have no control over.
So to avoid the headaches, I decided to block the execution. Better for everyone. This will allow me to concentrate on the distro and other current/future projects, with support being limited within XeroLinux.
Scroll down for usage instructions...
.// The Wiki \\\\.","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#instructions","title":"Instructions","text":"
Warning
Do not select the Development Version unless you are ready to fix issues that might arise from it. It's the Rolling version which means it's commit based. Should you choose it, I recommend you do regular backups before updating. Please report all the bugs related to the DE or any feature requests you might have upstream, to the Cosmic Bug Tracker
Using this script is identical to the Plasma Installer am not gonna rehash it all here. Suffice it to say, you will need to go through the ArchInstall script, skipping the Profiles and Drivers sections completely, which would result in a minimal Server install of Arch.
Anyway, once that's all done, we will be prompted if we want to chroot into our new install, we answer with yes of course since we still have no DE yet.
Caution : We do not recommend to blindly execute scripts without inspecting them first. You can find the code on >> Github.
Now, we type the following command :
bash -c \"$(curl -fsSL https://tinyurl.com/CosmicXero)\"\nThis will execute the script. Just go through the prompts. In this case however, I would Highly recommend option Complete Cosmic Install to avoid any future headaches. But that's not to say we cannot select any of the other option, it's all up to you in the end.
The script will tell you that going throught with the installation, the XeroLinux as well as the Chaotic-AUR repos will be enabled in order for script to work correctly, like so...
You will notice that, the multilib repo was enabled as well. I made sure of that since most newcomers forget to do it. It's an essential repo required for the likes of Steam, and various drivers.
Finally, for now at least, once script is done, we will be prompted to exit and reboot the system. We do that by typing exit then reboot, that's it !
Now use my toolkit to install any drivers especially if you are using an nVidia GPU otherwise you will have a bad time. Besides that enjoy the DE.
If you would like to customize the look, feel free to jump on over to the all-new Cosmic-Themes site, where you will be able to grab a few cool ones, like Catppuccin, Dracula among others. Keep in mind that those are just color schemes no more no less. They do not apply to everything.
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#wrapping-up","title":"Wrapping up","text":"
That's it for now. If you would like to help out so we can bring it to the public, you are more than welcome to. Especially when it comes to the Hardware Checker part which requires a lot of testing that I cannot do due to limited hardware availability.
Cosmic is shaping up to be the DE that might break the current Top 2 (KDE and Gnome) making it the Top 3 DEs of all time. Who knows ? I wish the System76 team all the best.
Cheers !
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"distro/","title":"The XeroLinux Distro","text":".//\ud83d\udcbf The XeroLinux Distro \ud83d\udcbf\\\\.
Note
Check out the release notes and issues \u00bb Here. To access source code, head on over to the \u00bb XeroLinuxDev Org.
","tags":["Linux","Distro"]},{"location":"distro/#thank-you","title":"Thank you","text":"
Before we begin, I would like to tell everyone of you who has supported the XeroLinux project by either getting the ISO or some merch, how much your simple act of kindness means to me. I cannot put it into words. So all am gonna say is God bless you all. I hope your kindness is reciprocated. \ud83d\ude4f\u2764\ufe0f
In case you haven't gotten your copy yet, check out how to \u00bb Here.
","tags":["Linux","Distro"]},{"location":"distro/#information","title":"Information","text":"
This is the famous XeroLinux Distro. It's a culmination of everything you see here, like the Xero Toolkit, The Plasma Install Script & the Xero Layan Rice. All combined as an easy to install Arch+KDE Distro.
","tags":["Linux","Distro"]},{"location":"distro/#is-it-any-special","title":"Is it any Special?","text":"
This is a common question I get. To be honest, there\u2019s no groundbreaking advantage\u2014it simply provides an easier way to install Arch with a polished KDE experience right out of the box, which many users seem to appreciate. I created it specifically for them, as an alternative to my DIY install script, and as a way for you to support my journey.
.// The Wiki \\\\.","tags":["Linux","Distro"]},{"location":"distro/#installation","title":"Installation","text":"
Warning
When it comes to Encryption, I haven't tested it thoroughly. Use at your own Risk! Calamares is meh when it comes to that. All I know is it's extremely limited. It can't ecrypt both boot n root, just one or the other. Am sorry I test what I can. Please report any findings to me on Discord.
To install the distro, all you have to do is use the tried and true Ventoy to put ISO on & boot, that way you have Grub as fallback in case SystemD-Boot fails. If you burn using Etcher or similar tools there will be nothing to fall back to. Just an FYI.
Calamares will auto-launch on boot. Just go through the motions and when you get to the user creation page, if you select the Autologin option, you will be logged in to an X11/Xorg session, not Wayland, we chose that for compatibility with legacy hardware nothing more. Yes you can still switch to Wayland post-install, just use the toolkit, it's under option 7. System Troubleshooting & Tweaks >> 6. Change Autologin Session X11/Wayland (SDDM) and select Wayland, reboot, done.
Anyway, the installer is and will always function in offline mode, meaning that while no actual Internet connection is required during install, it's highly recommended you do have one in order to be able to update later on. Also, the currently supported Filesystems are, ext4, btrfs and xfs. I don't know much about btrfs so I will try my best to help there, just do not expect me to have all the answers regarding it, sorry.
We have also had no choice but to disable the Swap\u00b1Hibernate options due to an ongoing issue with latest version of Calamares. Will be re-added at some point in the future. Until then you can still use Swap File only if you have 8GB or less RAM otherwise it would be a waste of space.
That's it, there ain't much to it. Launch our toolkit from the dock, update system first, and have fun shaping the distro to your liking...
","tags":["Linux","Distro"]},{"location":"grub/","title":"XeroLinux Grub Themes","text":".//\ud83c\udfad The Grub-Themes Script \ud83c\udfad\\\\.","tags":["Grub","Linux"]},{"location":"grub/#information","title":"Information","text":"
This is a simple script, that will allow you to install any of the Grub themes I have created in the past. They will not be updated, that's just a relic of time past lol.
.// The Wiki \\\\.","tags":["Grub","Linux"]},{"location":"grub/#installation","title":"Installation","text":"
I included a script that makes installing them much easier, just follow steps below :
1- Git Clone the repo & run script like so
git clone https://github.com/xerolinux/xero-grubs\ncd xero-grubs/ && sudo ./install.sh\n2- Select one of the 8 themes, watch the magic. 3- Reboot your system and see the theme in action !
Be very careful playing with your bootloader. I made sure they work. Beyond that it's on you. This is provided as is with no warranty whatsoever...
","tags":["Grub","Linux"]},{"location":"plasma/","title":"XeroLinux Plasma-Install","text":".//\ud83d\udcbb The Plasma-Install Script \ud83d\udcbb\\\\.
Note
This does not require a Wiki page, it's here for reference as it has a full in-depth guide with a video included, on our Official Site where we go over each step in detail. Follow it closely for best experience. I might port back to here in the future.
","tags":["Linux","Plasma","XeroLinux","ArchLinux"]},{"location":"plasma/#what-it-is","title":"What it is","text":"
With the help of this script, you will be able to install Plasma in one of 4 methods as you can see in the image below. Not only that, but it will also fix PipeWire and Bluetooth.
This script has an option to include my repo, Chaotic-AUR's & Toolkit. Toolkit also includes the option to apply my rice. So if you opt to include it, you do not need to get other projects/tools separately. It\u2019s meant as an All-in-One solution.
","tags":["Linux","Plasma","XeroLinux","ArchLinux"]},{"location":"rice/","title":"XeroLinux Layan KDE","text":".//\ud83c\udfa8 The Layan KDE Rice \ud83c\udfa8\\\\.
Warning
I would like to clarify one very important aspect of ricing. We use custom themes, and those might not get updated very often, if at all by their respective developers/artists, which might result in some parts of the system and apps not to get themed correctly. That, my friends, is unfortunately out of our hands.
","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#information","title":"Information","text":"
This is my complete conversion script, that will transform your KDE Plasma into something out of this world. I spent days, nay weeks optimizing it for best performance and stability. Some bugs may remain, please report them.
","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#performance","title":"Performance","text":"
As mentioned, this rice has been throughly optimized for best performance on higher-end systems.. Although it might work on lower-end ones, for better performance I do not recommend that you use it there. So please do not report any performance issues.
.// The Wiki \\\\.","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#installation","title":"Installation","text":"
Install At Own Risk!!!. As of now it supports Plasma 6.x.x. If you notice any issues and report them via issue tracker on here and I will do my best to address them. To apply the rice, please follow the commands posted below. You will need either Paru or Yay (installed via my toolkit). Keep in mind that this will replace some files. Read below...
git clone https://github.com/xerolinux/xero-layan-git\ncd xero-layan-git/ && ./install.sh\n","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#backing-up","title":"Backing up","text":"
The install script will backup some app settings & all system ones before applying and overriding them with new ones, you will be able to restore what you need from the backup, so please do not report that. You have been warned. In case of any issues please find us on our Discord. Best of luck !
I would recommend you keep the folder backed up somewhere since it will get deleted once script is done with execution. That way, when I announce updates all you will have to do is git pull, like so...
cd xero-layan-git/ && git pull\n","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#elements-used","title":"Elements Used","text":"
The rice uses the Layan GTK / KDE Theme & Tela Circle Icons by VinceLiuice. As for Widgets AkA Plasmoids, it uses Apdatifier, Netspeed, Quick Shutdown, Toggle Overview and Wunderground PWS.
Adding any more would start causing issues IMO. I kept it at a minimum for balance and stability. You are free to add more, remove what you do not need etc.. This is just a good base. Finally do not report issues to me, I am not the one who created any of the elements used, report upstream to respective Devs. Thanks.
","tags":["Linux","Ricing","Plasma"]},{"location":"xlapit/","title":"XeroLinux Toolkit","text":".//\ud83d\udc27 The Post-Install Toolkit \ud83d\udc27\\\\.
Warning
It's crucial to clarify that this toolkit isn't intended for custom Arch-Based distros. While some elements might function, I can't ensure seamless compatibility due to potential conflicts arising from differing tweaks and repositories. To ensure optimal performance.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#what-it-is","title":"What it is","text":"
This toolkit aims to be an all-in-one solution for post-installation, expediting your Arch setup. It's offered as use at your own risk type of thing, without much support. You will have to rely on yourself and your own knowledge and ability to do research your setup.
Toolkit recieves a lot of updates on almost a daily basis. Use above video just as a reference not an absolute lol. I keep getting ideas which I immediately implement. Due to the amount of changes I cannot keep a changelog, sorry. Too many to keep up with.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#how-to-get-it","title":"How to get it","text":"
First off let me say that everything this awesome toolkit provides is and will forever be optional and up to you the user. I will never force anything on you.
Tip
Don't just run script, without inspecting it first. So before using Curl command below you can examine it => HERE. It will always be provided as is without any Warranty of any kind. If you need support you know where to find me. Hint : \"check the footer for links\".
Now, once you have inspected the code, just run this simple curl command to get started :
bash -c \"$(curl -fsSL https://tinyurl.com/xtoolkit)\"\nIt will prompt you before injecting as in adding the XeroLinux repository, where from it will then prompt you, should you agree, as to which AUR helper you prefer, then proceed to do so then install and launch the toolkit.. Again only if you agree..
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#acessing-toolkit","title":"Acessing Toolkit","text":"
You can access toolkit by either typing xero-cli -m in terminal or from the application menu via the XeroLinux Post Installation Toolkit shortcut.. Just close terminal window once done using it lol ;)
.// The Wiki \\\\.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#system-setup","title":"System Setup","text":"
This is the initial setup part where you set the most common things up and/or install Package managers...
- Initial Setup Section
option description Update System Will guide you through system update via 1 of 3 methods. PipeWire/Bluetooth Missing PipeWire/Bluetooth Packages not offered by ArchInstall. Activate Flathub Enables Flathub which is required by the toolkit. Enable multithread compilation. Sets compilation to use all Cores/Threads for faster building.
- GUI Package Managers
Although some DEs like Gnome and KDE Plasma come with their own GUI package manager, they have some limitations. That's why I decided to include others that give us more freedom. See below...
option description OctoPi Installs Octopi. PacSeek Installs PacSeek Incl. PacFinder. Bauh Installs Bauh.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#system-drivers","title":"System Drivers","text":"
Well this section is dedicated to Drivers like GPU, Printer, Samba, Scanner & Game controllers. Below are more details on various options.
option description GPU Will guide you prompts to set up your GPU drivers. Printer Installs all the necessary ones that will cover most cases. Check AUR for others. Samba Installs a meta package I have created that covers most cases. Scanner Installs a meta package by myself for most people. Check AUR for others. Tailscale Installs Tailscale with fix for XeroLinux. DeckLink & StreamDeck Installs driver for Decklink, DeckMaster or StreamDeckUI (AUR).","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#distrobox-docker","title":"Distrobox / Docker","text":"
This will allow you to set either one up in case you want to test one or all of the Distros offered or use containerized apps for self-hosting.
option description Docker Installs and configures Docker, Docker-Compose, Docker-BuildX and LazyDocker. Will be prompted if you want Podman Desktop Distrobox Installs Distrobox with BoxBuddy which will allow you to deploy the offered Distro containers.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#system-customization","title":"System Customization","text":"
That's where the fun stuff begin, yep as you might have realized by now, I love customizing my DE that's why I use KDE Plasma. So if you want to customize your experience that's where you do it from.
- Shell / Prompts
option description Fastfetch Installs Fastfetch with Custom settings. Fish Shell Installs the Fish Shell with stock settings. OhMyPosh Installs OhMyPosh with Custom settings. ZSH AlinOne Installs ZSH with OhMyZSH and OhMyPosh and plugins. Gnome Extenstion Tools Installs Gnome's Extension Manager.
- DE/WM Ricing
option description XeroLinux KDE Rices Will let you apply my Layan KDE Rice. Theme has been ported to Plasma 6 Hyprland Dot Files Will offer you 3 Hyprland dots to choose from, linking you to their respective Git.
In closing, this section will be updated to include some useful customization features as time goes by..
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#game-launchers","title":"Game Launchers","text":"
Are you an avid gamer ? That section has you covered, allowing you to install the launcher(s) you need to get up and running in no time. Now you will have a choice of installing either the Flathub version officially supported by the devs or the unofficial Native version.
- Game Launchers
Tip
For Steam it will also apply the Fast Download Patch which will allow you to download games using the entirety of your connection. Keep in mind that this might choke it a bit so better wait for download to be done before attempting to watch any YouTube videos lol...
option description Steam Installs Steam All-in-One with Mangohud, Goverlay & Gamemode. Game Controller Installs any of ds4drv for PS4 Controller, dualsensectl for PS5's DualSense Controller or xone-dkms for the XBox-One Controller. Lutris Installs Lutris. Heroic Installs Heroic. Bottles Installs Bottles. Protonup-qt Installs Protonup-qt.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#recommended-packages","title":"Recommended Packages","text":"
Warning
The System Tools option will just go ahead and install everything in it. I only selected the important stuff nothing big or unnecessary from both Arch Repos and the AUR, so might take abit to install everything depending on your specs. For transparency I included the list below the table so you know what's gonna be installed on your system should you opt to install.
- Various Extra Pkgs
option description LibreOffice Installs LibreOffice Fresh version. Web Browsers A selection of Web-Browsers. System Tools Installs a \"set of packages\" essential for a fully functional system. Development Tools Installs your choice of Development tools. Photography & 3D Installs your choice of Image and 3D Tools. Music/Audio Installs your choice of Audio & Video Tools. Social-Media Installs your choice of Chat clients. Virtualization Installs either VirtualBox or Virt-Manager. Video & Editing Installs any of Video tools. OBS-Studio includes a list of commonly used plugins.
System Packages list :
linux-headers downgrade mkinitcpio-firmware hw-probe pkgstats alsi update-grub expac linux-firmware-marvell eza numlockx lm_sensors appstream-glib bat bat-extras pacman-contrib pacman-bintrans yt-dlp gnustep-base parallel dex make libxinerama logrotate bash-completion gtk-update-icon-cache gnome-disk-utility appmenu-gtk-module dconf-editor dbus-python lsb-release asciinema playerctl s3fs-fuse vi duf gcc yad zip xdo inxi lzop nmon mkinitcpio-archiso mkinitcpio-nfs-utils tree vala btop lshw expac fuse3 meson unace unrar unzip p7zip rhash sshfs vnstat nodejs cronie hwinfo hardinfo2 arandr assimp netpbm wmctrl grsync libmtp polkit sysprof gparted hddtemp mlocate fuseiso gettext node-gyp graphviz inetutils appstream cifs-utils ntfs-3g nvme-cli exfatprogs f2fs-tools man-db man-pages tldr python-pip python-cffi python-numpy python-docopt python-pyaudio xdg-desktop-portal-gtk\n","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#troubleshooting","title":"Troubleshooting","text":"
Now am not gonna go over everything this section does, suffice it to say that this is a place that contains most troubleshooting options. Here's a list...
1. Install & Activate Firewalld.\n2. Clear Pacman Cache (Free Space).\n3. Restart PipeWire/PipeWire-Pulse.\n4. Unlock Pacman DB (In case of DB error).\n5. Activate v4l2loopback for OBS-VirtualCam.\n6. Change Autologin Session X11/Wayland (SDDM).\n\na. Build Updated Arch ISO.\nw. WayDroid Installation Guide.\nm. Update Arch Mirrorlist, for faster download speeds.\ng. Fix Arch GnuPG Keyring in case of pkg signature issues.\n","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#gpu-driver-notes","title":"GPU Driver Notes","text":"
When it comes to GPU Drivers, toolkit covers most common setups. It currently does NOT cover Hybrid ones. For those you will have to consult online documentation, sorry. Anyway, by answering the prompts correctly you will have your system(s) up and running in no time at all. Even Kernel modules will load for nVidia. If you have any issues let me know here...
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#3rd-party-kernel-support","title":"3
rd Party Kernel Support","text":"
No 3rd party Kernels are provided by this toolkit. So if you install any, please remember to include their headers for seamless functionality of anything that relies on DKMS (Dynamic Kernel Modules).
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#how-to-contribute","title":"How to Contribute","text":"
If you can/want to Contribute your knowledge improving this toolkit taking it above and beyond, making it the defacto for every Arch user, please see Here for more information.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#toolkit-credits","title":"Toolkit Credits","text":"
Main menu is written in Rust thanks to OgloTheNerd. And some contributions were made by a friend of the project It-A-Me. Thanks to them this Toolkit wouldn't have reached this point.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Welcome","text":""},{"location":"#welcome-to-the-xero-wiki","title":"Welcome to the Xero Wiki","text":"
Welcome to XeroLinux Wiki ! Think of this page as your go-to hub for all things related to our scripts, tools, and configurations. Here, you'll find a comprehensive and centralized resource for every tweak, command, or customization option you've ever tinkered with.
Tip
Announcements regarding my tools will be shared on the XeroLinux main site. Please make sure you are subscibed to its RSS Feed for any future updates.
It's meticulously designed to keep everything organized and accessible, so you can focus more on experimenting and less on searching for that one-liner you swear you wrote down somewhere.
This wiki is built with intuitive section links that seamlessly navigate to specific parts of the documentation. Imagine needing to remember a specific customization: simply enter the Customization page and press i in the toolkit, to instantly jump to the relevant section.
The goal is to make this your primary reference, eliminating the need to hunt through disparate notes or scattered files. As I phase out the current GitHub wiki, this will become the central repository for all my projects\u2014better organized, more user-friendly, and directly integrated with the tools I use daily.
In order to cantact me, you can do so on either, Fosstodon, or Discord
"},{"location":"SUMMARY/","title":"SUMMARY","text":"
\ud83c\udfe0Home \ud83d\udcbfThe Distro \ud83d\udc27The Toolkit \ud83d\udcbbPlasma Install \ud83c\udfa8Layan KDE Rice \ud83c\udfadThe Grub Themes \u2734\ufe0fCosmic Install (Alpha) "},{"location":"cosmic/","title":"Cosmic Install Script (Alpha)","text":"","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#cosmic-script-alpha","title":"\u2734\ufe0f Cosmic Script (Alpha) \u2734\ufe0f","text":"
Warning
The script shared herein is work-in-progress. Cosmic is still in Alpha stages; so it needs time to reach full maturity. Please do not use it on your production machine. If you want to test in a VM, for best performance I would highly recommend ProxmoxVe.
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#script-info","title":"Script info","text":"
Well, it does what title says, it installs Cosmic in one of 3 ways. I also discovered the Cosmic group on Arch does not include the xdg-user-dirs package which creates the Documents, Music, Pictures, Downloads & Videos folders in your home & system76-power is missing which the Cosmic Settings will prompt you for; so I added them.
Complete : Installs Cosmic from Extra Repos. Selective : Select pkgs you want yourselves. Development : Commit-based Install -DANGER-.
Included are some useful packages, like a freaking web browser eg. Firefox, an archive manager, Meld and so much more. It's a start. We shall add more if you wish, just keep in mind that only packages coming from the official Arch Repositories are supported, none from the AUR.
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#execution-blockers","title":"Execution Blockers","text":"
I have also implemented some checks making sure script is being run in chroot and on ArchLinux blocking execution anywhere else. This helps me in the long run not having to bang my head against the wall trying to provide support in case it was run on Distros I have no control over.
So to avoid the headaches, I decided to block the execution. Better for everyone. This will allow me to concentrate on the distro and other current/future projects, with support being limited within XeroLinux.
Scroll down for usage instructions...
.// The Wiki \\\\.","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#instructions","title":"Instructions","text":"
Warning
Do not select the Development Version unless you are ready to fix issues that might arise from it. It's the Rolling version which means it's commit based. Should you choose it, I recommend you do regular backups before updating. Please report all the bugs related to the DE or any feature requests you might have upstream, to the Cosmic Bug Tracker
Using this script is identical to the Plasma Installer am not gonna rehash it all here. Suffice it to say, you will need to go through the ArchInstall script, skipping the Profiles and Drivers sections completely, which would result in a minimal Server install of Arch.
Anyway, once that's all done, we will be prompted if we want to chroot into our new install, we answer with yes of course since we still have no DE yet.
Caution : We do not recommend to blindly execute scripts without inspecting them first. You can find the code on >> Github.
Now, we type the following command :
bash -c \"$(curl -fsSL https://tinyurl.com/CosmicXero)\"\nThis will execute the script. Just go through the prompts. In this case however, I would Highly recommend option Complete Cosmic Install to avoid any future headaches. But that's not to say we cannot select any of the other option, it's all up to you in the end.
The script will tell you that going throught with the installation, the XeroLinux as well as the Chaotic-AUR repos will be enabled in order for script to work correctly, like so...
You will notice that, the multilib repo was enabled as well. I made sure of that since most newcomers forget to do it. It's an essential repo required for the likes of Steam, and various drivers.
Finally, for now at least, once script is done, we will be prompted to exit and reboot the system. We do that by typing exit then reboot, that's it !
Now use my toolkit to install any drivers especially if you are using an nVidia GPU otherwise you will have a bad time. Besides that enjoy the DE.
If you would like to customize the look, feel free to jump on over to the all-new Cosmic-Themes site, where you will be able to grab a few cool ones, like Catppuccin, Dracula among others. Keep in mind that those are just color schemes no more no less. They do not apply to everything.
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"cosmic/#wrapping-up","title":"Wrapping up","text":"
That's it for now. If you would like to help out so we can bring it to the public, you are more than welcome to. Especially when it comes to the Hardware Checker part which requires a lot of testing that I cannot do due to limited hardware availability.
Cosmic is shaping up to be the DE that might break the current Top 2 (KDE and Gnome) making it the Top 3 DEs of all time. Who knows ? I wish the System76 team all the best.
Cheers !
","tags":["Linux","Cosmic","CosmicDE","XeroLinux","ArchLinux"]},{"location":"distro/","title":"The XeroLinux Distro","text":"","tags":["Linux","Distro"]},{"location":"distro/#xerolinux-distro","title":"\ud83d\udcbf XeroLinux Distro \ud83d\udcbf","text":"
Note
Check out the release notes and issues \u00bb Here. To access source code, head on over to the \u00bb XeroLinuxDev Org.
","tags":["Linux","Distro"]},{"location":"distro/#thank-you","title":"Thank you","text":"
Before we begin, I would like to tell everyone of you who has supported the XeroLinux project by either getting the ISO or some merch, how much your simple act of kindness means to me. I cannot put it into words. So all am gonna say is God bless you all. I hope your kindness is reciprocated. \ud83d\ude4f\u2764\ufe0f
In case you haven't gotten your copy yet, check out how to \u00bb Here.
","tags":["Linux","Distro"]},{"location":"distro/#information","title":"Information","text":"
This is the famous XeroLinux Distro. It's a culmination of everything you see here, like the Xero Toolkit, The Plasma Install Script & the Xero Layan Rice. All combined as an easy to install Arch+KDE Distro.
","tags":["Linux","Distro"]},{"location":"distro/#is-it-any-special","title":"Is it any Special?","text":"
This is a common question I get. To be honest, there\u2019s no groundbreaking advantage\u2014it simply provides an easier way to install Arch with a polished KDE experience right out of the box, which many users seem to appreciate. I created it specifically for them, as an alternative to my DIY install script, and as a way for you to support my journey.
.// The Wiki \\\\.","tags":["Linux","Distro"]},{"location":"distro/#installation","title":"Installation","text":"
Warning
When it comes to Encryption, I haven't tested it thoroughly. Use at your own Risk! Calamares is meh when it comes to that. All I know is it's extremely limited. It can't ecrypt both boot n root, just one or the other. Am sorry I test what I can. Please report any findings to me on Discord.
To install the distro, all you have to do is use the tried and true Ventoy to put ISO on & boot, that way you have Grub as fallback in case SystemD-Boot fails. If you burn using Etcher or similar tools there will be nothing to fall back to. Just an FYI.
Calamares will auto-launch on boot. Just go through the motions and when you get to the user creation page, if you select the Autologin option, you will be logged in to an X11/Xorg session, not Wayland, we chose that for compatibility with legacy hardware nothing more. Yes you can still switch to Wayland post-install, just use the toolkit, it's under option 7. System Troubleshooting & Tweaks >> 6. Change Autologin Session X11/Wayland (SDDM) and select Wayland, reboot, done.
Anyway, the installer is and will always function in offline mode, meaning that while no actual Internet connection is required during install, it's highly recommended you do have one in order to be able to update later on. Also, the currently supported Filesystems are, ext4, btrfs and xfs. I don't know much about btrfs so I will try my best to help there, just do not expect me to have all the answers regarding it, sorry.
We have also had no choice but to disable the Swap\u00b1Hibernate options due to an ongoing issue with latest version of Calamares. Will be re-added at some point in the future. Until then you can still use Swap File only if you have 8GB or less RAM otherwise it would be a waste of space.
That's it, there ain't much to it. Launch our toolkit from the dock, update system first, and have fun shaping the distro to your liking...
","tags":["Linux","Distro"]},{"location":"grub/","title":"XeroLinux Grub Themes","text":"","tags":["Grub","Linux"]},{"location":"grub/#grub-themes-script","title":"\ud83c\udfad Grub-Themes Script \ud83c\udfad","text":"","tags":["Grub","Linux"]},{"location":"grub/#information","title":"Information","text":"
This is a simple script, that will allow you to install any of the Grub themes I have created in the past. They will not be updated, that's just a relic of time past lol.
.// The Wiki \\\\.","tags":["Grub","Linux"]},{"location":"grub/#installation","title":"Installation","text":"
I included a script that makes installing them much easier, just follow steps below :
1- Git Clone the repo & run script like so
git clone https://github.com/xerolinux/xero-grubs\ncd xero-grubs/ && sudo ./install.sh\n2- Select one of the 8 themes, watch the magic. 3- Reboot your system and see the theme in action !
Be very careful playing with your bootloader. I made sure they work. Beyond that it's on you. This is provided as is with no warranty whatsoever...
","tags":["Grub","Linux"]},{"location":"plasma/","title":"Plasma-Install Script","text":"","tags":["Linux","Plasma","XeroLinux","ArchLinux"]},{"location":"plasma/#plasma-install-script","title":"\ud83d\udcbb Plasma-Install Script \ud83d\udcbb","text":"
Note
This does not require a Wiki page, it's here for reference as it has a full in-depth guide with a video included, on our Official Site where we go over each step in detail. Follow it closely for best experience. I might port back to here in the future.
","tags":["Linux","Plasma","XeroLinux","ArchLinux"]},{"location":"plasma/#what-it-is","title":"What it is","text":"
With the help of this script, you will be able to install Plasma in one of 4 methods as you can see in the image below. Not only that, but it will also fix PipeWire and Bluetooth.
This script has an option to include my repo, Chaotic-AUR's & Toolkit. Toolkit also includes the option to apply my rice. So if you opt to include it, you do not need to get other projects/tools separately. It\u2019s meant as an All-in-One solution.
","tags":["Linux","Plasma","XeroLinux","ArchLinux"]},{"location":"rice/","title":"XeroLinux Layan KDE","text":"","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#layan-kde-rice","title":"\ud83c\udfa8 Layan KDE Rice \ud83c\udfa8","text":"
Warning
I would like to clarify one very important aspect of ricing. We use custom themes, and those might not get updated very often, if at all by their respective developers/artists, which might result in some parts of the system and apps not to get themed correctly. That, my friends, is unfortunately out of our hands.
","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#information","title":"Information","text":"
This is my complete conversion script, that will transform your KDE Plasma into something out of this world. I spent days, nay weeks optimizing it for best performance and stability. Some bugs may remain, please report them.
","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#performance","title":"Performance","text":"
As mentioned, this rice has been throughly optimized for best performance on higher-end systems.. Although it might work on lower-end ones, for better performance I do not recommend that you use it there. So please do not report any performance issues.
.// The Wiki \\\\.","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#installation","title":"Installation","text":"
Install At Own Risk!!!. As of now it supports Plasma 6.x.x. If you notice any issues and report them via issue tracker on here and I will do my best to address them. To apply the rice, please follow the commands posted below. You will need either Paru or Yay (installed via my toolkit). Keep in mind that this will replace some files. Read below...
git clone https://github.com/xerolinux/xero-layan-git\ncd xero-layan-git/ && ./install.sh\n","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#backing-up","title":"Backing up","text":"
The install script will backup some app settings & all system ones before applying and overriding them with new ones, you will be able to restore what you need from the backup, so please do not report that. You have been warned. In case of any issues please find us on our Discord. Best of luck !
I would recommend you keep the folder backed up somewhere since it will get deleted once script is done with execution. That way, when I announce updates all you will have to do is git pull, like so...
cd xero-layan-git/ && git pull\n","tags":["Linux","Ricing","Plasma"]},{"location":"rice/#elements-used","title":"Elements Used","text":"
The rice uses the Layan GTK / KDE Theme & Tela Circle Icons by VinceLiuice. As for Widgets AkA Plasmoids, it uses Apdatifier, Netspeed, Quick Shutdown, Toggle Overview and Wunderground PWS.
Adding any more would start causing issues IMO. I kept it at a minimum for balance and stability. You are free to add more, remove what you do not need etc.. This is just a good base. Finally do not report issues to me, I am not the one who created any of the elements used, report upstream to respective Devs. Thanks.
","tags":["Linux","Ricing","Plasma"]},{"location":"xlapit/","title":"XeroLinux Toolkit","text":"","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#xero-post-install-toolkit","title":"\ud83d\udc27 Xero Post-Install Toolkit \ud83d\udc27","text":"
Warning
It's crucial to clarify that this toolkit isn't intended for custom Arch-Based distros. While some elements might function, I can't ensure seamless compatibility due to potential conflicts arising from differing tweaks and repositories. To ensure optimal performance.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#what-it-is","title":"What it is","text":"
This toolkit aims to be an all-in-one solution for post-installation, expediting your Arch setup. It's offered as use at your own risk type of thing, without much support. You will have to rely on yourself and your own knowledge and ability to do research your setup.
Toolkit recieves a lot of updates on almost a daily basis. Use above video just as a reference not an absolute lol. I keep getting ideas which I immediately implement. Due to the amount of changes I cannot keep a changelog, sorry. Too many to keep up with.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#how-to-get-it","title":"How to get it","text":"
First off let me say that everything this awesome toolkit provides is and will forever be optional and up to you the user. I will never force anything on you.
Tip
Don't just run script, without inspecting it first. So before using Curl command below you can examine it => HERE. It will always be provided as is without any Warranty of any kind. If you need support you know where to find me. Hint : \"check the footer for links\".
Now, once you have inspected the code, just run this simple curl command to get started :
bash -c \"$(curl -fsSL https://tinyurl.com/xtoolkit)\"\nIt will prompt you before injecting as in adding the XeroLinux repository, where from it will then prompt you, should you agree, as to which AUR helper you prefer, then proceed to do so then install and launch the toolkit.. Again only if you agree..
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#acessing-toolkit","title":"Acessing Toolkit","text":"
You can access toolkit by either typing xero-cli -m in terminal or from the application menu via the XeroLinux Post Installation Toolkit shortcut.. Just close terminal window once done using it lol ;)
.// The Wiki \\\\.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#system-setup","title":"System Setup","text":"
This is the initial setup part where you set the most common things up and/or install Package managers...
- Initial Setup Section
option description Update System Will guide you through system update via 1 of 3 methods. PipeWire/Bluetooth Missing PipeWire/Bluetooth Packages not offered by ArchInstall. Activate Flathub Enables Flathub which is required by the toolkit. Enable multithread compilation. Sets compilation to use all Cores/Threads for faster building.
- GUI Package Managers
Although some DEs like Gnome and KDE Plasma come with their own GUI package manager, they have some limitations. That's why I decided to include others that give us more freedom. See below...
option description OctoPi Installs Octopi. PacSeek Installs PacSeek Incl. PacFinder. Bauh Installs Bauh.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#system-drivers","title":"System Drivers","text":"
Well this section is dedicated to Drivers like GPU, Printer, Samba, Scanner & Game controllers. Below are more details on various options.
option description GPU Will guide you prompts to set up your GPU drivers. Printer Installs all the necessary ones that will cover most cases. Check AUR for others. Samba Installs a meta package I have created that covers most cases. Scanner Installs a meta package by myself for most people. Check AUR for others. Tailscale Installs Tailscale with fix for XeroLinux. DeckLink & StreamDeck Installs driver for Decklink, DeckMaster or StreamDeckUI (AUR).","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#distrobox-docker","title":"Distrobox / Docker","text":"
This will allow you to set either one up in case you want to test one or all of the Distros offered or use containerized apps for self-hosting.
option description Docker Installs and configures Docker, Docker-Compose, Docker-BuildX and LazyDocker. Will be prompted if you want Podman Desktop Distrobox Installs Distrobox with BoxBuddy which will allow you to deploy the offered Distro containers.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#system-customization","title":"System Customization","text":"
That's where the fun stuff begin, yep as you might have realized by now, I love customizing my DE that's why I use KDE Plasma. So if you want to customize your experience that's where you do it from.
- Shell / Prompts
option description Fastfetch Installs Fastfetch with Custom settings. Fish Shell Installs the Fish Shell with stock settings. OhMyPosh Installs OhMyPosh with Custom settings. ZSH AlinOne Installs ZSH with OhMyZSH and OhMyPosh and plugins. Gnome Extenstion Tools Installs Gnome's Extension Manager.
- DE/WM Ricing
option description XeroLinux KDE Rices Will let you apply my Layan KDE Rice. Theme has been ported to Plasma 6 Hyprland Dot Files Will offer you 3 Hyprland dots to choose from, linking you to their respective Git.
In closing, this section will be updated to include some useful customization features as time goes by..
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#game-launchers","title":"Game Launchers","text":"
Are you an avid gamer ? That section has you covered, allowing you to install the launcher(s) you need to get up and running in no time. Now you will have a choice of installing either the Flathub version officially supported by the devs or the unofficial Native version.
- Game Launchers
Tip
For Steam it will also apply the Fast Download Patch which will allow you to download games using the entirety of your connection. Keep in mind that this might choke it a bit so better wait for download to be done before attempting to watch any YouTube videos lol...
option description Steam Installs Steam All-in-One with Mangohud, Goverlay & Gamemode. Game Controller Installs any of ds4drv for PS4 Controller, dualsensectl for PS5's DualSense Controller or xone-dkms for the XBox-One Controller. Lutris Installs Lutris. Heroic Installs Heroic. Bottles Installs Bottles. Protonup-qt Installs Protonup-qt.","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#recommended-packages","title":"Recommended Packages","text":"
Warning
The System Tools option will just go ahead and install everything in it. I only selected the important stuff nothing big or unnecessary from both Arch Repos and the AUR, so might take abit to install everything depending on your specs. For transparency I included the list below the table so you know what's gonna be installed on your system should you opt to install.
- Various Extra Pkgs
option description LibreOffice Installs LibreOffice Fresh version. Web Browsers A selection of Web-Browsers. System Tools Installs a \"set of packages\" essential for a fully functional system. Development Tools Installs your choice of Development tools. Photography & 3D Installs your choice of Image and 3D Tools. Music/Audio Installs your choice of Audio & Video Tools. Social-Media Installs your choice of Chat clients. Virtualization Installs either VirtualBox or Virt-Manager. Video & Editing Installs any of Video tools. OBS-Studio includes a list of commonly used plugins.
System Packages list :
linux-headers downgrade mkinitcpio-firmware hw-probe pkgstats alsi update-grub expac linux-firmware-marvell eza numlockx lm_sensors appstream-glib bat bat-extras pacman-contrib pacman-bintrans yt-dlp gnustep-base parallel dex make libxinerama logrotate bash-completion gtk-update-icon-cache gnome-disk-utility appmenu-gtk-module dconf-editor dbus-python lsb-release asciinema playerctl s3fs-fuse vi duf gcc yad zip xdo inxi lzop nmon mkinitcpio-archiso mkinitcpio-nfs-utils tree vala btop lshw expac fuse3 meson unace unrar unzip p7zip rhash sshfs vnstat nodejs cronie hwinfo hardinfo2 arandr assimp netpbm wmctrl grsync libmtp polkit sysprof gparted hddtemp mlocate fuseiso gettext node-gyp graphviz inetutils appstream cifs-utils ntfs-3g nvme-cli exfatprogs f2fs-tools man-db man-pages tldr python-pip python-cffi python-numpy python-docopt python-pyaudio xdg-desktop-portal-gtk\n","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#troubleshooting","title":"Troubleshooting","text":"
Now am not gonna go over everything this section does, suffice it to say that this is a place that contains most troubleshooting options. Here's a list...
1. Install & Activate Firewalld.\n2. Clear Pacman Cache (Free Space).\n3. Restart PipeWire/PipeWire-Pulse.\n4. Unlock Pacman DB (In case of DB error).\n5. Activate v4l2loopback for OBS-VirtualCam.\n6. Change Autologin Session X11/Wayland (SDDM).\n\na. Build Updated Arch ISO.\nw. WayDroid Installation Guide.\nm. Update Arch Mirrorlist, for faster download speeds.\ng. Fix Arch GnuPG Keyring in case of pkg signature issues.\n","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#gpu-driver-notes","title":"GPU Driver Notes","text":"
When it comes to GPU Drivers, toolkit covers most common setups. It currently does NOT cover Hybrid ones. For those you will have to consult online documentation, sorry. Anyway, by answering the prompts correctly you will have your system(s) up and running in no time at all. Even Kernel modules will load for nVidia. If you have any issues let me know here...
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#3rd-party-kernel-support","title":"3
rd Party Kernel Support","text":"
No 3rd party Kernels are provided by this toolkit. So if you install any, please remember to include their headers for seamless functionality of anything that relies on DKMS (Dynamic Kernel Modules).
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#how-to-contribute","title":"How to Contribute","text":"
If you can/want to Contribute your knowledge improving this toolkit taking it above and beyond, making it the defacto for every Arch user, please see Here for more information.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]},{"location":"xlapit/#toolkit-credits","title":"Toolkit Credits","text":"
Main menu is written in Rust thanks to OgloTheNerd. And some contributions were made by a friend of the project It-A-Me. Thanks to them this Toolkit wouldn't have reached this point.
","tags":["Linux","Toolkit","XeroLinux","ArchLinux"]}]}
\ No newline at end of file
diff --git a/site/xlapit/index.html b/site/xlapit/index.html
index 84dae03..9c13b3b 100644
--- a/site/xlapit/index.html
+++ b/site/xlapit/index.html
@@ -109,7 +109,7 @@
-
+
Skip to content
@@ -289,6 +289,8 @@
+
+
@@ -317,6 +319,8 @@
+
+
.//🐧 The Post-Install Toolkit 🐧\\.
-
+
🐧 Xero Post-Install Toolkit 🐧
Warning
It's crucial to clarify that this toolkit isn't intended for custom Arch-Based distros. While some elements might function, I can't ensure seamless compatibility due to potential conflicts arising from differing tweaks and repositories. To ensure optimal performance.