Warning

these dotfiles are personalised to my liking and may need to be tweaked to adjust to yours intallation may also cause some errors that need to be fixed. (dont take that long) Recommended to backup YOUR dotfiles before installing

Hyprland Rice

Welcome to my Hyprland Rice configuration! This setup is designed to provide a clean, efficient, and visually appealing desktop environment. I use these configs daily so if somthing breaks due to an update (like the weird titling one in march/may 2026 and the awww rename) i will update everything on my laptop AND here

Dependencies

• Window Manager: Hyprland - A dynamic tiling Wayland compositor.
• Compositor: Wayland for smooth and modern graphics.
• Terminal: Kitty - A fast, feature-rich, GPU-based terminal emulator.
• Launcher: Wofi - A Wayland-native application launcher.
• Bar: Waybar - A highly customizable status bar.
• Notifications: Mako - A lightweight Wayland notification daemon.
• Color Scheme Generator: Pywal16 - A tool to generate and apply color schemes based on your wallpaper.

Screenshots

Installation

1. Clone this repository:

   git clone https://github.com/markart25/markdots
   cd markdots

2. Install the required dependencies:

   sudo pacman -S hyprland kitty wofi waybar mako zsh ttf-jetbrains-mono ttf-jetbrains-mono-nerd awww hypridle cliphist
   yay -S python-pywal16

3. Optional cool apps:

   sudo pacman -S fastfetch asciiquarium cmatrix btop

4. Include in ~/.zshrc (if u use zsh) config to include fastfetch on open terinal (OPTIONAL)

   echo -e '\n#open fastfetch on terminal start\nfastfetch' >> ~/.zshrc

   to check which shell you're using:

   echo $SHELL
   echo $0

   so the command above $SHELL is the shell in TTY and $0 is the current open shell. I recomend running this after you are in hyprland so you can actually check which shell you are using in hyprland. for me $SHELL is bash but $0 in hyprland is zsh but $0 in TTY is also bash. For me i have put fastfetch in both the bash and zsh config so when i login i can see fastfetch and when i open terminal in hyprland i also see it

   to run fastfetch every time a new terminal opens, add these two lines (1st is optional) to your shell config:

   # open fastfetch on terminal start 
   fastfetch

   Shell	Config File
   zsh	~/.zshrc
   bash	~/.bashrc
   fish	~/.config/fish/config.fish

5. Copy the configuration files to their respective locations and create pywall colours:

   cp -r .config/* ~/.config/
   wal -i ~/.config/wallpapers

6. Update the Waybar and Wofi configuration (important): If your Waybar and Wofi configuration references a CSS file like: (found in ~/.config/waybar/css/colors.css and ~/.config/wofi/style.css both in the first line)

   @import "/home/mark/.cache/wal/colors-waybar.css";
   

   make sure to replace "mark" with your actual username if you dont do this wofi and waybar may not look correctly.

7. Restart your session and enjoy your new setup!

Enjoy your Hyprland rice!

Extra Info

Keybinds

Modifier key ($mainMod) is SUPER (Windows key).

Apps & Scripts

Keybind	Action
SUPER + Q	Open terminal (kitty)
SUPER + A	App launcher (wofi)
SUPER + E	File manager (dolphin)
SUPER + V	Clipboard history (cliphist)
SUPER + L	Lock screen (hyprlock)
SUPER + R	Set random wallpaper
SUPER + W	Wallpaper picker
Copilot key	Open Claude in Firefox (reclaimed from Microslop)

Window Management

Keybind	Action
SUPER + C	Close active window
SUPER + F	Toggle floating
SUPER + M	Exit Hyprland
SUPER + ← / → / ↑ / ↓	Move focus
SUPER + LMB drag	Move window
SUPER + RMB drag	Resize window

Workspaces

Keybind	Action
SUPER + [0-9]	Switch to workspace
SUPER + SHIFT + [0-9]	Move window to workspace
SUPER + Tab	Previous workspace
SUPER + ALT + ← / →	Cycle workspaces
SUPER + SHIFT + ← / →	Move window to adjacent workspace
SUPER + scroll	Scroll through workspaces

Media & Brightness

Keybind	Action
Volume Up/Down/Mute	Audio control (wpctl)
Mic Mute	Toggle mic
Brightness Up/Down	LCD brightness (brightnessctl)

Screenshots

Keybind	Action
SUPER + SHIFT + S	Screenshot region → ~/pictures/screenshots (also in CTRL + V)

Customization

Feel free to tweak the configuration files in the ~/.config directory to suit your preferences.

All important hyprland configs will be in ~/.config/hypr/config

fastfetch ascii

the file /home/mark/.config/fastfetch/rename-to-just-ascii-to-use can be renamed to ascii and will show up when you type in the terminal:

fastfetch

to learn keybinds

mainmod (usually windows key) + Q to open terminal. Then

cat ~/.config/hypr/configs/keybinds.conf

to veiw all keybinds in hyprland

errors

if there is an error with colours on firt start run (although you should have already ran this)

wal -i ~/.config/wallpapers

if there are any other errors you can report them on my discord found on my profile