<div align="center">
<a href="#"><img src="./assets/images/dotfiles-title.png"></a>
</div>

<div align="center">

<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/palette/macchiato.png" width="90%"/><br>

</div>

<div align="center">

<a href="#herb--about"><img width="190px" src="./assets/images/dotfiles-about.png"></a>
<a href="#wrench--setup"><img width="190px" src="./assets/images/dotfiles-setup.png"></a>
<a href="#camera--gallery"><img width="190px" src="./assets/images/dotfiles-gallery.png"></a>
<a href="#tada--credits"><img width="190px" src="./assets/images/dotfiles-credits.png"></a>

</div>

<div align="center">

<img src="./assets/images/big-showcase.png">

</div>

<br>

<div align="center">
	<a href="https://github.com/Matt-FTW/dotfiles/stargazers"><img alt="Stargazers" src="https://img.shields.io/github/stars/Matt-FTW/dotfiles?style=for-the-badge&logo=starship&color=C9CBFF&logoColor=D9E0EE&labelColor=302D41"></a>
	<a href="https://github.com/Matt-FTW/dotfiles/issues"><img alt="Forks" src="https://img.shields.io/github/issues/Matt-FTW/dotfiles?style=for-the-badge&logo=gitbook&color=B5E8E0&logoColor=D9E0EE&labelColor=302D41"></a>
  <a href="https://github.com/Matt-FTW/dotfiles/commits/main/"><img alt="Commit Activity" src="https://img.shields.io/github/commit-activity/m/Matt-FTW/dotfiles/main?style=for-the-badge&logo=github&color=F2CDCD&logoColor=D9E0EE&labelColor=302D41"/></a>
	<a href="https://github.com/Matt-FTW/dotfiles"><img alt="Size" src="https://img.shields.io/github/repo-size/Matt-FTW/dotfiles?style=for-the-badge&logo=discord&color=DDB6F2&logoColor=D9E0EE&labelColor=302D41"></a>
</div>

# :herb: ‎ <samp>About</samp>

Hey there! :wave:

This is my personal repository for my Dotfiles.

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

This repo is always changing, so I may add new stuff in the future. If you encounter some issues or if you have any ideas to improve the setup, make sure to report them in the issue tracker over here at Github.

---

### ✨ Features

- :scroll: Scratchpads
- :bell: Notification Center
- :zzz: LazyVim powered Neovim with custom extras added
- :dark_sunglasses: Dark Mode for the whole system (Catppuccin powered)
- :framed_picture: Various Wallpapers
- :nerd_face: Nerd Fonts for the Shell Prompt
- :loud_sound: Volume OSD
- :iphone: App Launcher
- :keyboard: Multiple Keyboard Layouts
- :art: Color scripts for the terminal
- :car: Automatic mount of USB devices with notification
- :lock: Idle and lock apps
- :broom: Organized and cleaned up config files
- :film_projector: Recording script
- :point_up: Screenshot, Clipboard, Color and Wallpaper Picker
- :boom: Performance Mode
- :window: Window Animations
- :desktop_computer: AwesomeWM workspace behavior
- :gear: Various other tweaks

And many more!`:)`

### 🐧 System Info

Here is some _small_ 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 💖.

<details>
  <summary><b>🐧 System</b></summary>

