🌿 ‎ About

Hey there! 👋

This is my personal dotfiles repository.

I created this repo to help me backup my config files and to easily deploy them in a new machine with the help of Ansible and yadm. It has some files exclusive to my personal use (programming, gaming, etc) so it's not just a rice (config files that change the visual stuff of the OS).

At first I didn't think about ricing but more and more, my focus has got into creating a good and aesthetic rice, with a lot of customization, as well as maintaining the easy deploy and use for my multiple machines.

If you wanna know how to install them, go to the setup section. It has a guided installation and an automatic one (Only for Arch Linux users)

I've been working on this for a long time so I hope you like it!

✨ Features

• 📜 Scratchpads
• 🔔 Notification Center
• 💤 Neovim powered by LazyVim with custom extras added
• 🕶️ Dark Mode for the whole system
• 🖼️ Various Wallpapers
• 🤓 Nerd Fonts for the Shell Prompt
• 🔊 Volume OSD
• 📱 App Launcher
• ⌨️ Multiple Keyboard Layouts
• 🎨 Color scripts for the terminal
• 🚗 Automatic mount of USB devices with notification
• 🔒 Idle and lock apps
• 📂 Following XDG Base Directory Standard
• 🧹 Organized and cleaned up config files
• 📽️ Recording script
• ☝️ Screenshot, Clipboard, Color and Wallpaper Picker
• 💥 Performance Mode
• 🪟 Window Animations
• 🖥️ AwesomeWM workspace behavior
• 🦀 Rust Alternatives
• ⚙️ Various other tweaks

---

🌸 Core System Info

The rice codename is Artemis 🏹, named after the Greek goddess of the hunt and the wild.

• OS: Arch Linux 💥
• WM: hyprland 🪟
• Shell: fish 🐚
• Terminal Emulator: kitty 🐱
• Panel: waybar 🍧
• Text Editor: neovim ⌨️
• App Launcher: rofi 🚀
• File Manager: yazi / nemo 📂
• Browser: librewolf 🌐
• Notification Manager: swaync 🔔
• Colorscheme: Catppuccin 🎨

All the other apps can be seen over here!

---

🐧 Whole System Info

Here is all the information about my setup:

ℹ️ Some of this apps have the config files included in the repo, which are marked with ⚙️, and others don't because simply they don't have any or is not worth saving it because of their defaults. Also, my favorite are programs and tools are marked with 💖.

🐧 System

📚 Entry	✨ App
OS	💖 Arch Linux
Package Manager	Pacman ⚙️
AUR Helper	💖 yay ⚙️
Window Manager	💖 Hyprland ⚙️
Notification Daemon/Center	swaync ⚙️
OSD Popup	swayosd
Bar	💖 Waybar ⚙️
Audio Daemon	Pipewire ⚙️
Application Launcher	💖 Rofi ⚙️
Firewall	ufw
Clipboard Manager	wl-clipboard (with cliphist)
Wallpaper Switcher	swww
Lock Screen	swaylock-effects ⚙️
Idle Timeout	swayidle ⚙️
Color Picker	Hyprpicker
Recording Tool	wf-recorder
Screenshot Tool	Hyprshot
Screenshot Editor	Swappy
Logout Menu	wleave ⚙️

🖥️ CLI/TUI Apps

📚 Entry	✨ App
Shell	💖 Fish ⚙️
Terminal Emulator	💖 Kitty ⚙️
Shell Prompt	Starship ⚙️
Shell History	Atuin ⚙️
CD Replacement	💖 zoxide
LS Replacement	eza
Cat Replacement	bat ⚙️
Find Replacement	fd ⚙️
File Manager	💖 Yazi ⚙️
Help Pages	Navi / TLDR ⚙️
Fuzzy File Finder	💖 fzf
Fuzzy Word Finder	Ripgrep ⚙️
Text Editor	💖 Neovim ⚙️
Git UI	💖 Lazygit ⚙️
Npm Manager UI	Lazynpm
Docker UI	Lazydocker
Arch Package Search UI	Pacseek ⚙️
Update Tool	Topgrade ⚙️
Audio Visualizer	Cava ⚙️
System Monitor	btop ⚙️
GPU Monitor	nvtop
System Fetch	Neofetch ⚙️
Git Fetch	Onefetch
Keybindings TUI	Keyb ⚙️

