626 lines
32 KiB
Markdown
626 lines
32 KiB
Markdown
<div align="center">
|
||
<a href="#"><img src="./assets/category-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="https://raw.githubusercontent.com/Matt-FTW/dotfiles/main/.github/assets/category-images/dotfiles-about.png"></a>
|
||
<a href="#wrench--setup"><img width="190px" src="https://raw.githubusercontent.com/Matt-FTW/dotfiles/main/.github/assets/category-images/dotfiles-setup.png"></a>
|
||
<a href="#camera--gallery"><img width="190px" src="https://raw.githubusercontent.com/Matt-FTW/dotfiles/main/.github/assets/category-images/dotfiles-gallery.png"></a>
|
||
<a href="#tada--credits"><img width="190px" src="https://raw.githubusercontent.com/Matt-FTW/dotfiles/main/.github/assets/category-images/dotfiles-credits.png"></a>
|
||
|
||
</div>
|
||
|
||
<div align="center">
|
||
|
||
<img src="./assets/overview-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 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](https://www.ansible.com/) and [yadm](https://yadm.io). 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](#wrench--setup) section. There is a guided installation.
|
||
|
||
I've been working on this for a long time so I hope you like it!
|
||
|
||
## ✨ Features
|
||
|
||
- :dark_sunglasses: Dark Mode for the Whole System
|
||
- :zzz: Neovim powered by LazyVim with Custom Extras Added (More than 200!)
|
||
- :point_up: Screenshot, Keybindings, Games, Clipboard, Color and Wallpaper Picker
|
||
- :window: Animations for nearly all the System
|
||
- :wrench: Modular Configuration
|
||
- :desktop_computer: AwesomeWM Workspace Behavior
|
||
- :open_file_folder: Following XDG Base Directory Standard
|
||
- :car: Automatic Mounting of USB Devices with Notification
|
||
- :scroll: Scratchpads
|
||
- :dizzy: Beautiful [Wallpapers](../.config/hypr/theme/walls/.github/README.md)
|
||
- :nerd_face: Shell Prompt with Nerd Icons
|
||
- :heavy_plus_sign: Extra Hyprland Plugins
|
||
- :earth_americas: Custom Userchrome and Extension Configurations
|
||
- :rocket: Minimal VSCodium with Native Integration of your Neovim Setup
|
||
- :crab: Rust Alternatives
|
||
- :bell: Notification Center
|
||
- :loud_sound: Volume and Brightness OSD
|
||
- :art: Color Scripts for the Terminal
|
||
- :lock: Idle and Lock apps
|
||
- :zap: Performance Mode
|
||
- :gear: Various other Tweaks
|
||
|
||
---
|
||
|
||
## 🌸 Core System Info
|
||
|
||
<img src="assets/rice-logo.png" alt="rice-logo" align="right" width="390px">
|
||
|
||
The rice codename is **Artemis** 🏹, named after the Greek goddess of the hunt and the wild.
|
||
|
||
- **OS**: [Arch Linux](https://archlinux.org/) :boom:
|
||
- **WM**: [hyprland](https://hyprland.org/) :window:
|
||
- **Shell**: [fish](https://fishshell.com/) :shell:
|
||
- **Terminal Emulator**: [kitty](https://sw.kovidgoyal.net/kitty/) :cat:
|
||
- **Panel**: [waybar](https://github.com/Alexays/Waybar) :shaved_ice:
|
||
- **Text Editor**: [neovim](https://neovim.io/) :keyboard:
|
||
- **App Launcher**: [rofi](https://davatorium.github.io/rofi/) :rocket:
|
||
- **File Manager**: [yazi](https://yazi-rs.github.io/) / [nemo](https://community.linuxmint.com/software/view/nemo) :open_file_folder:
|
||
- **Browser**: [Floorp](https://floorp.app/en) :globe_with_meridians:
|
||
- **Notification Manager**: [swaync](https://github.com/ErikReider/SwayNotificationCenter) :bell:
|
||
- **Colorscheme**: [Catppuccin](https://github.com/catppuccin/catppuccin) :art:
|
||
|
||
---
|
||
|
||
### 🐧 Whole System Info
|
||
|
||
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 💖.
|
||
|
||
<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/) |
|
||
| **Display Manager** | [greetd](https://sr.ht/~kennylevinsen/greetd/) (with [tuigreet](https://github.com/apognu/tuigreet)) |
|
||
| **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) |
|
||
| **Bar** | 💖 [waybar](https://github.com/Alexays/Waybar) [:gear:](../.config/waybar/) |
|
||
| **Audio Daemon** | [pipewire](https://pipewire.org/) |
|
||
| **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** | [hyprlock](https://github.com/hyprwm/hyprlock) [:gear:](../.config/hypr/hyprlock.conf) |
|
||
| **Idle Timeout** | [hypridle](https://github.com/hyprwm/hypridle) [:gear:](../.config/hypr/hypridle.conf) |
|
||
| **Color Picker** | [hyprpicker](https://github.com/hyprwm/hyprpicker) |
|
||
| **Screenshot Tool** | [hyprshot](https://github.com/Gustash/Hyprshot) (Using [grim](https://sr.ht/~emersion/grim/) and [slurp](https://github.com/emersion/slurp)) |
|
||
| **Image Annotation** | [satty](https://github.com/gabm/Satty) [:gear:](../.config/satty/) |
|
||
|
||
</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/) |
|
||
| **Terminal Multiplexer** | [tmux](https://github.com/tmux/tmux) [:gear:](../.config/tmux/) |
|
||
| **Shell Prompt** | [starship](https://starship.rs/) [:gear:](../.config/starship/) |
|
||
| **Text Editor** | 💖 [neovim](https://neovim.io/) [:gear:](../.config/nvim/) |
|
||
| **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/) |
|
||
| **Git TUI** | 💖 [lazygit](https://github.com/jesseduffield/lazygit) [:gear:](../.config/lazygit/) |
|
||
| **Npm Manager TUI** | [lazynpm](https://github.com/jesseduffield/lazynpm) |
|
||
| **Docker TUI** | [lazydocker](https://github.com/jesseduffield/lazydocker) |
|
||
| **Arch Package Search TUI** | [pacseek](https://github.com/moson-mo/pacseek) [:gear:](../.config/pacseek/) |
|
||
| **Trash CLI** | [gtrash](https://github.com/umlx5h/gtrash) |
|
||
| **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** | [fastfetch](https://github.com/fastfetch-cli/fastfetch) [:gear:](../.config/fastfetch/) |
|
||
| **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/) |
|
||
| **Fallback Text Editor** | [VSCodium](https://vscodium.com/) [:gear:](../.config/VSCodium/User/) |
|
||
| **Web Browser** | 💖 [Floorp](https://floorp.app/en/) [:gear:](../.config/browser/) |
|
||
| **Messaging App** | [Vesktop](https://github.com/Vencord/Vesktop) (Custom Discord Client) [:gear:](../.config/vesktop/) |
|
||
| **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/) [:gear:](../.config/obsidian/) |
|
||
| **Video Player** | [MPV](https://mpv.io/) [:gear:](../.config/mpv/) |
|
||
| **Image Viewer** | [qimgv](https://github.com/easymodo/qimgv) [:gear:](../.config/qimgv/) |
|
||
| **File Manager** | [Nemo](https://community.linuxmint.com/software/view/nemo) |
|
||
| **Audio Effects** | [Easyeffects](https://github.com/wwmm/easyeffects) [:gear:](../.config/easyeffects/) |
|
||
| **Image Editor** | [Krita](https://krita.org/) |
|
||
| **VM Manager** | [Virt-Manager](https://virt-manager.org/) ([QEMU](https://www.qemu.org/)) |
|
||
| **Recording Program** | [OBS](https://obsproject.com/) [:gear:](../.config/obs-studio/) |
|
||
| **Office Apps** | [LibreOffice](https://www.libreoffice.org/) |
|
||
|
||
</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/) |
|
||
| **Icon Theme** | [Catppuccin-SE](https://github.com/ljmill/catppuccin-icons) |
|
||
| **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>
|
||
|
||
> [!WARNING]
|
||
> The installation guide is under construction, try it at your own risk!
|
||
>
|
||
> It is also ment only for Arch based systems. All other distros are not supported and I will not be helping with issues related to them.
|
||
|
||
## :package: Dependencies Installation
|
||
|
||
> [!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).
|
||
>
|
||
> To install CLI/TUI specific packages in non-arch based distros, I recommend to use [homebrew](https://brew.sh/).
|
||
>
|
||
> In the guide, I will be using [Yay](https://github.com/Jguer/yay) as the AUR helper. Be sure to [install it](../.local/bin/installYay) or change the commands to your preferred one.
|
||
|
||
- **Base Packages**
|
||
|
||
Lets start with the required base packages for the configuration to function.
|
||
|
||
```bash
|
||
yay -Sy hyprland hyprlock hypridle xdg-desktop-portal-hyprland hyprpicker \
|
||
swww waybar waybar-updates rofi-wayland swaync swayosd-git playerctl \
|
||
wl-clipboard wl-clip-persist cliphist udiskie devify polkit-gnome \
|
||
pyprland qt5ct qt5-wayland qt6-wayland pavucontrol fastfetch \
|
||
fzf jq eza fd slurp grim satty vivid fish starship ripgrep bat \
|
||
catppuccin-gtk-theme-macchiato catppuccin-cursors-macchiato \
|
||
yazi nemo kitty zathura zathura-pdf-mupdf qimgv-light mpv
|
||
|
||
```
|
||
|
||
- **Graphics Drivers** (_Optional_)
|
||
|
||
> [!WARNING]
|
||
> Skip this step if you already have the correct drivers for your graphics card.
|
||
|
||
Chose one if this commands depending on your graphics card brand.
|
||
|
||
```bash
|
||
# AMD (Open Source)
|
||
yay -Sy xf86-video-amdgpu xf86-video-amdgpu vulkan-radeon lib32-vulkan-radeon vulkan-tools \
|
||
opencl-clover-mesa lib32-opencl-clover-mesa libva-mesa-driver lib32-libva-mesa-driver \
|
||
mesa lib32-mesa mesa-vdpau lib32-mesa-vdpau vdpauinfo clinfo
|
||
|
||
# Nvidia (Propietary)
|
||
yay -Sy nvidia nvidia-utils nvidia-settings opencl-nvidia lib32-nvidia-utils \
|
||
lib32-opencl-nvidia cuda vdpauinfo clinfo
|
||
|
||
# Intel (Open Source)
|
||
yay -Sy xf86-video-intel vulkan-intel lib32-vulkan-intel vulkan-tools libva-intel-driver \
|
||
lib32-libva-intel-driver mesa lib32-mesa mesa-vdpau lib32-mesa-vdpau
|
||
```
|
||
|
||
- **Icon Theme**
|
||
|
||
First off, we have to download the icon package from the releases page of their repo. You can do it very easily by using curl.
|
||
|
||
```bash
|
||
curl -LJO https://github.com/ljmill/catppuccin-icons/releases/download/v0.2.0/Catppuccin-SE.tar.bz2
|
||
```
|
||
|
||
Once you have that, its time to extract the compressed package.
|
||
|
||
```bash
|
||
tar -xf Catppuccin-SE.tar.bz2
|
||
```
|
||
|
||
And finally, move them to the ~/.local/share/icons directory.
|
||
|
||
```bash
|
||
mv Catppuccin-SE ~/.local/share/icons/
|
||
```
|
||
|
||
- **Fonts**
|
||
|
||
Install the following fonts:
|
||
|
||
```bash
|
||
yay -Sy ttf-jetbrains-mono-nerd ttf-nerd-fonts-symbols ttf-nerd-fonts-symbols-mono \
|
||
ttf-nerd-fonts-symbols-common ttf-font-awesome noto-fonts-cjk ttf-ms-win11-auto
|
||
```
|
||
|
||
After that, be sure to refresh the font cache:
|
||
|
||
```bash
|
||
fc-cache -fv
|
||
```
|
||
|
||
- **Audio Service** (_Optional_)
|
||
|
||
> [!WARNING]
|
||
> If you have Pipewire already setup on your system, you dont have to follow this step.
|
||
|
||
Firstly, install this dependencies:
|
||
|
||
```bash
|
||
yay -S pipewire pipewire-alsa pipewire-pulse pipewire-jack wireplumber alsa-utils
|
||
```
|
||
|
||
Now enable pipewire and wireplumber systemd services:
|
||
|
||
```bash
|
||
systemctl --user enable --now pipewire wireplumber
|
||
```
|
||
|
||
And there you have it.
|
||
|
||
## :floppy_disk: Dotfiles Installation
|
||
|
||
> [!WARNING]
|
||
> Here we can take two routes. **CHOOSE ONE, NOT BOTH!**
|
||
|
||
### Yadm Method (**recommended**)
|
||
|
||
[Yadm](https://yadm.io/) is amazing. It lets you manage your dotfiles with git without the hassle of creating a git repo on your home directory as well as gitignoring a lot of files.
|
||
|
||
It also lets you pull from the repos that you set up on remote to your local repo and then push to your personal remote.
|
||
|
||
I'd recommend you to look at it if you want a more personal and advanced config.
|
||
|
||
For now, we are going to install it the simple way without to many complications and just to have an origin to pull and another to push.
|
||
|
||
Firstly, **be sure to backup your existing config files**. Then, we are going to install yadm. You can do it using pacman with the following command:
|
||
|
||
```bash
|
||
sudo pacman -S yadm
|
||
```
|
||
|
||
After that, its time to clone the dotfiles repo into your system using yadm.
|
||
|
||
> [!NOTE]
|
||
> If any file in your local machine differs from the one in the remote repository, your local file will remain unmodified. You'll need to manually review and resolve any differences.
|
||
|
||
```bash
|
||
yadm clone https://github.com/Matt-FTW/dotfiles.git
|
||
```
|
||
|
||
Congratulations, at this point your done installing the configuration! :tada:
|
||
|
||
Logout from your current desktop session and log back into the Hyprland session.
|
||
|
||
If you want to pull from my remote, commit or add any files you can do it using yadm and then the git command you want to use (pull, commit, add, etc).
|
||
|
||
Now, if you want to **add your personal remote**, use the following command:
|
||
|
||
```bash
|
||
yadm remote add origin <url>
|
||
```
|
||
|
||
Then, be sure to push your changes to your remote!
|
||
|
||
Now you can receive new updates from my repo and modify your custom one :sunglasses:
|
||
|
||
If you had any issues feel free to [open an issue](https://github.com/Matt-FTW/dotfiles/issues/new/choose).
|
||
Do you have some questions about the installation process? You can create a [new discussion post](https://github.com/Matt-FTW/dotfiles/discussions/new/choose) then. Be sure to read the [FAQ](./FAQ.md) first!
|
||
|
||
### Git Method
|
||
|
||
Firstly, clone this repository (remember to have git installed).
|
||
|
||
```bash
|
||
git clone https://github.com/Matt-FTW/dotfiles.git
|
||
cd dotfiles
|
||
```
|
||
|
||
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.
|
||
|
||
```bash
|
||
cp -r .config/* ~/.config/
|
||
cp -r .local/bin/* ~/.local/bin/
|
||
```
|
||
|
||
Congratulations, at this point your done installing the configuration! :tada:
|
||
|
||
Logout from your current desktop session and log back into the Hyprland session.
|
||
|
||
If you had any issues feel free to [open an issue](https://github.com/Matt-FTW/dotfiles/issues/new/choose).
|
||
Do you have some questions about the installation process? You can create a [new discussion post](https://github.com/Matt-FTW/dotfiles/discussions/new/choose) then. Be sure to read the [FAQ](./FAQ.md) first!
|
||
|
||
## :heavy_plus_sign: Post Installation
|
||
|
||
Here are some things you might consider changing or adding:
|
||
|
||
- **Change Outputs**
|
||
|
||
Firstly, change the outputs defined in [this file](../.config/hypr/configs/monitors.conf). They are the ones defined for Hyprland to use, so is very important that you change them. If you wanna know what ID does your monitor has, execute `hyprctl monitors`.
|
||
|
||
You also need to change the workspaces associated with that monitor. For that, check [this file](../.config/hypr/configs/workspaces.conf).
|
||
|
||
For more information about Hyprland monitors and workspaces, [check the docs](https://wiki.hyprland.org/).
|
||
|
||
Now, for the Waybar to appear you also need to change the output definition on [this file](../.config/waybar/config.jsonc).
|
||
|
||
- **Change Default Applications**
|
||
|
||
To change the default applications by filetype, be sure to install [this app](https://github.com/magnus-ISU/selectdefaultapplication).
|
||
|
||
```bash
|
||
yay -Sy selectdefaultapplication-fork-git
|
||
```
|
||
|
||
If you wanna change the default apps used in the Hyprland bindings, change the variables over on [this file](../.config/hypr/configs/default_apps.conf).
|
||
|
||
- **Git Changes**
|
||
|
||
If you are going to use git, be sure to change the user definition as well as the credentials over on the [gitconfig file](../.config/git/config).
|
||
|
||
- **Laptop Additions**
|
||
|
||
- **Bluetooth**
|
||
|
||
Lets start by installing bluez (bluetooth support) and overskride (GUI):
|
||
|
||
```bash
|
||
yay -Sy bluez overskride
|
||
```
|
||
|
||
After installing the required packages, we have to start the Bluetooth service. With systemd is pretty straightforward:
|
||
|
||
```bash
|
||
systemctl --user enable --now bluetooth.service
|
||
```
|
||
|
||
Now launch overskride and there you have it.
|
||
|
||
- **Brightness**
|
||
|
||
Brightness control is integrated with [SwayOSD](https://github.com/ErikReider/SwayOSD). It was installed in the first steps, so you should be able to change it. If not, be sure to read [this part](https://github.com/ErikReider/SwayOSD#brightness-control) on the SwayOSD documentation.
|
||
|
||
If you wanna have automatic screen brightness, install wluma.
|
||
|
||
```bash
|
||
yay -Sy wluma
|
||
```
|
||
|
||
Then, enable the systemd unit.
|
||
|
||
```bash
|
||
systemctl --user enable --now wluma.service
|
||
```
|
||
|
||
- **Wi-Fi**
|
||
|
||
To manage your Wi-Fi connections, I'd recommend you to install [iwgtk](https://github.com/J-Lentz/iwgtk):
|
||
|
||
```bash
|
||
yay -Sy iwgtk
|
||
```
|
||
|
||
After that, enable the systemd unit just like with wluma.
|
||
|
||
```bash
|
||
systemctl --user enable --now iwgtk.service
|
||
```
|
||
|
||
To manage all the other network configurations, use [nm-connection-editor](https://gitlab.gnome.org/GNOME/network-manager-applet)
|
||
|
||
- **Keyring Support**
|
||
|
||
There are some applications that you might need the keyring for. Examples: bitwarden, dbeaver, protonmail-bridge, vlc...
|
||
|
||
To enable the keyring support, install the following packages:
|
||
|
||
```bash
|
||
yay -Sy gnome-keyring libsecret
|
||
```
|
||
|
||
- **Specific Configs/Information** (_Optional_)
|
||
|
||
Finally, if you want to take a look at some specific app configuration, check the READMEs from each app in their respective config folders.
|
||
|
||
Some configuration examples are:
|
||
|
||
- [fish](../.config/fish/)
|
||
- [neovim](../.config/nvim/)
|
||
- [browser](../.config/browser/)
|
||
- [yazi](../.config/yazi/)
|
||
- [hyprland](../.config/hypr/)
|
||
- [vscodium](../.config/VSCodium/User/)
|
||
- [tmux](../.config/tmux/)
|
||
|
||
# :camera: <samp>Gallery</samp>
|
||
|
||
> [!NOTE]
|
||
> For specific images and videos about each tool, check out their own READMEs at their respective config folders. (STILL WIP 🚧)
|
||
>
|
||
> If you want to check the wallpapers, they are available [right here](../.config/hypr/theme/walls/.github/README.md).
|
||
|
||
| **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](https://www.reddit.com/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** |
|
||
| -------------------------------------------------------- |
|
||
|  |
|
||
|
||
| **Old Browser with Main Page** |
|
||
| -------------------------------------------------------- |
|
||
|  |
|
||
|
||
# :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 and for helping me to not lose my mind.
|
||
- [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.
|
||
- [Hyprdots](https://github.com/prasanthrangan/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](https://github.com/catppuccin/catppuccin) for making the **Best Colorscheme Ever** 🖌️
|
||
- [Github-issue-templates](https://github.com/stevemao/github-issue-templates) for the some of the markdown templates of the repo.
|
||
- [Shina-Fox](https://github.com/Shina-SG/Shina-Fox) for the incredible userChrome.
|
||
- [Catppuccin-Startpage](https://github.com/pivoshenko/catppuccin-startpage) an asthetic and clean startpage for the browser.
|
||
|
||
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!](https://github.com/stars/Matt-FTW/lists/paintbrush-theming-dots)
|
||
|
||
## :writing_hand: 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](https://github.com/Matt-FTW/dotfiles/issues/new/choose) or [submit a PR](https://github.com/Matt-FTW/dotfiles/pulls)
|
||
|
||
Please, before submitting a PR or opening an issue, be sure to follow the [contributing guidelines](./CONTRIBUTING.md), as well as the [issues](./ISSUE_TEMPLATE/) and [pull requests](./PULL_REQUEST_TEMPLATE.md) formatting rules.
|
||
|
||
Blank or repeated issues and PRs will be closed.
|
||
|
||
## :dollar: Donating
|
||
|
||
If you want to support my work, please consider donating.
|
||
|
||
This is optional, but it's always appreciated.
|
||
|
||
Thank you! :sparkling_heart:
|
||
|
||
[](https://github.com/sponsors/Matt-FTW)
|
||
[](https://ko-fi.com/matt_ftw)
|
||
[](https://www.buymeacoffee.com/matt_ftw)
|
||
|
||
## :two_hearts: Star History and Contributors
|
||
|
||
Thanks to everyone who have contributed and given an star to this project!
|
||
|
||
<div align="center">
|
||
|
||
### :pencil2: Contributors
|
||
|
||
</div>
|
||
|
||
<a href="https://github.com/Matt-FTW/dotfiles/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=Matt-FTW/dotfiles"/>
|
||
</a>
|
||
|
||
<div align="center">
|
||
|
||
### :star: Star History
|
||
|
||
</div>
|
||
|
||
<div>
|
||
<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>
|
||
</div>
|
||
|
||
<br>
|
||
|
||
<div align="center">
|
||
<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true"/>
|
||
</div>
|