☕ sᴜᴘᴘᴏʀᴛ ᴍʏ ᴡᴏʀᴋ

or Ko-Fi: https://ko-fi.com/darkkal
Means a lot, tysm <3

setup​​  •  ​keybinds​  •  ​galley  •  ​credits

---

☕ ᴛʜᴇ ᴠɪꜱɪᴏɴ​ A cozy rice to keep things comfy. I honestly think Qtile is way too underrated—being able to script your whole environment in Python is a superpower, and there's so much you can do with it. This is my take on showing off those possibilities with some clean, modern aesthetics. 🍁 ᴄᴏʀᴇ ʜɪɢʜʟɪɢʜᴛꜱ ​ Dynamic Themes: pywal handles the heavy lifting—it pulls colors from your wallpaper and themes the whole system automatically. System Aware: The bar is smart enough to know if you're on a Laptop or PC, so it swaps the battery and network widgets for you. Easy Deployment: The installer script sets up everything—from GPU drivers to fonts and dotfiles—so you can get comfy faster.

📚 ᴛʜᴇ ꜱᴛᴀᴄᴋ​ Component Choice Window Manager Qtile Compositor Picom Terminal Alacritty Launcher Rofi Shell Zsh + Starship Notifications Dunst File Manager Thunar Display Manager SDDM (Custom Themes) Audio MPD + Ncmpcpp + Cava

---

☁️ ᴅᴇᴘʟᴏʏᴍᴇɴᴛ ☁️

🌿 ᴛʜᴇ ᴀᴜᴛᴏᴍᴀᴛᴇᴅ ᴘᴀᴛʜ (ᴀʀᴄʜ ʟɪɴᴜx)

Tip

Recommended: For the purest experience, an automated installation script is provided. It handles AUR helpers, dependencies, custom SDDM themes, font caching, and Zsh configuration automatically.

# 1. Fetch the repository
git clone https://github.com/Darkkal44/Cozytile.git ~/.srcs/Cozytile
cd ~/.srcs/Cozytile

# 2. Run the deployment script
chmod +x install.sh
./install.sh

Important

Once the script finishes, you'll be greeted by SDDM. Select Qtile (Xorg) from the top-left corner before logging in. Do not use Qtile Wayland!

🌿 ᴛʜᴇ ᴍᴀɴᴜᴀʟ ᴘᴀᴛʜ

If you prefer knowing exactly what goes into your system or are adapting this setup for another OS, here is the exact manual breakdown of what the installer does.

1. Base System Update & AUR Helper: If on Arch, ensure your system is updated and you have an AUR helper yay or paru installed:

sudo pacman -Syu --noconfirm
sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/paru.git ~/.srcs/paru
cd ~/.srcs/paru && makepkg -si

2. Core Dependencies & Fonts: Install the window manager, compositor, terminal, aesthetic tools, and all the required nerd fonts.

paru -S --needed qtile python-psutil pywal-git qt5-graphicaleffects picom dunst zsh starship mpd ncmpcpp playerctl brightnessctl alacritty pfetch htop flameshot thunar roficlip rofi ranger cava neovim vim feh sddm qt6-5compat qt6-declarative qt6-svg pipewire pipewire-pulse pamixer ttf-jetbrains-mono-nerd ttf-hack-nerd ttf-font-awesome ttf-firacode-nerd ttf-icomoon-feather

3. [OPTIONAL] Adjusting Configurations by Device:

• Laptop users: Skip this entire step, as the default widgets are configured for you.
• PC users: You can manually swap the battery module with the network module below. Make sure to apply this change to your main config (~/.config/qtile/config.py) as well as any individual theme configs located in ~/Themes/ subfolders.

Click for Desktop (Network) Widget Code

widget.Net(
    font="JetBrainsMono Nerd Font Bold",
    fontsize=13,
    background="#353446",
    foreground="#CAA9E0",
    format=' {up}{up_suffix}  {down}{down_suffix}',
)

4. Dotfiles & Config Placement: Fetch the setup and copy the necessary directories sequentially. Be sure to back up any existing files first!

git clone https://github.com/Darkkal44/Cozytile ~/.srcs/Cozytile
cd ~/.srcs/Cozytile

