And then I realized I can't run hyprland on top of Ubunut, ... not a thing that runs on top of that, I need arch....” — DHH
Challenge accepted.
Ubarchy is a modern Ubuntu-based environment with Hyprland, Waybar, and a full Wayland setup — blending the elegance of Ubuntu with the performance and aesthetics of tiling window managers.
This project proves that you can have the best of both worlds — Ubuntu and Hyprland — in one cohesive setup.
🧠 Project Philosophy
Ubarchy is built around simplicity, performance, and control — aiming to provide a simple user experience, arch like aesthetics, and perfect for developer use.
Built in my free time before starting university. Inspired by curiosity. Driven by challenge. Proving DHH wrong.
Ubarchy offers two ways to get started:
- Install fresh using the Ubarchy ISO
- Migrate your current Ubuntu machine to Ubarchy
git clone https://github.com/tawfiqkhalilieh/ubrachy
cd ubrachysudo ./install.sh-# Now logout to leave the gnome enviroment, and login from hyprland
sudo ./dots.shExpand a step by step package installation
If you already have Ubuntu installed and just want to upgrade it into the full Ubarchy environment, follow these steps.
git clone -b 24.10 --depth=1 https://github.com/JaKooLit/Ubuntu-Hyprland.git ~/Ubuntu-Hyprland-24.10
cd ~/Ubuntu-Hyprland-24.10
chmod +x install.sh
./install.sh
sudo apt install swaybg nvimsudo apt install \
clang-tidy \
gobject-introspection \
libdbusmenu-gtk3-dev \
libevdev-dev \
libfmt-dev \
libgirepository1.0-dev \
libgtk-3-dev \
libgtkmm-3.0-dev \
libinput-dev \
libjsoncpp-dev \
libmpdclient-dev \
libnl-3-dev \
libnl-genl-3-dev \
libpulse-dev \
libsigc++-2.0-dev \
libspdlog-dev \
libwayland-dev \
scdoc \
upower \
libxkbregistry-devgit clone https://github.com/Alexays/Waybar
cd Waybar
meson setup build
ninja -C build
./build/waybar
# Optionally install system-wide
sudo ninja -C build install
mkdir -p ~/.config/waybarsudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/
sudo sh -c 'echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install code
sudo apt install curl -y
curl -fsS https://dl.brave.com/install.sh | shsudo apt install xdg-desktop-portal-wlr xwayland wl-clipboard grim slurp -y
sudo apt install btop alacritty -y
sudo update-alternatives --config x-terminal-emulatorwget -O ~/discord.deb "https://discord.com/api/download?platform=linux&format=deb"
sudo apt install ~/discord.deb
sudo apt -f installOnce you’ve switched from GNOME to Hyprland, run these commands to configure your environment, themes, and aesthetics.
mkdir -p ~/.config/btop/themes
curl -L -o ~/.config/btop/themes/btop.conf https://raw.githubusercontent.com/tawfiqkhalilieh/ubarchy/refs/heads/development/btop/themes/btop.conf
curl -L -o ~/.config/btop/themes/btop.theme https://raw.githubusercontent.com/tawfiqkhalilieh/ubarchy/refs/heads/development/btop/themes/btop.theme
mkdir -p ~/.config/alacritty/
rm -rf ~/.config/alacritty/*.yaml
curl -L -o ~/.config/alacritty/alacritty.yml https://raw.githubusercontent.com/tawfiqkhalilieh/ubarchy/refs/heads/development/alacritty/alacritty.tomlcurl -L -o ~/Downloads/a.png https://raw.githubusercontent.com/basecamp/omarchy/refs/heads/master/themes/everforest/backgrounds/1-everforest.jpg
curl -L -o ~/.config/hypr/hyprland.conf https://raw.githubusercontent.com/tawfiqkhalilieh/ubarchy/refs/heads/development/hypr/hyprland.confcurl -L -o ~/.config/waybar/config.jsonc https://raw.githubusercontent.com/tawfiqkhalilieh/ubarchy/refs/heads/development/waybar/config.jsonc
curl -L -o ~/.config/waybar/style.css https://raw.githubusercontent.com/tawfiqkhalilieh/ubarchy/refs/heads/development/waybar/style.cssThis is the content of the collapsible section. You can include any Markdown-formatted text, lists, or code here.