Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/matiasOliva64/dotfiles-Hyprland-fedora/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through installing all required packages and deploying the dotfiles on a fresh or existing Fedora 43 system. The process backs up your existing configs before applying anything, so you can roll back if needed.
1

Install required packages via DNF

Install all runtime dependencies in a single command. This includes the Hyprland portal, status bar, terminal, notification daemon, launcher, power menu, screenshot tools, fonts, and the XWayland video bridge.
sudo dnf install xdg-desktop-portal-hyprland waybar kitty dunst wofi wlogout grim swappy \
  jetbrains-mono-fonts-all google-noto-emoji-color-fonts \
  libappindicator-gtk3 xwaylandvideobridge
2

Clone the repository

Clone the dotfiles repository to your home directory.
git clone https://github.com/matiasOliva64/dotfiles.git ~/dotfiles
cd ~/dotfiles
3

Back up existing configs and deploy new ones

Move your current configs into a backup directory, then copy the new configs into place.
# Back up existing configs
mkdir -p ~/.config/backup_old_dots
mv ~/.config/{hypr,waybar,kitty,dunst,wofi,wlogout} ~/.config/backup_old_dots/

# Deploy new configs
cp -r ~/dotfiles/{hypr,waybar,kitty,dunst,wofi,wlogout} ~/.config/
If any of those directories don’t exist yet, mv will skip them — that’s fine.
4

Set your wallpaper path in hyprpaper.conf

Open ~/.config/hypr/hyprpaper.conf and replace the hardcoded path with the path to your own wallpaper file.
# Change this line:
/home/matias/Imágenes/wallpaper.jpg

# To your own path, for example:
/home/youruser/Pictures/wallpaper.jpg
Save the file, then restart Hyprland or run hyprpaper to apply the change.
In hyprpaper.conf, change the wallpaper path to match your system. The default path /home/matias/Imágenes/wallpaper.jpg is specific to the original author’s machine and will not work as-is on your system.
The screenshot keybinds (Print for region capture, Shift + Print for full screen) save files via swappy. Create the Screenshots directory before using them so the files have somewhere to land:
mkdir -p ~/Pictures/Screenshots
If you prefer a localized path, you can use ~/Imágenes/Screenshots instead — just make sure it matches the path configured in your swappy settings.
The monitor line in hyprland.conf is set to monitor = , 1920x1080@144, auto, 1, which targets any connected display at 1920x1080 @ 144 Hz. If your primary monitor is not DP-1, uses a different resolution or refresh rate, or you have multiple displays, update this line before starting Hyprland. Refer to the Hyprland monitor documentation for the correct syntax.

Build docs developers (and LLMs) love