🖱️ GUI Apps

📚 Entry	✨ App
Music Player	Spotify (patched with Spicetify) ⚙️
Web Browser	💖 Librewolf ⚙️
Messaging App	Discord (patched with BetterDiscord) ⚙️
Email Client	Thunderbird
PDF Viewer	Zathura ⚙️
Note Taking App	💖 Obsidian
Video Player	Celluloid (MPV frontend) ⚙️
Image Viewer	geeqie ⚙️
File Manager	Nemo
Audio Effects	Easyeffects
Image Editor	Krita
Paint Tool	Pinta
VM Manager	Virt-Manager (QEMU)
Recording Program	OBS
Office Apps	LibreOffice ⚙️

🔍 Other

📚 Entry	✨ App
Colorscheme	💖 Catppuccin Macchiato
Font	JetBrainsMono Nerd Font
Icon Theme	Catppuccin-SE
Dotfiles Manager	💖 yadm ⚙️
Automatic System Deployment	💖 Ansible ⚙️

🔧 ‎ Setup

📦 Automatic Installation (Arch Linux)

⚠️ This installation is specifically designed for Arch Linux. If you're running other systems, install the packages with your OS's package manager.

WIP

📦 Manual Installation (Universal)

ℹ️ This installation assumes you have the .config dir in your home dir. Also, note that the names of the packages are from the AUR and Arch Repos. Adapt them to your system.

WIP

📷 ‎ Gallery

ℹ️ For specific images and videos about each tool, check out their own READMEs at their respective config folders. (STILL WIP 🚧)

System Fetch, Pacman Colorscript, App Launcher and Notif. Center

Audio Visualizer, Fuzzy Finder in a Git Directory and Image Viewer

TUI File Manager, ls replacement and System Fetch

Text Editor and Git UI Manager

Text Editor

Browser with Main Page

System Fetch, Matrix Script and Browser on r/unixporn

TUI System Monitor, Doom and Clock Script, ls replacement and Notif. Center

Text Editor

File Manager, pipes script and Note Taking App

🎉 ‎ Credits

Big thanks to everyone at r/unixporn for inspiring me to make this!

I wanna point out some resources that helped me the most with the setup:

• ArchWiki for all the awesome documentation and for helping me to not lose my mind.
• Folke for his amazing contributions to the Neovim community with some awesome plugins and with the distro that i use: LazyVim. Also, his READMEs and dotfiles are amazing!
• Yoru's README to help me with the distribution of the README.
• Amadeus Dots for helping me with the startup setup of the Hyprland WM.
• Hyprdots for helping me to take ideas from their work. Also, their setup is the best one I've ever seen for Hyprland; it's pretty awesome!.
• Catppuccin for making the Best Colorscheme Ever 🖌️
• Github-issue-templates for the some of the markdown templates of the repo.

Those were the biggest inspiring factor for me, though you can find a lot more of setups that helped me in my list of favorite dotfiles from the Stars section of my Github Profile: Check it out!

✍️ Contributing

Part of what makes the open source community special are the contributions. Any contributions will be highly appreciated!

If you have any ideas or suggestions to make, feel free to open an issue or submit a PR

Please, before submitting a PR or opening an issue, be sure to follow the contributing guidelines, as well as the issues and pull requests formatting rules.

Blank or repeated issues and PRs will be closed.

💵 Donating

If you want to support my work, please consider donating.

This is optional, but it's always appreciated.

Thank you! 💖

💕 Star History and Contributors

Thanks to everyone who have contributed and given an star to this project!

✏️ Contributors

⭐ Star History