Setup Guide - Flottegurke/dotfiles GitHub Wiki

This is a complete setup guide for applying these dotfiles on Arch Linux.

Note

If you are using another distro, this guide should still work, if you use the package manager of your distro instead of pacman and yay.

📌 Prerequisites

Arch Linux installed (see OS Setup)

Important

As explained in the OS Setup, for these dotfiles to work, you need to install GNOME and hyprland.

Basic familiarity with Git, Stow, and the terminal
Sudo/root privileges

1️⃣ GRUB Optimization

Edit /etc/default/grub, set GRUB_TIMEOUT=2.

Rebuild config:

sudo grub-mkconfig -o /boot/grub/grub.cfg

2️⃣ Clone Dotfiles

1. Setup git (if not done already)

i. Set username, email and generate ssh-key:

git config --global user.name "<yourUsername>"
git config --global user.email "<[email protected]>"

ssh-keygen -t ed25519 -C "<[email protected]>"

ii. Add the newly generated ssh-key to your github profile

Clone dotfiles into ~/.config directory:

cd ~/.config
git clone [email protected]:flottegurke/dotfiles.git

Warning

the dotfiles only work, when cloned into the ~/.config directory.

3️⃣ Install Utilities

Install yay and other utilities using pacman:

sudo pacman -S yay playerctl wl-clipboard hyprpicker hyprland-qt-support hyprland-qtutils qt6-wayland qt5-wayland brightnessctl hyprpolkitagent ttf-cascadia-code-nerd pavucontrol hyprgraphics networkmanager cliphist udiskie wtype kooha dnsmasq socat sshpass ripgrep hyprpaper ly swaync starship bat fzf zoxide waybar hyprlock hypridle nwg-look rofi rofi-emoji rofi-calc tesseract tesseract-data-eng tesseract-data-deu tesseract-data-fra stow

Install additional utilities using yay:

yay -S xdg-desktop-portal-hyprland-git hyprshot overskride catppuccin-gtk-theme-mocha-revamped linux-wifi-hotspot-bin

Install self made utilities:

mkdir -p ~/Programming
cd ~/Programming
git clone [email protected]:flottegurke/ssh-tui.git
git clone [email protected]:flottegurke/flotte-linux-utils.git

4️⃣ Setup Utilities

Setup Displaymanager

Remove gdm and enable ly:

sudo pacman -Rns gdm
sudo systemctl enable ly.service

Automatically unlock keyring: Open /etc/pam.d/login/, add:

auth       optional     pam_gnome_keyring.sokeyring
session    optional     pam_gnome_keyring.so auto_start

Check `tesseract` (OCR)

Check if english, german and french language packages are installed:
```
tesseract --list-langs
```

If not, try to reinstall them:

sudo pacman -S tesseract-data-eng tesseract-data-deu tesseract-data-fra

5️⃣ Apply dotfiles

Remove the standard hyprland and ly configs:

sudo rm ~/.config/hypr/hyprland.conf
sudo rm /etc/ly/config.ini

Apply all custom dotfiles:
```
bash ~/.config/dotfiles/updateConfig.sh
```

Caution

This will replace the existing .bashrc and other configuration files. If you have any custom configs, remember to make a backup!

Style GNOME apps:

Open nwg-look:
```
nwg-look
```
Choose catppuccin-mocha-sapphire-standart+default theme
Choose CaskaydiaCove Nerd Font Regular 11 font
Choose prefer dark as color sceme
Click apply and exit

Add custom Backgrounds

To add your own wallpapers, add .jpg files into the ~/.config/hypr/wallpapers directory.

Tip

A wallpaper gets selected randomly at startup, to change it to another random one, press SUPER + w

For instruction on how to theme additional programs, see the Additional program themes page.

For instruction on how to setup a windows VM (to use windows exclusive programs) see the VM Setup page.

For an overview about all global keybindings, see the Keybindings page.