Skip to content

Meowix-Linux/Meowix-ISO

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

96 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Meowix has been discontinued

Please transition to a new distribution immediately. For more information, check out this post.


Meowix Linux ISOs

The repository that hosts the Archiso profile and ISO releases for Meowix Linux

GPLv3 License Arch Linux Base Catppuccin Mocha Theme BSPWM Window Manager

What's Meowix?

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!

Screenshot of the Meowix Linux desktop

Installation

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!

Downloading a release ISO

  1. Visit the Releases page.
  2. Scroll down until you see the first link that says something similar to meowixlinux-XX.YY-x86_64.iso.
  3. Click the link. Your download should then start.

Building the Archiso profile

You'll need an Arch Linux(-based) system to build a Meowix ISO.

  1. Install the archiso package:
sudo pacman -S archiso
  1. Clone this repository (you'll need to install git if you don't have it):
git clone https://github.com/Meowix-Linux/Meowix-ISO/
  1. Change directories into the repository:
cd Meowix-ISO/
  1. 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/

Installing Meowix

Burning the USB and booting to the live environment

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:

Connecting to the internet with WiFi

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.

Connecting to the internet with a mobile broadband (WWAN) modem

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.

Connecting to the internet through Ethernet, WLAN, or WWAN interfaces using DHCP

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.

Using the installer program

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.

Post installation

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.

License

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.