This repository contains my personalized configuration files ("dotfiles") for Arch Linux. These settings and scripts are designed to streamline my workflow according to my personal taste.
Note:
- I don’t provide an installer at this time. You will need to identify and install any required programs yourself, or remove shortcuts and settings you don’t need.
- Some configurations reference external applications or utilities. If those programs are not installed, related shortcuts or features may not function.
- Overview
- Prerequisites
- Installation
- Hyprland & Waybar
- Lf
- Alacritty & Zsh
- Wofi
- Vim
- Screenshots
- Contributing
- License
This collection of dotfiles aims to simplify my development and window management experience on Arch Linux. Each configuration has been tested on a fresh Arch installation and optimized for performance and usability. Feel free to adapt any file to suit your preferences.
Before using these dotfiles, ensure you have installed the following programs:
- Window Management & Status Bar
- Hyprland (Wayland compositor)
- Waybar (highly customizable status bar)
- Terminal & Shell
- Alacritty (GPU-accelerated terminal emulator)
- Zsh (shell)
- File Manager
- Lf (terminal file manager)
- Helper Tools
- wofi (file picker for Wayland)
- Editor
- Vim with a plugin manager (e.g., vim‑plug)
Install dependencies via Pacman or your AUR helper:
sudo pacman -S hyprland waybar alacritty zsh lf vim
yay -S wofi-
Clone the repository
git clone https://github.com/<your-username>/dotfiles-arch.git ~/.dotfiles-arch cd ~/.dotfiles-arch
-
Create symlinks
Create symbolic links from your home directory to the config files. Example script:
#!/usr/bin/env bash DOTFILES="$HOME/.dotfiles-arch" ln -sf "$DOTFILES/.zshrc" "$HOME/.zshrc" ln -sf "$DOTFILES/.vimrc" "$HOME/.vimrc" ln -sf "$DOTFILES/.config" "$HOME/.config"
-
Make scripts executable
Some helper scripts are included in the
.configdirectory. If you plan to use them, mark them as executable. Example:chmod +x ~/.config/hypr/Random_Image.sh -
Reload or restart your session
- For Zsh:
zsh -l - For Hyprland: restart your compositor or session
- For Zsh:
This section contains the Hyprland compositor configuration and a customized Waybar setup.
- Shortcuts for launching applications (e.g., Mod+Enter for terminal, Mod+Space for Firefox)
- Waybar modules for CPU, RAM, network speed, volume, date & time
- Edit
~/.config/hypr/hyprland.confto adjust keybindings, workspace layouts, and monitor setup - Modify
~/.config/waybar/configandstyle.cssto change bar layout, colors, and module order
Lf is a minimal, terminal-based file manager focused on simplicity and speed.
- Custom key mappings for file operations and navigation
- Preview pane for images and file contents
- Integration with external tools (e.g., fzf for fuzzy search)
- Edit
~/.config/lf/lfrcto adjust keybindings, preview commands, and default layout
This section covers my terminal emulator and Zsh shell configuration.
- Custom color schemes and font settings
- Configurable padding, transparency, and scrollback lines
- Personalized prompt
- Aliases and functions for Docker, Git, and system tasks
- Auto-suggestions and syntax highlighting via plugins
Wofi is an application launcher for Wayland, similar to Rofi but designed to work natively with Wayland compositors. It’s lightweight, simple, and highly configurable.
- Launch with a keyboard shortcut (e.g., Mod+D)
- Quick application launching
- Compatible with Hyprland and other Wayland compositors
- Offers both dmenu and drun modes
- Adjust appearance in
~/.config/wofi/style.css
My Vim setup includes curated plugins and settings for efficient editing.
- Install plugins to vim with
:PlugInstall
- File explorer (NERDTree)
- Fuzzy finder (fzf)
- Status line with vim-airline
- Edit
~/.vimrcto enable/disable plugins - Update plugin versions in
plug.vim
All screenshots are stored in the images/ directory. Feel free to browse them to see the dotfiles in action.
Contributions, issues, and feature requests are welcome! Open an issue or submit a pull request.
This project is released under the GNU General Public License v3.0 (GPL-3.0).



