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.
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!
- ๐ถ๏ธ Dark Mode for the Whole System
- ๐ค Neovim powered by LazyVim with Custom Extras Added (More than 200!)
- โ๏ธ Screenshot, Clipboard, Color and Wallpaper Picker
- ๐ช Animations for Most of the System
- ๐ฅ๏ธ AwesomeWM Workspace Behavior
- ๐ Following XDG Base Directory Standard
- ๐ Automatic Mounting of USB Devices with Notification
- ๐ Scratchpads
- ๐ค Shell Prompt with Nerd Icons
- ๐ Custom Userchrome and Extension Configurations
- ๐ Minimal VSCodium with Native Integration of your Neovim Setup
- ๐ฆ Rust Alternatives
- ๐ Notification Center
- ๐ Volume and Brightness OSD
- ๐จ Color Scripts for the Terminal
- ๐ Idle and Lock apps
- ๐ฅ Performance Mode
- โ๏ธ Various other Tweaks
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: Floorp ๐
- Notification Manager: swaync ๐
- Colorscheme: Catppuccin ๐จ
Here is all the information about my setup:
Note
Some of this apps have the config files included in the repo, which are marked with โ๏ธ. 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 | hyprlock โ๏ธ |
Idle Timeout | hypridle โ๏ธ |
Color Picker | hyprpicker |
Screenshot Tool | hyprshot (Using grim and slurp) |
Image Annotation | satty โ๏ธ |
Logout Menu | wleave โ๏ธ |
๐ฅ๏ธ CLI/TUI Apps
๐ Entry | โจ App |
---|---|
Shell | ๐ fish โ๏ธ |
Terminal Emulator | ๐ kitty โ๏ธ |
Terminal Multiplexer | zellij โ๏ธ |
Shell Prompt | starship โ๏ธ |
Text Editor | ๐ neovim โ๏ธ |
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 โ๏ธ |
Git TUI | ๐ lazygit โ๏ธ |
Npm Manager TUI | lazynpm |
Docker TUI | lazydocker |
Arch Package Search TUI | pacseek โ๏ธ |
Trash CLI | gtrash |
Update Tool | topgrade โ๏ธ |
Audio Visualizer | cava โ๏ธ |
System Monitor | btop โ๏ธ |
GPU Monitor | nvtop |
System Fetch | fastfetch โ๏ธ |
Git Fetch | onefetch |
Keybindings TUI | keyb โ๏ธ |
๐ฑ๏ธ GUI Apps
๐ Entry | โจ App |
---|---|
Music Player | Spotify (patched with Spicetify) โ๏ธ |
Fallback Text Editor | VSCodium โ๏ธ |
Web Browser | ๐ Floorp โ๏ธ |
Messaging App | Vesktop (Custom Discord Client) โ๏ธ |
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 |
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 โ๏ธ |
Warning
This installation is specifically designed for Arch Linux. If you're running other systems, install the packages with your OS's package manager.
Note
The names of the packages are from the AUR and Arch Repos; adapt them to your system. Most of the packages are available on other distros official repos (most of the time out-to-date). For CLI/TUI specific packages I recommend to use homebrew.
-
First, lets start with the required base packages for the configuration to function. Assuming you're running Arch Linux, and your AUR helper is yay:
yay -Sy hyprland hyprlock hypridle xdg-desktop-portal-hyprland hyprpicker \ swww waybar-cava wleave-git rofi-wayland swaync swayosd-git wl-clipboard wl-clip-persist-git \ pyprland qt5ct pavucontrol cliphist playerctl udiskie devify fzf jq eza fd \ catppuccin-gtk-theme-macchiato catppuccin-cursors-macchiato cava slurp grim
On the first line we have the hypr ecosystem packages and on the other lines we have the must have packages.
-
Now lets move to the Optional Packages (If you dont want to install any more packages, move to the 3th step)
- Replaceable Packages
yay -Sy yazi nemo kitty ttf-ms-win11-auto ttf-jetbrainsmono-nerd zathura geeqie \ ttf-nerd-fonts-symbols ttf-nerd-fonts-symbols-mono mpv celluloid
Here we have some packages that you can replace with your favorite ones and are not required at all for the desktop to function (though it wont look the same). For example, the terminal (kitty), the file manager (nemo and yazi), the font (ttf-jetbrainsmono-nerd), the video player (mpv + celluloid), etc.
- Bluetooth
yay -Sy bluez bluez-utils blueman
After installing the required packages, we have to start the Bluetooth service. With systemd is pretty straightforward:
systemctl --user enable bluetooth.service systemctl --user start bluetooth.service
- Useful CLI/TUI packages
yay -Sy ripgrep riprep-all sd duf nvtop btop dua-cli bat pacseek tgpt-bin sysz gtrash-bin topgrade fastfetch
- Useful GUI packages
yay -Sy pika-backup vesktop-bin nwg-displays nwg-look gnome-logs galculator gparted nm-connection-editor satty
-
Installing the dotfiles: Firstly, clone this repository (remember to have git installed).
git clone --depth 1 --recurse-submodules https://github.com/Matt-FTW/dotfiles.git cd dotfiles && git submodule update --remote --merge
Now is time to copy the files into their respective directories. Be sure to backup your existing configuration files before copying the files. Once you have that, its time to copy the config files.
cp -r .config/* ~/.config/ cp -r .local/bin/* ~/.local/bin/ cp .czrc ~/
If you installed the fonts mentioned earlier, be sure to refresh the font cache.
fc-cache -fv
Congratulations, at this point your done installing the configuration! ๐
Logout from your current desktop session and log back into the Hyprland session.
If you had any issues or you have some questions about the installation process, feel free to open an issue or a new discussion post
Note
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 |
---|
Text Editor |
---|
TUI File Manager, ls replacement and System Fetch |
---|
GUI Text Editor |
---|
System Fetch, Matrix Script and Browser on r/unixporn |
---|
Browser with Main Page |
---|
Lockscreen |
---|
TUI System Monitor, Doom and Clock Script, ls replacement and Notif. Center |
---|
Text Editor and Audio Visualizer |
---|
File Manager, pipes script and Note Taking App |
---|
Text Editor and Git UI Manager |
---|
Audio Visualizer, Fuzzy Finder in a Git Directory and Image Viewer |
---|
Text Editor |
---|
Game Platform and Music Player |
---|
Text Editor |
---|
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!
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.
If you want to support my work, please consider donating.
This is optional, but it's always appreciated.
Thank you! ๐
Thanks to everyone who have contributed and given an star to this project!