✦ dotfiles

Personal Arch Linux configuration files and automated setup script.  

⚡ Quick Start

git clone https://github.com/assachandev/dotfiles.git ~/dotfiles
cd ~/dotfiles
bash install.sh

Arch Linux only. The script will exit if pacman is not detected.

 

✦ How It Works

• Checks you're on Arch Linux
• Installs yay and paru (AUR helpers) automatically
• Asks before installing each tool — skip anything you don't need
• Backs up existing configs to ~/.dotfiles_backup/<timestamp>/ before overwriting
• Copies config files directly — no symlinks

 

🧰 Tools

Shell & Terminal

Tool	Description
zsh	Shell with Oh My Zsh, autosuggestions, syntax highlighting, Powerlevel10k
tmux	Terminal multiplexer
kitty	GPU-accelerated terminal emulator

CLI Utilities

Tool	Description
bat	cat clone with syntax highlighting
eza	Modern replacement for ls
fd	Fast and user-friendly find alternative
fzf	Command-line fuzzy finder
zoxide	Smarter cd that learns your habits
atuin	Shell history search and sync
ripgrep	Blazing fast search tool
yazi	Terminal file manager with plugin support
btop	System resource monitor
duf	Disk usage viewer
tree	Directory tree display
zip / unzip / unrar / p7zip	Archive tools

Editor

Tool	Description
neovim	Hyperextensible text editor

Music

Tool	Description
mpd	Music Player Daemon
mpc	Minimal CLI client for MPD
rmpc	Feature-rich TUI client for MPD

Media

Tool	Description
yt-dlp	Download video and audio from the web
yt-x	Browse and watch YouTube in the terminal
mpv	Lightweight media player

Applications

Tool	Description
Firefox	Web browser
Telegram	Messaging
Slack	Team communication
Signal	Encrypted messaging
FileZilla	FTP client
TigerVNC	VNC viewer
VLC	Media player
LibreOffice	Office suite
Zathura	Keyboard-driven document viewer

 

📁 Config Structure

configs/
├── zsh/            →  ~/.zshrc  •  ~/.p10k.zsh
├── tmux/           →  ~/.tmux.conf
├── kitty/          →  ~/.config/kitty/
├── yazi/           →  ~/.config/yazi/
├── bat/            →  ~/.config/bat/
├── btop/           →  ~/.config/btop/
├── atuin/          →  ~/.config/atuin/config.toml
├── rmpc/           →  ~/.config/rmpc/
├── yt-x/           →  ~/.config/yt-x/
├── mpd/            →  ~/.config/mpd/mpd.conf
└── scripts/
    └── dl.sh       →  ~/Music/dl.sh

 

🎵 Custom Script — dl.sh

Downloads audio from any URL via yt-dlp, converts to MP3, and auto-adds to MPD library.

~/Music/dl.sh
# Artist/Folder (default: .): Pink Floyd
# URL: <youtube or any supported url>