| 📚 Entry                       | ✨ App                                                                                                         |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **OS**                         | 💖 [Arch Linux](https://archlinux.org/)                                                                        |
| **Package Manager**            | [Pacman](https://wiki.archlinux.org/title/Pacman) [:gear:](../.config/pacman/)                                 |
| **AUR Helper**                 | 💖 [yay](https://github.com/Jguer/yay) [:gear:](../.config/yay/)                                               |
| **Window Manager**             | 💖 [Hyprland](https://hyprland.org/) [:gear:](../.config/hypr/)                                                |
| **Notification Daemon/Center** | [swaync](https://github.com/ErikReider/SwayNotificationCenter) [:gear:](../.config/swaync/)                    |
| **OSD Popup**                  | [swayosd](https://github.com/ErikReider/SwayOSD)                                                               |
| **Panel**                      | 💖 [Waybar](https://github.com/Alexays/Waybar) [:gear:](../.config/waybar/)                                    |
| **Audio Daemon**               | [Pipewire](https://pipewire.org/) [:gear:](../.config/pipewire/)                                               |
| **Application Launcher**       | 💖 [Rofi](https://github.com/lbonn/rofi) [:gear:](../.config/rofi/)                                            |
| **Firewall**                   | [ufw](https://wiki.archlinux.org/title/ufw)                                                                    |
| **Clipboard Manager**          | [wl-clipboard](https://github.com/bugaevc/wl-clipboard) (with [cliphist](https://github.com/sentriz/cliphist)) |
| **Wallpaper Switcher**         | [swww](https://github.com/Horus645/swww)                                                                       |
| **Lock Screen**                | [swaylock-effects](https://github.com/jirutka/swaylock-effects) [:gear:](../.config/swaylock/)                 |
| **Idle Timeout**               | [swayidle](https://github.com/swaywm/swayidle) [:gear:](../.config/swayidle/)                                  |
| **Color Picker**               | [Hyprpicker](https://github.com/hyprwm/hyprpicker)                                                             |
| **Recording Tool**             | [wf-recorder](https://github.com/ammen99/wf-recorder)                                                          |
| **Screenshot Tool**            | [Hyprshot](https://github.com/Gustash/Hyprshot)                                                                |
| **Screenshot Editor**          | [Swappy](https://github.com/jtheoof/swappy)                                                                    |
| **Logout Menu**                | [wleave](https://github.com/AMNatty/wleave) [:gear:](../.config/wleave/)                                       |

</details>

<details>
  <summary><b>🖥️ CLI/TUI Apps</b></summary>

| 📚 Entry                   | ✨ App                                                                                           |
| -------------------------- | ------------------------------------------------------------------------------------------------ |
| **Shell**                  | 💖 [Fish](https://fishshell.com/) [:gear:](../.config/fish/)                                     |
| **Terminal Emulator**      | 💖 [Kitty](https://sw.kovidgoyal.net/kitty/) [:gear:](../.config/kitty/)                         |
| **Shell Prompt**           | [Starship](https://starship.rs/) [:gear:](../.config/starship/)                                  |
| **Shell History**          | [Atuin](https://github.com/atuinsh/atuin) [:gear:](../.config/atuin/)                            |
| **CD Replacement**         | 💖 [zoxide](https://github.com/ajeetdsouza/zoxide)                                               |
| **LS Replacement**         | [eza](https://github.com/eza-community/eza)                                                      |
| **Cat Replacement**        | [bat](https://github.com/sharkdp/bat) [:gear:](../.config/bat/)                                  |
| **Find Replacement**       | [fd](https://github.com/sharkdp/fd) [:gear:](../.config/fd/)                                     |
| **File Manager**           | 💖 [Yazi](https://yazi-rs.github.io/) [:gear:](../.config/yazi/)                                 |
| **Help Pages**             | [Navi](https://github.com/denisidoro/navi) / [TLDR](https://tldr.sh/) [:gear:](../.config/navi/) |
| **Fuzzy File Finder**      | 💖 [fzf](https://github.com/junegunn/fzf)                                                        |
| **Fuzzy Word Finder**      | [Ripgrep](https://github.com/BurntSushi/ripgrep) [:gear:](../.config/rg/)                        |
| **Text Editor**            | 💖 [Neovim](https://neovim.io/) [:gear:](../.config/nvim/)                                       |
| **Git UI**                 | 💖 [Lazygit](https://github.com/jesseduffield/lazygit) [:gear:](../.config/lazygit/)             |
| **Npm Manager UI**         | [Lazynpm](https://github.com/jesseduffield/lazynpm)                                              |
| **Docker UI**              | [Lazydocker](https://github.com/jesseduffield/lazydocker)                                        |
| **Arch Package Search UI** | [Pacseek](https://github.com/moson-mo/pacseek) [:gear:](../.config/pacseek/)                     |
| **Update Tool**            | [Topgrade](https://github.com/topgrade-rs/topgrade) [:gear:](../.config/topgrade/)               |
| **Audio Visualizer**       | [Cava](https://github.com/karlstav/cava) [:gear:](../.config/cava/)                              |
| **System Monitor**         | [btop](https://github.com/aristocratos/btop) [:gear:](../.config/btop/)                          |
| **GPU Monitor**            | [nvtop](https://github.com/Syllo/nvtop)                                                          |
| **System Fetch**           | [Neofetch](https://github.com/dylanaraps/neofetch) [:gear:](../.config/neofetch/)                |
| **Git Fetch**              | [Onefetch](https://github.com/o2sh/onefetch)                                                     |
| **Keybindings TUI**        | [Keyb](https://github.com/kencx/keyb) [:gear:](../.config/keyb/)                                 |

</details>

<details>
  <summary><b>🖱️ GUI Apps</b></summary>

| 📚 Entry              | ✨ App                                                                                                                         |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Music Player**      | [Spotify](https://open.spotify.com/) (patched with [Spicetify](https://spicetify.app/)) [:gear:](../.config/spicetify/)        |
| **Web Browser**       | 💖 [Librewolf](https://librewolf.net/) [:gear:](../.config/browser/)                                                           |
| **Messaging App**     | [Discord](https://discord.com/) (patched with [BetterDiscord](https://betterdiscord.app/)) [:gear:](../.config/BetterDiscord/) |
| **Email Client**      | [Thunderbird](https://www.thunderbird.net/)                                                                                    |
| **PDF Viewer**        | [Zathura](https://pwmt.org/projects/zathura/) [:gear:](../.config/zathura/)                                                    |
| **Note Taking App**   | 💖 [Obsidian](https://obsidian.md/)                                                                                            |
| **Video Player**      | [Celluloid](https://celluloid-player.github.io/) ([MPV](https://mpv.io/) frontend) [:gear:](../.config/mpv/)                   |
| **Image Viewer**      | [geeqie](https://www.geeqie.org/) [:gear:](../.config/geeqie/)                                                                 |
| **File Manager**      | [Nemo](https://community.linuxmint.com/software/view/nemo)                                                                     |
| **Audio Effects**     | [Easyeffects](https://github.com/wwmm/easyeffects)                                                                             |
| **Image Editor**      | [Krita](https://krita.org/)                                                                                                    |
| **Paint Tool**        | [Pinta](https://www.pinta-project.com/)                                                                                        |
| **VM Manager**        | [Virt-Manager](https://virt-manager.org/) ([QEMU](https://www.qemu.org/))                                                      |
| **Recording Program** | [OBS](https://obsproject.com/)                                                                                                 |
| **Office Apps**       | [LibreOffice](https://www.libreoffice.org/) [:gear:](../.config/libreoffice/4/user/config/)                                    |

</details>

<details>
  <summary><b>🔍 Other</b></summary>

| 📚 Entry                        | ✨ App                                                               |
| ------------------------------- | -------------------------------------------------------------------- |
| **Colorscheme**                 | 💖 [Catppuccin Macchiato](https://github.com/catppuccin/catppuccin)  |
| **Font**                        | [JetBrainsMono Nerd Font](https://www.jetbrains.com/es-es/lp/mono/)  |
| **Dotfiles Manager**            | 💖 [yadm](https://yadm.io/) [:gear:](../.config/yadm/)               |
| **Automatic System Deployment** | 💖 [Ansible](https://www.ansible.com/) [:gear:](../.config/ansible/) |

</details>

# :wrench: ‎ <samp>Setup</samp>

### :package: <samp>Automatic Installation (Arch Linux)</samp>

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

#### WIP

### :package: <samp>Manual Installation (Universal) </samp>

> :information_source: 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

# :camera: ‎ <samp>Gallery</samp>

> :information_source: 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** |
| -------------------------------------------------------------------- |
| ![overview-1](./assets/images/overview-1.png)                        |

| **Audio Visualizer, Fuzzy Finder in a Git Directory and Image Viewer** |
| ---------------------------------------------------------------------- |
| ![overview-2](./assets/images/overview-2.png)                          |

| **TUI File Manager, ls replacement and System Fetch** |
| ----------------------------------------------------- |
| ![overview-3](./assets/images/overview-3.png)         |

| **Text Editor and Git UI Manager**            |
| --------------------------------------------- |
| ![overview-4](./assets/images/overview-4.png) |

| **Text Editor**                               |
| --------------------------------------------- |
| ![overview-5](./assets/images/overview-5.png) |

| **Browser with Main Page**                    |
| --------------------------------------------- |
| ![overview-6](./assets/images/overview-6.png) |

| **System Fetch, Matrix Script and Browser on [r/unixporn](https://www.reddit.com/r/unixporn/)** |
| ----------------------------------------------------------------------------------------------- |
| ![overview-7](./assets/images/overview-7.png)                                                   |

| **TUI System Monitor, Doom and Clock Script, ls replacement and Notif. Center** |
| ------------------------------------------------------------------------------- |
| ![overview-8](./assets/images/overview-8.png)                                   |

| **Text Editor**                               |
| --------------------------------------------- |
| ![overview-9](./assets/images/overview-9.png) |

# :tada: ‎ <samp>Credits</samp>

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](https://wiki.archlinux.org/) for all the awesome documentation.
- [Folke](https://github.com/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](https://github.com/folke/dot) are amazing!
- [Yoru's README](https://github.com/rxyhn/yoru/tree/main) to help me with the distribution of the README
- [Amadeus Dots](https://github.com/AmadeusWM/dotfiles-hyprland) for helping me with the startup setup of the Hyprland WM.
- [Catppuccin](https://github.com/catppuccin/catppuccin) for making the **Best Colorscheme Ever** 🖌️

Those were the biggest inspiring factor for me, though you can find a lot more of setups that helped me in my List of Dotfiles from the **Stars** section of my Github Profile: [Check it out!](https://github.com/stars/Matt-FTW/lists/paintbrush-theming-dots)

# :star: ‎ <samp>Star History</samp>

Thanks to everyone who gave a star to this project! ❤️

<a href="https://star-history.com/#Matt-FTW/dotfiles&Timeline">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Matt-FTW/dotfiles&type=Timeline&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Matt-FTW/dotfiles&type=Timeline" />
    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Matt-FTW/dotfiles&type=Timeline" />
  </picture>
</a>
