Personal Arch Linux dotfiles.
Opinionated, minimal, and built around my own workflow.
curl -s https://raw.githubusercontent.com/X3ric/usr/refs/heads/main/.local/share/bin/archx | python3 - setup --yes
Then run:
archx
Open Configs from the menu to install dotfiles, update configs, manage services, use Wi-Fi helpers, and run post-install tools.
Use another usr repository:
ARCHX_USR_REPO="https://github.com/YOU/usr.git" archx setup --yes
Use a specific branch or tag:
ARCHX_USR_REPO="https://github.com/YOU/usr.git" ARCHX_USR_REF="main" archx setup --yes
Use a local clone:
ARCHX_USR_DIR="$HOME/my-usr" archx setup --yes
Hyprland is the default Wayland setup.
Main config layout:
~/.config/hypr/hyprland.conf ~/.config/hypr/conf.d/00-env.conf ~/.config/hypr/conf.d/10-startup.conf ~/.config/hypr/conf.d/20-monitor.conf ~/.config/hypr/conf.d/30-input.conf ~/.config/hypr/conf.d/40-look.conf ~/.config/hypr/conf.d/50-layouts.conf ~/.config/hypr/conf.d/60-binds.conf ~/.config/hypr/conf.d/70-rules.conf ~/.config/hypr/custom.conf
Put machine-specific monitor, input, and app overrides in custom.conf.
Workspace-local window cycling:
SUPER + Up previous window SUPER + Down next window
GTK: darkarch, based on Adwaita Amoled
Cursor: cz-Hickson-Black
Icons: Papirus
Colors are synced with walset, pywal, Waybar, Dunst, Kitty, and Hyprland borders.
archx: ArchX installer, updater, and dotfile toolbox.
walset: wallpaper and theme color setter.
ttywal: TTY color helper.
rofi-hud: global menu / rofi HUD helper.
record: screen and region recording helper.
explain: aliases, functions, and helper command notes.
plugins: toggle .zsh plugin files.
ytm-dl: download MP3 files with thumbnails using yt-dlp.
walset -w: select a wallpaper.
walset -wc: generate colors from the selected wallpaper.
xrandr-set: permanently set the primary display.
record: pick a region and record video.
explain: show available aliases, functions, and helper notes.
More helpers are listed by running explain.
