Welcome to my dotfiles repository! This repository contains my personalized configurations to enhance my Windows experience with a clean, minimal, and aesthetic look inspired by Catppuccin Mocha.
Screenshots showing the look of my customized Windows setup.
- Elegant UI Customization: Refined window borders, themes, and other tweaks.
- Efficient Workflow: Tools and configurations aimed at boosting productivity.
- Consistency Across Environments: Easy to replicate setup for any user.
| Component | Tested on | Notes |
|---|---|---|
| Windows | Windows 11 23H2 / 24H2 | Some Windhawk mods may vary between builds |
| PowerShell | 7.x | Required for helper scripts in scripts/ |
| Yasb | latest | Requires Nerd Font for icons |
| Windhawk | latest | Import JSON in each mod's Advanced section |
| Fastfetch | latest | If logo path fails, use %USERPROFILE%\\.config\\fastfetch\\windows.txt |
- 📌 Topbar: Yasb (My custom config)
- 🎨 Window Borders: Cute Borders (Config: cuteborders config)
- 🖼️ Wallpapers: A collection from various sources (View wallpapers)
- 📂 Windhawk: Customizations for Start Menu, Taskbar, and more (config)
- ⚡ Fetch: Fastfetch (Config: fastfetch config)
- 🔎 Spotlight-Like Search: PowerToys Run
- 💻 PowerShell Profile: Oh My Posh (ChrisTitusTech config)
- 🟤 Brave Theme: Catppuccin Mocha Theme
- 🌐 Website Themes: Custom Stylus themes (config)
- 🎵 Spotify Theme: Spicetify (Theme:
text darkthemer+ Catppuccin Mocha) - 🖥️ Other Apps Themes: Catppuccin Ports
Note
These configurations are personalized. Some settings may need to be adjusted for your preferences.
Feel free to explore, tweak, and adapt these configurations to fit your own workflow!
If you have any questions, feel free to ask on my Reddit post.
Run these from the repo root in PowerShell:
# Validate tracked configs
./scripts/validate.ps1
# One-command bootstrap (copies core configs)
./scripts/setup.ps1
# Apply old context menu and restart Explorer
./scripts/apply-context-menu.ps1 -Mode old -RestartExplorer
# Restore default Windows 11 context menu
./scripts/apply-context-menu.ps1 -Mode win11 -RestartExplorerUse this for a fast first-time setup after installing the required apps:
# Run validation + copy configs to your profile
./scripts/setup.ps1
# Optional: also apply old context menu and restart Explorer
./scripts/setup.ps1 -ContextMenu old -RestartExplorerBoth tools are essential for this setup. Install them via the Microsoft Store:
- PowerShell 7
- Windows Terminal (Pre-installed in most Windows 11 versions, but not in Windows 11 IoT Enterprise LTSC)
PowerToys enhances the system, and PowerToys Run is a key feature:
- Install PowerToys: Download
- Install Everything Search
- Install Everything PowerToys Plugin
- Install Yasb
- Replace the default configuration with my config:
%USERPROFILE%\.config\yasb\config.yaml %USERPROFILE%\.config\yasb\styles.css
Tip: Press the Windows key + R and paste the path to go faster.
- Open
config.yamland set your own weather API key and location (details in configs/yasb/README.md).
Adds custom-colored borders to windows:
- Install Cute Borders
- Replace the default config with my cuteborders config
Tip: Press the Windows key + R and paste the path to go faster.
%USERPROFILE%\.cuteborders\config.yaml
Install Windhawk
- Add mods like:
- Notification Center Styler
- Start Menu Styler
- Taskbar Styler
- Taskbar Tray Icon Spacing
- Configure each mod under the "Advanced" tab using my settings from windhawk configs
- Use restore-old-context-menu.reg to switch to the old context menu style.
- Use restore-win11-context-menu.reg to restore the default Windows 11 style.
- You can apply either file directly or use
./scripts/apply-context-menu.ps1.
- Use Oh My Posh with Chris Titus Tech's profile:
https://github.com/ChrisTitusTech/powershell-profile
- Follow his installation guide.
-
Install Fastfetch
-
Generate a config file:
fastfetch --gen-config
-
Locate the config:
%USERPROFILE%\.config\fastfetch\ OR C:\ProgramData\fastfetch\Tip: Press the Windows key + R and paste the path to go faster.
-
Replace it with my custom config from configs/fastfetch/
-
Run Fastfetch by typing:
fastfetch
- Windows Terminal: Follow this guide
- VS Code:
- Install Catppuccin Theme
- Install Catppuccin Icons
- Brave/Chrome: Install Catppuccin Mocha Theme
- Stylus (Website Theming):
- Import config from configs/stylus/stylus.json
- Explore more themes: Catppuccin Userstyles
- Install Spicetify (
⚠️ Use the browser-downloaded version of Spotify, NOT the Microsoft Store version) - Run installation command:
iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex
- Be sure to enable the marketplace through the installation processes and then install:
- Theme:
text darkthemer - Variant:
Catppuccin Mocha
- Theme:
- Install Vencord
- In Discord settings, go to Vencord > Themes
- Add this Online Theme:
https://raw.githubusercontent.com/refact0r/midnight-discord/refs/heads/master/flavors/midnight-catppuccin-mocha.theme.css
- YASB weather widget shows no data: add your key/location in
configs/yasb/config.yamland verify internet access. - Icons look wrong or squares appear: install a Nerd Font (JetBrainsMono NF recommended) and restart affected apps.
- Context menu style did not change: run
./scripts/apply-context-menu.ps1 -Mode old -RestartExploreror sign out and back in. - Fastfetch logo path error: update
configs/fastfetch/config.jsonclogo source to your local path. - PowerShell profile issues: restore from
Microsoft.PowerShell_profile.ps1.bak-*backup created byscripts/setup.ps1.
Big thanks to everyone at r/desktops for inspiring me to make this!
I wanna point out some resources and people that helped me the most with the setup:
- ashish0kumar for being my main reference in creating my rice 🙏
- elrondforwin for assisting me with my setup process 🛠️
Feel free to use and modify these dotfiles to suit your needs.