# Replicate configurations
cp -ra .config/* ~/.config/
cp -ra Wallpaper ~/
cp -ra Themes ~/
cp -a .zshrc ~/

5. Update the Font Cache: Since we installed multiple fonts, rebuild the cache so Qtile and Alacritty can see them:

fc-cache -fv

6. Graphics Drivers: Install the Xorg display server and proper drivers for your specific GPU.

# For Intel:
sudo pacman -S --needed xorg xorg-xinit xf86-video-intel

# For AMD:
sudo pacman -S --needed xorg xorg-xinit xf86-video-amdgpu

# For NVIDIA:
sudo pacman -S --needed xorg xorg-xinit nvidia-settings nvidia-utils

7. Shell Framework (Zsh + Oh-My-Zsh): Initialize your shell aesthetics and install the required plugins.

chsh -s $(which zsh)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended 
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

8. SDDM Display Manager & Custom Themes: Enable SDDM, inject the handcrafted Cozy themes into the system theme directory, and allow your user to change SDDM themes without password authentication.

# Copy themes
sudo mkdir -p /usr/share/sddm/themes /etc/sddm.conf.d
sudo cp -r sddm-themes/* /usr/share/sddm/themes/

# Set 'Cozy' as the active theme
echo -e "[Theme]\nCurrent=Cozy" | sudo tee /etc/sddm.conf.d/theme.conf

# Setup sudoers automation for SDDM changes from UI
echo "$USER ALL=(ALL) NOPASSWD: /usr/bin/tee /etc/sddm.conf.d/theme.conf" | sudo tee /etc/sudoers.d/cozytile-sddm
sudo chmod 440 /etc/sudoers.d/cozytile-sddm

# Enable SDDM service
sudo systemctl enable sddm

9. Preload Wallpaper Cache: To ensure system colors are ready to go immediately, generate pywal color caches for the included wallpapers.

wal -b 282738 -i ~/Wallpaper/Aesthetic2.png
wal -b 232A2E -i ~/Wallpaper/fog_forest_2.png
wal -i ~/Wallpaper/claudio-testa-FrlCwXwbwkk-unsplash.jpg
wal -b 282738 -i ~/Wallpaper/120_-_KnFPX73.jpg
wal -i ~/Wallpaper/a_road_going_through_a_desert.jpeg
wal --theme ~/.cache/wal/e-ink.json

10. Finalize & Reboot: The most important step! Reboot your system to apply all changes and start your new journey with Cozytile!

sudo reboot

---

⌨️ ɴᴀᴠɪɢᴀᴛɪᴏɴ ᴍᴀᴛʀɪx ⌨️

Master your environment from the keyboard.

Focus & Groups	Window & Layout	System & Apps
Super + h/j/k/l Move Focus Super + [1-8] Switch Group Super + Shift + [1-8] Move to Group Super + Space Next Window Super + f Fullscreen	Super + Ctrl + h/j/k/l Shift Window Super + Shift + h/j/k/l Resize Window Super + n Normalize Sizes Super + Shift + Enter Toggle Split Super + Tab Next Layout Super + c Kill Window	Super + Enter Alacritty Terminal Super + r Rofi App Launcher Super + p Rofi Powermenu Super + t Theme Switcher Super + h Clipboard Manager Super + e Thunar File Manager Super + s Flameshot (Screenshot) Super + Ctrl + r/q Reload / Quit

---

🌙 ᴄʀᴇᴅɪᴛꜱ ᴀɴᴅ ɢʀᴀᴛɪᴛᴜᴅᴇ 🌙

A massive thank you to the Unixporn Discord community for the endless support and inspiration! This project wouldn't be the same without the kindness and knowledge shared there.

ꜱᴘᴏɴꜱᴏʀꜱ

• Dominik — A huge thank you for your incredible kindness and the generous tip! ☕

ᴄᴏɴᴛʀɪʙᴜᴛᴏʀꜱ

• phiumphium — My good friend who spent countless hours helping me squash bugs and polish the experience. 🛠️

ꜱᴘᴇᴄɪᴀʟ ᴛʜᴀɴᴋꜱ

For their help with various some silly things:

• Namish
• Stardust
• Kaizky

---

Enjoy your stay. Keep it cozy.