Pix3lexe dotfiles

Welcome to my legendary dotfiles repository! The setup script is designed for arch but everything can be installed on basically every linux distro if you do it manually. Have fun ^^

---

📋 Table of Contents

• Overview
• Features
• Installation
• Structure
• Usage
• Screenshots
• Contact

---

🛠️ Overview

Dotfiles are configuration files for various programs and tools, often starting with a dot (.). This repository:

• Provides a backup of my preferred environment setup.
• Designed for Linux-based systems (tested on Arch Linux).
• Allows quick deployment across systems.
• Uses GNU Stow.

---

✨ Features

• Configurations for tools like:
  • Neovim (nvim)
  • Zsh (zsh)
  • Tmux (tmux)
  • Yazi (yazi)
  • Kitty (terminal emulator)
• Easily customizable and extendable.

---

🖥️ Installation

Prerequisites

1. Clone this repository to your home directory or any preferred location:

   git clone https://github.com/Pix3lexe/dotfiles.git ~/dotfiles
   cd ~/dotfiles

2. Run setup script to install everything and deploy configurations:

   ./setup.sh

   • ✏️Note: If you only want to have a specific config look up Usage
   • ⚠️Warning: This script does not guarantee that every optional dependency is installed (eg. a latex compiler so that vimtex works). Install them by yourself if you need them.

🛠️ Hyprland Dependencies

Before using these dotfiles, make sure the following dependencies are installed if you're using Hyprland (these are specific to the Hyprland-based environment and related tools) or just run the setup script.

• hyprland: Window manager for Wayland.
• wofi: Application launcher.
• waybar: Status bar for Wayland.
• ttf-font-awesome: Icon font for status bars and UI customization.
• hyprshot: Screenshot tool for Hyprland.
• swaync: Notification daemon.
• hyprlock: Screen locker for Hyprland.
• hypridle: Idle management tool.
• hyprpaper: Wallpaper manager for Hyprland.
• nwg-look: GTK theme switcher for Wayland.
• xdg-desktop-portal-gtk: Desktop portal for GTK integration.
• xdg-desktop-portal-hyprland: Desktop portal specific to Hyprland.
• catppuccin-gtk-theme-mocha: GTK theme for a consistent aesthetic.
• wl-clipboard: Clipboard manager for Wayland.

---

📁 Structure

The repository is structured to be modular, with each folder representing a specific tool or program.

dotfiles/
├── nvim/            # Configuration for Neovim
│   └── .config/nvim/
├── zsh/             # Zsh shell configuration
│   └── .zshrc
├── tmux/            # Tmux configuration
│   └── .tmux.conf
└── ...

Each directory contains the relevant files, arranged in the same structure as their destination.

---

🚀 Usage

Apply Specific Configurations

To only stow (deploy) a specific configuration (eg. nvim):

stow -t ~ nvim

Remove Specific Configurations

To remove a symlink created by Stow (eg. nvim):

stow -D -t ~ nvim

---

📸 Screenshots

• Terminal

• Neovim

• Desktop and Wofi

• Custom wallpaper and flavor switcher

---

✉️ Contact

If you have questions or suggestions, feel free to reach out via GitHub Issues.