PaimanUwU's Dotfiles 🚀

Welcome to my personal dotfiles repository! This is where I store and manage all my configuration files for various applications and tools, ensuring a consistent and comfortable development environment across my machines.

Overview

This repository uses GNU Stow to manage symbolic links for configuration files (dotfiles) from this repository into your home directory. This keeps your home directory clean and makes it easy to add or remove configurations.

Features

• Alacritty: Lightweight OpenGL terminal with Catppuccin Macchiato theme and herdr session management.
• Kitty: My GPU-accelerated terminal emulator with Catppuccin Macchiato theme, custom keybinds, and herdr session management.
• Neovim (nvim): My highly customized Neovim setup for a powerful and efficient coding experience.
• Zsh & Powerlevel10k (p10k): A beautiful and feature-rich Zsh shell with the blazing-fast Powerlevel10k theme.
• tmux: My configuration for the terminal multiplexer tmux for persistent sessions and split panes.
• yazi: Configuration for the modern, async, and customisable terminal file manager.
• cava: Setup for the console-based audio visualizer.
• neofetch: Configuration for displaying system information with an aesthetic touch.
• Zed: Configurations for the Zed code editor.
• Vicinae: Configuration for the Vicinae launcher and command palette (with telemetry disabled).
• Brewfile: Automated installation of macOS applications and tools using Homebrew.

Installation

Prerequisites

Before you begin, ensure you have the following installed:

• Git: For cloning this repository.
• Homebrew (macOS): My Brewfile automates software installation.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• GNU Stow: Used for symlinking the dotfiles.

brew install git
brew install stow

Clone the Repository

First, clone this repository into a directory I recommend ~/Documents/Dotfiles.

git clone https://github.com/PaimanUwU/Dotfiles.git ~/Documents/Dotfiles
cd ~/Documents/Dotfiles

Install Applications (Homebrew)

My Brewfile contains a list of all the applications, command-line tools, and casks that I use. You can install all of them at once using Homebrew:

brew bundle install --file=Brewfile

This command will read the Brewfile in the root of this repository and install everything listed.

Symlink Dotfiles (GNU Stow)

Once you've cloned the repository and installed Stow, navigate into the ~/dotfiles directory and use stow to create symbolic links.

Each top-level directory (e.g., nvim, zsh, tmux) represents a package of dotfiles.

To "stow" all dotfiles, run:

stow */

To undo,

stow -D */

Tips

you can read this cheatsheet

or,

just run this command in the terminal to see the cheatsheets in the terminal.

cheats

Structure

Here's an overview of the repository structure:

  .
 ├──  bat
 │   └──  .config
 │       └──  bat
 │           ├──  themes
 │           └── 󱁻 config
 ├──  cava
 │   └──  .config
 │       └──  cava
 │           ├──  shaders
 │           ├──  themes
 │           └── 󱁻 config
 ├──  fastfetch
 │   └──  .config
 │       └──  fastfetch
 │           └──  config.jsonc
 ├──  ghostty
 │   └──  .config
 │       └──  ghostty
 │           └── 󱁻 config
 ├──  kitty
 │   └──  .config
 │       └──  kitty
 │           ├──  themes
 │           │   └── 󱁻 catppuccin-macchiato.conf
 │           ├── 󱁻 kitty.conf
 │           └── 󱁻 startup.session
 ├──  images
 │   └── 󰉏 Pictures
 │       ├──  Screenshots
 │       │   ├──  'Screenshot 2026-03-10 at 3.38.57 AM.png'
 │       │   ├──  'Screenshot 2026-03-10 at 3.39.16 AM.png'
 │       │   ├──  'Screenshot 2026-03-10 at 3.39.56 AM.png'
 │       │   ├──  'Screenshot 2026-03-10 at 3.40.06 AM.png'
 │       │   └──  'Screenshot 2026-03-10 at 5.27.59 PM.png'
 │       └──  Wallpapers
 │           └──  waterfall.png
 ├──  neofetch
 │   └──  .config
 │       └──  neofetch
 │           └── 󱁻 config.conf
 ├──  nvim
 │   └──  .config
 │       └──  nvim
 │           ├──  lua
 │           ├──  LICENSE
 │           ├──  .neoconf.json
 │           ├──  lazy-lock.json
 │           ├──  lazyvim.json
 │           ├──  init.lua
 │           ├── 󰂺 README.md
 │           └──  stylua.toml
 ├──  p10k
 │   └──  .p10k.zsh
 ├──  tmux
 │   ├──  .config
 │   │   └──  tmux
 │   │       ├──  plugins
 │   │       └──  tmux.conf
 │   └──  .tmux
 │       └──  plugins
 │           └──  tpm
 ├──  yazi
 │   └──  .config
 │       └──  yazi
 │           ├──  keymap.toml
 │           ├──  theme.toml
 │           └──  yazi.toml
 ├──  vicinae
 │   └──  .config
 │       └──  vicinae
 │           └──  settings.json
 ├──  zed
 │   └──  .config
 │       └──  zed
 │           ├──  prompts
 │           ├──  themes
 │           ├──  keymap.json
 │           └──  settings.json
 ├──  zsh
 │   ├──  .hushlogin
 │   └── 󱆃 .zshrc
 ├── 󱄖 Brewfile
 ├── 󰡯 'Ghostty Settings'
 ├── 󰊢 .gitignore
 ├──  Cheatsheets.md
 ├──  Markdown-Cheatsheets.md
 ├── 󰂺 README.md
 ├──  .stow-local-ignore
 └──  .stowrc

Screenshots

Here are a few glimpses of my setup:

---