Documentation Index Fetch the complete documentation index at: https://mintlify.com/joaopedroaa/dotfiles/llms.txt
Use this file to discover all available pages before exploring further.
This page documents the complete directory structure of the dotfiles repository and explains the purpose of each directory and its target location in the system.
Repository Root ~/dotfiles/ ├── .config/ # Application configurations ├── bin/ # Custom command-line utilities ├── home/ # Home directory dotfiles ├── boot/ # Bootloader configuration ├── etc/ # System configuration files ├── srv/ # Service data files ├── usr/ # System-wide binaries ├── .github/ # GitHub repository metadata └── sync.sh # Dotfiles synchronization script
Configuration Directories .config/ → ~/.config/ Application-specific configuration files following the XDG Base Directory specification.
Directory Application Purpose alacritty/Alacritty Terminal emulator configuration BetterDiscord/BetterDiscord Discord client customization cava/Cava Console audio visualizer doom/Doom Emacs Emacs configuration framework dunst/Dunst Notification daemon settings flameshot/Flameshot Screenshot tool configuration i3/i3 Window manager configuration i3blocks/i3blocks Status bar blocks kitty/Kitty Terminal emulator settings lf/lf Terminal file manager mpv/mpv Media player configuration nvim/Neovim Text editor configuration neofetch/Neofetch System information display polybar/Polybar Status bar configuration ranger/Ranger Terminal file manager redshift/Redshift Screen color temperature rofi/Rofi Application launcher xdg-desktop-portal/XDG Portal Desktop integration xmobar/Xmobar Status bar (alternative) xmonad/XMonad Window manager (alternative) zathura/Zathura Document viewer
Special .config/ Files File Target Location Purpose firefox/user.js~/.mozilla/firefox/vdhmokqy.default-nightly/user.jsFirefox preferences dolphin/dolphinrc~/.config/dolphinrcKDE file manager git/.gitconfig~/.gitconfigGit global configuration pavucontrol/pavucontrol.ini~/.config/pavucontrol.iniPulseAudio control picom/picom.conf~/.config/picom.confCompositor settings most/.mostrc~/.mostrcPager configuration tmux/.tmux.conf~/.tmux.confTerminal multiplexer yakuake/yakuakerc~/.config/yakuakercDrop-down terminal user-dirs.dirs~/.config/user-dirs.dirsXDG user directories plasma-localerc~/.config/plasma-localercKDE locale settings
bin/ → ~/.local/bin/ Custom command-line utilities and scripts. See Command Reference for detailed documentation.
All files in this directory are executable scripts: bin/ ├── PATH # Display PATH variable ├── ccl # Compile & run C ├── cclp # Compile & run C++ ├── color # Terminal color test ├── echo_separate # Formatted headers ├── git-remote # Git remote helper ├── gpt-import # GPG key import ├── hdln # Symbolic link helper ├── i3-layout-save # Save i3 layouts ├── i3load # Load i3 layouts ├── notify-test # Test notifications ├── pass # Password generator ├── radio # Internet radio ├── stot # Stow wrapper ├── systemctl-enable # Service management ├── update # System updater ├── wallpaper # Video wallpapers └── wallpaper-convert # Video conversion
home/ → ~/ User home directory configuration files.
File Target Purpose .xinitrc~/.xinitrcX Window System initialization .xprofile~/.xprofileX session startup script .nvidia-settings-rc~/.nvidia-settings-rcNVIDIA GPU settings .screenlayout-main.sh~/.screenlayout-main.shDisplay configuration script .Xresources~/.XresourcesX11 resource configuration .zshenv~/.zshenvZsh environment variables .zshrc~/.zshrcZsh interactive shell config
System Directories (Require Root) etc/ → /etc/ System-wide configuration files.
File Purpose dhcpcd.confDHCP client configuration hostsStatic hostname mappings locale.confSystem locale settings locale.genAvailable locales pacman.confPacman package manager resolv.confDNS resolver configuration sysctl.confKernel parameters vconsole.confVirtual console settings
Directory/File Purpose httpd/conf/httpd.confApache web server httpd/conf/extra/phpmyadmin.confPHPMyAdmin configuration lightdm/lightdm.confDisplay manager lightdm/lightdm-webkit2-greeter.confLogin screen theme php/php.iniPHP interpreter settings pulse/default.paPulseAudio configuration systemd/logind.confLogin manager settings
Package & Module Configuration
Directory/File Purpose modprobe.d/blacklist.confKernel module blacklist pacman.d/mirrorlistArch Linux mirrors xdg/reflector/reflector.confMirror list updater
X11/ → /etc/X11/xorg.conf.d/ X Window System configuration (optional).
File Purpose 00-keyboard.confKeyboard layout and options 50-mouse-acceleration.confMouse sensitivity settings xorg.confMain X server configuration
boot/ → /boot/ Bootloader configuration.
File Purpose efi/EFI/refind/refind.confrEFInd bootloader settings
usr/ → /usr/ System-wide resources.
File Purpose lib/NetworkManager/conf.d/20-connectivity.confNetwork connectivity check
srv/ → /srv/ Service data.
File Purpose http/test.phpApache test script
Synchronization Structure The sync.sh script uses the stot command to create symbolic links following this pattern:
Link Operations (-l flag) Source: ~/dotfiles/ < pat h > Target: ~/ < pat h >
Example: stot -l .config/i3 # Creates: ~/.config/i3/* → ~/dotfiles/.config/i3/*
Copy Operations (-c flag) Source: ~/dotfiles/ < pat h > Target: / < pat h >
Example: stot -c etc/hosts # Copies: ~/dotfiles/etc/hosts → /etc/hosts
Directory Purpose Summary
User Configuration
.config/ - Application settingshome/ - Shell and X11 configbin/ - Personal scripts
System Configuration
etc/ - System-wide settingsboot/ - Bootloader configusr/ - System resources
Development
Custom commands in bin/
Git configuration
Editor settings (nvim, doom)
Desktop Environment
Window managers (i3, xmonad)
Status bars (polybar, xmobar)
Application launchers (rofi)
.github/ File Purpose README.mdRepository documentation images/Screenshots and assets
XDG Base Directory Specification This dotfiles repository follows the XDG Base Directory standard:
Directory Environment Variable Purpose ~/.config/$XDG_CONFIG_HOMEUser-specific configuration ~/.local/bin/Part of $PATH User-specific executables ~/.local/share/$XDG_DATA_HOMEUser-specific data ~/.cache/$XDG_CACHE_HOMEUser-specific cache
Most modern applications automatically look in ~/.config/ for configuration files when they follow the XDG specification.