dotfiles — catppuccin edition

Personal dotfiles for Windows (AtlasOS) and Linux (CachyOS / Hyprland), managed with chezmoi.

           

 
 Preview 
     
 Install 
     
 Extras 
     
 Features 
     
 Credits 
   

---

Warning

This repo is under active development and may contain bugs or breaking changes at any time. Use at your own risk.

Preview

Windows

Linux

Coming soon

Overview

• Manager: chezmoi with mode = "symlink" — every managed file is a symlink to the chezmoi source, so edits take effect immediately without re-adding
• Secrets scanning: gitleaks via pre-commit hook
• Submodules: sddm and plymouth themes (run git submodule update --init --recursive after cloning)

Windows

Category	Tool	Config
Window Manager	GlazeWM	⚙️
Status Bar	YASB	⚙️
Shell	PowerShell 7	⚙️
Prompt	Starship · Oh My Posh	⚙️ · ⚙️
Terminal	WezTerm · Alacritty · Windows Terminal	⚙️ · ⚙️ · ⚙️
Editor	Zed	⚙️
File Manager	yazi	⚙️
App Launcher	Flow Launcher	⚙️
Clipboard	Ditto	⚙️
Context Menu	Nilesoft Shell	⚙️
Hotkeys	AutoHotkey	⚙️
Desktop Widgets	Rainmeter	⚙️
Customization	Windhawk	⚙️
Resource Monitor	btop	⚙️

Linux

My Linux setup is built on top of HyDE. If you're interested in a full Hyprland desktop setup, check it out first.

Category	Tool	Config
Desktop	HyDE + Hyprland	⚙️
Status Bar	Waybar	⚙️
Notifications	SwayNC	⚙️
OSD Overlays	SwayOSD	⚙️
Shell	zsh	⚙️
Prompt	Starship	⚙️
Terminal	Kitty · Ghostty	⚙️ · ⚙️
Multiplexer	tmux	⚙️
Editor	Zed	⚙️
File Manager	yazi	⚙️
Clipboard	cliphist	⚙️
Discord	Vesktop	⚙️
Email	aerc	⚙️
Chat	nchat	⚙️
YouTube	FreeTube	⚙️
Resource Monitor	btop	⚙️

Fresh install

See the full installation guide: INSTALL.md

Extra Optional Setup (Windows)

Catppuccin themes by Niivu

Theme	Preview
Catppuccin Cursors
Catppuccin for Windows 11 — Install guide

Wallpapers

• orangci/walls-catppuccin-mocha
• zhichaoh/catppuccin-wallpapers

Credits

Windows setup inspired by and borrowed from:

• jacquindev/windots
• ashish0kumar/windots
• ChrisTitusTech/powershell-profile
• SleepyCatHey/Ultimate-Win11-Setup

Daily workflow

# Edit a config directly — already in source via symlink
vim ~/.config/yazi/yazi.toml

# Sync everything to GitHub
dotfiles-sync

# Add a new file
chezmoi add ~/.config/newapp/config.toml

# Pull and apply from another machine
chezmoi update

# Check status
chezmoi status

# Run a run_once script manually (renders the template and executes it)
chezmoi execute-template < $(chezmoi source-path)/.chezmoiscripts/run_once_setup-windows-symlinks.ps1.tmpl | powershell -File -
chezmoi execute-template < $(chezmoi source-path)/.chezmoiscripts/run_once_install-packages.ps1 | bash

# Force re-run all run_once scripts on next apply (clears chezmoi state)
chezmoi state delete-bucket --bucket=scriptState && chezmoi apply