My Dotfile repo

For syncing and sharing yet another arch + hyprland configuration

Some reqs / configured apps and utilities

• bash
• neovim
• kitty
• spicetify
• starship
• hyprland
  • hyprlock
  • hyprshot
• waybar
• qutebrowser
• mako
• kvantum
• qt6ct-kde

Install Instructions

1. setup up a base arch install,
   • recommended to have efivars and systemdboot
   • networkmanager
   • make a user account
2. install yay

sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

3. install these packages with yay

compositor and desktop

hyprland hypridle hyprlock hyprshot hyprpaper wofi kitty fastfetch waybar starship 

fonts

noto-fonts noto-fonts-cjk noto-fonts-emoji noto-fonts-extra ttf-jetbrains-mono-nerd

text, code, and pdf

nvim fzf zaread zathura-pdf-poppler stylua clangd

other tools

man stow brightnessctl gnome-keyring nm-connection-editor network-manager-applet pavucontrol pamixer blueman xdg-desktop-portal-hyprland

customization

kvantum nwg-look 

optional apps

qutebrowser nextcloud-client rnote discord thunderbird spotify spicetify-cli 

3. download dotfiles

cd ~
mkdir .config # Important for not adding undesireable dotfiles 
git clone https://github.com/usymmij/dotfiles
cd dotfiles
git submodule update --init
cp -r ./* ../ # copy all the dotfiles to the main directory
stow . --adopt # OPTIONAL: symlink them

make sure to also untrack these files

git update-index --assume-unchanged .config/cyclebackground/current_background 
git update-index --assume-unchanged .config/hypr/local.conf
git update-index --assume-unchanged .config/nvim/lazy-lock.json

Login

Default

• by default, this config is configured start once logged in from tty1 without a display manager

Autologin

• to configure autologin on tty, find getty@tty1.service or getty@tty1.service.d in /etc/systemd/system/ or one of its subdirectories, and add to the config the following

[Service]
ExecStart=
ExecStart=-/sbin/agetty --noreset --noclear --autologin username - ${TERM}

• Referenced from the Arch wiki

Auto lock

• add exec-once = hyprlock to the hyprland config to launch to a locked screen

References

gnu stow

nice video about stow link

hyprland

many configs are modified or directly from SolDoesTech's HyprV2

Nvim

kickstart.nvim

Common Configurations and Issues

Updating submodules

git submodule update --recursive

Spicetify

• under .config/spicetify/Themes, make sure to install spicetify-themes
• make sure that the themes are in the Themes folder, not the new one git created
• you can use the following commands

cd ~/.config/spicetify/Themes
git clone https://github.com/spicetify/spicetify-themes .

ssh client alias

• to use the ssh orca alias, add ORCA_SSH_IP=<ip address> and ORCA_SSH_PORT="<port number>" to /etc/environment
• then, generate a new ssh key, and store it as ~/.ssh/orca
  • add orca.pub to ~/.ssh/authorized_keys on the target server

secure boot configuration

• sbctl

Theme

I like the themes made by Eliver Lara

• candy-icons
• Sweet KDE theme (Kvantum)
  • Sweet GTK theme

Environment Variables

/etc/environment

• ORCA_SSH_IP=<ip address>
• ORCA_SSH_PORT=<port number>

pairing the same bluetooth device to both windows + linux when dual booting

read this

Steam Crashing

• As of 2025, the steam login webhelper crashes with some GTK theme configurations
  • see here
  • this only happens to the login webhelper - the workaround was to change the widget, icon, and cursor themes to Adwaita first, then login, then set them back to the custom theme. Autologin works fine.

setting the theme with kvantum, qt6ct, and nwg-look

1. install both kvantum and qt6ct, then the theme and icons
   • qt6ct-kde sometimes fixes various issues
2. unzip the icons in ~/.icons (or /usr/share/.icons/ or ~/.local/share/.icons)
   • theme can go anywhere, but I like to match icons
3. run kvantum, then install and apply the theme (it wont show until you set qt6ct as well)
4. use qt6ct to apply the kvantum theme, then the set the right icon theme as well

• this sets the theme for qt6 apps
• to set the same theme for gtk apps, use nwg-look

1. set widget theme to Sweet-Gtk
2. set candy-icons in Icon Theme

ignoring system specific changes in git

# removing a file
git update-index --assume-unchanged file_name

# adding a file back
git update-index --no-assume-unchanged file_name 

# see what files are assumed unchanged
git ls-files -v | grep '^[[:lower:]]'