Please transition to a new distribution immediately. For more information, check out this post.
The repository that hosts the Archiso profile and ISO releases for Meowix Linux
Meowix Linux is an Arch Linux-based distribution that heavily utilizes Catppuccin. From the official Catppuccin GitHub repository's README:
Catppuccin is a community-driven pastel theme that aims to be the middle ground between low and high contrast themes.
In particular, Meowix Linux uses the Mocha flavor of Catppuccin.
Meowix also uses the highly configurable BSPWM.
Meowix Linux aims to make the installation of a beautiful and efficient system easier than ever before!
Please note that Meowix is currently in early stages. Expect bugs. With that being said, you have two options to obtain an ISO: You can either download a release version of Meowix, or you can build a Meowix ISO yourself!
- Visit the Releases page.
- Scroll down until you see the first link that says something similar to
meowixlinux-XX.YY-x86_64.iso
. - Click the link. Your download should then start.
You'll need an Arch Linux(-based) system to build a Meowix ISO.
- Install the
archiso
package:
sudo pacman -S archiso
- Clone this repository (you'll need to install
git
if you don't have it):
git clone https://github.com/Meowix-Linux/Meowix-ISO/
- Change directories into the repository:
cd Meowix-ISO/
- Build the ISO:
sudo mkarchiso -v releng/
After the above command completes, there should be an ISO in the out/
directory. You can remove the work directory:
sudo rm -rf work/
To install the ISO, first burn it to a blank USB drive using a tool such as Popsicle, then restart and boot from the USB by selecting it as your boot device (refer to your motherboard's manual for details). Note that Secure Boot must be disabled to boot the live environment.
Wait for the root filesystem to be copied to RAM and for the system to boot. This could take 5-10 minutes.
When the wallpaper and status bar appears, connect to the internet:
Click on the WiFi module in the status bar to open the GUI wifi tool (iwgtk
).
Click the "Connect" button for the WiFi network you wish to connect to. This will prompt you for your password. After entering it and connecting, confirm your connection by checking the status bar's WiFi module (it may take a few seconds to update).
Press Super + W
to close the window.
There is no mobile broadband/WWAN modem GUI tool installed. If you need to connect using one, open a terminal with Super + Enter
and use the CLI utility mmcli
. Steps to use mmcli
are here.
The ModemManager configuration will not copy over to the installed system; you will need to reconnect after installation.
As there is no mobile broadband/WWAN modem module for the status bar, you can verify internet connectivity with ping
instead:
ping example.com
Consider adding a mobile broadband/WWAN modem module to the status bar (polybar
) after installation.
This should work automatically.
As there is no Ethernet/WLAN/WWAN module for the status bar, you can open a terminal with Super + Enter
and verify internet connectivity with ping
instead:
ping example.com
Consider adding a Ethernet/WLAN/WWAN module to the status bar (polybar
) after installation.
After connecting to the internet, press Super + D
to open the application menu, then start typing to search for "Install".
An option that says "Install System" should come up. Press enter.
Then, follow the steps in the installer. Make sure to keep your USB drive plugged in. When the installation process finishes, check the box to restart the system, then exit the installer. The system should restart automatically.
First, boot into your new system by selecting the new "Meowix" option as your boot device.
At this point, you can unplug the USB drive.
You should now see a display manager (login screen). Log in with the password you chose in the installer.
Wait for the system to start. You should now see a window open that will instruct you to enter your account password. Do so, then wait for some finalization tasks to finish up. Then you will need to select the layout that you want to use to arrange windows. Once again, do so.
After the post-install script finishes, you will be instructed to press any key to exit. Do so.
Congratulations! Meowix Linux is now fully installed on your computer and you can set it up to your heart's content.
This repository is licensed under the GPLv3 License. The Catppuccin theme is licensed under the MIT License. Licenses for other software included in the distribution are usually found within the files provided by their respective packages. If you have found that Meowix has violated any licenses or copyrights, please don't hesitate to open an issue on the repository/repositories that do so and we will do our best to respond in a timely manner.