
💕 About
A Catppuccin Mocha themed Windows setup, built for looks, kept for how well it works.
Made this because I wanted my Windows setup to look and work good without fighting it every day, and honestly it took longer than it should have. Figured others might want the same, so here it is. Feel free to steal all or part of this setup and make it your own. I hope you enjoy it as much as I do!
🌠 Features
|
|
| 🪟 GlazeWM tiling window manager |
🍫 YASB status bar |
| 🧑💻 VSCode clean setup |
>_ Windows Terminal modern look |
| 🐚 PowerShell enhancements |
🎨 Oh My Posh prompt |
| ⚙️ fastfetch system info |
🚀 Flow Launcher workflow |
| 🦅 Themed Start menu, Taskbar, Notification Center |
🧱 Wallpapers |
| 🐈⬛ Catppuccin Mocha color scheme everywhere |
🌺 Theme for Almost Everything |
🌺 Core System Overview
ℹ️ Complete System Overview
🪟 System
🖥️ CLI/TUI Apps
🖱️ GUI Apps
| 📚 Entry | ✨ App |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| Fallback Text Editor | VSCode ⚙️ |
| Music Player | 🤍 Spotify (patched with Spicetify) |
| Web Browser | 🤍 Zen-Browser ⚙️ |
| Note Taking App | 🤍 Obsidian |
| File Manager | File Explorer | ⚙️ |
| Game Launcher | Hydra Launcher ⚙️ |
| Clipboard Manager | CopyQ ⚙️ |
| Torrent Manager | qBittorrent ⚙️ |
| Discord Client | 🤍 Equicord |
| YouTube Music Client | Th-Ch YouTube Music ⚙️ |
| Web Themer | 🤍 Stylus (for Firefox) with 🤍 Catppuccin Mocha ⚙️ |
🔍 Other
🔧 Setup
⚠️ Backup your current configuration files before continuing.
Applying these settings may overwrite existing configs, so be sure to manually merge or restore as needed.
🪟 GlazeWM
📊 YASB (Yet Another Status Bar)
[!NOTE]
Ensure you have JetBrainsMono Nerd Font installed for correct icon display. If you want to use another Nerd Font, adjust the font settings and unicode mappings in the YASB styles.css & config.yaml respectively.
To setup Libre Hardware Monitor for your specific hardware, check the YASB Wiki.
🖼️ Tacky Borders
📝 VSCode
📂 Windows Explorer
This process requires administrator privileges and system modifications.
Step 1: Install SecureUxTheme
SecureUxTheme allows custom themes to be applied on Windows 11.
-
Install SecureUxTheme using winget:
winget install namazso.SecureUXTheme
-
Run SecureUxTheme as administrator
-
Check the Hook SystemSettings and Remove DefaultColors checkbox.
-
DO NOT check Hook Explorer (can cause instability)
-
Click Install
-
Reboot your PC
Step 2: Install the Catppuccin Theme
- Copy all files and folders from
windots/.dotfiles/explorer/Theme/ → C:\Windows\Resources\Themes\
- After reboot, open SecureUxTheme again as administrator
- Select
Catppuccin Mocha theme from the list
- Click Patch and Apply
- The theme is now active! You can now change it anytime from Settings → Personalization → Themes
Step 3: Add Explorer Blur Effect
- Create a folder for custom scripts (e.g.,
C:\scripts\)
- Copy the
Explorerblur folder → C:\scripts\
- Navigate to
C:\scripts\Explorerblur\
- Right-click
register.cmd and select Run as administrator
- The blur effect is now active!
🌐 Browser
These configs are applicable only for Firefox-based browsers.
Enable userChrome.css and userContent.css
- Open
about:config in the address bar.
- Search for
toolkit.legacyUserProfileCustomizations.stylesheets.
- Set it to
true.
Locate your profile folder
- Open
about:support in the address bar.
- Find “Profile Folder” and click “Open Folder.”
Copy the browser styling configs
Optional: Theme websites
- Install the Stylus extension.
- **Download the **Userstyles** import file.
- Open the Stylus “manage” page.
- On the sidebar panel, click the Import button in the Backup section, and select the downloaded Userstyles file.
For websites without userstyles, you can use the Dark Reader extension:
- Open Dark Reader extension settings.
- Click on Dev tools > Advance > Preview New Design and close the window.
- Go to See all options > Colors > Color Schemes & choose Catppuccin from the list of presets.
- Close the settings tab (no apply button).
Custom Start Page
- Get my Catppuccin Themed Start Page or fork it to create your own.
- Host it on Github Pages or Vercel. I suggest using Vercel as it’s faster and easier to set up.
- Set it as your default home page in browser settings.
- For Firefox, you can also set it as the new tab page using the New Tab Override extension.
🚀 Flow Launcher
🦅 Windhawk
- Install Windhawk version 2.0 alpha 2 or later.
- Download the
Windhawk.json file.
- Open Windhawk, Go to Settings > Backup & Restore > Import > From a backup file and select the downloaded
Windhawk.json and click Import.
You may backup your current configs just to be safe.
🐚 Nilesoft Shell
🚀 Hydra Launcher
- **Copy the content inside
windots/.dotfiles/HydraLauncher/styles.css
- Open Hydra Launcher and go to Settings > Appearance > Create, type any name and press enter, then paste the config and save the file to apply it.
🌐 qBittorrent
- Download the config from
windots/.dotfiles/qBittorrent/mocha.qbtheme & place it anywhere safe into a folder of your choice. I suggest making a separate folder for themes inside the script folder I asked to create earlier like C:\scripts\themes\
- Open qBittorrent and on the top bar go to Tools > Options, check the Use custom UI Theme options & then browse and select the downloaded theme file.
🎵 Spotify
-
Install Spotify if you haven’t already.
-
Open Powershell and run the following commands to install Spicetify and Spicetify Marketplace:
-
Open Spotify and in the top bar, click on the Marketplace icon, then search for Catppuccin theme and install it. Then, select Mocha as the scheme.
You can instead search for and install Termspot theme and set Mocha as the scheme if you want a terminal-like look.
🐈⬛ Discord
-
Install Discord if you haven’t already.
-
Download Equilotl and Install it.
-
Open Discord and the click on the Settings icon at the bottom beside your profile. Under the Equicord section, click on Themes and then click on Edit QuickCSS. Paste the text below into the editor:
@import url("https://catppuccin.github.io/discord/dist/catppuccin-mocha-mauve.theme.css");
-
Save the changes with Ctrl + S and quit the editor.
🎥 YouTube Music
- Install Th-Ch YouTube Music.
- Download the config from
windots/.dotfiles/youtubemusic/ytmusic.css & place it anywhere safe into a folder of your choice, probably the same folder you used for the qBittorrent theme.
- Open YouTube Music and on the top bar go to Options > Visual Tweaks > Theme and click on Import custom css file, then browse and select the downloaded theme file.
©️ CopyQ
- Install CopyQ.
- Copy the config files from
windots/.dotfiles/copyq/catppuccin-mocha.ini → %APPDATA%\CopyQ\themes\
- Open CopyQ, on the top bar go to File > Preferences > Appearance, click on load theme, select the
catppuccin mocha.ini file you copied earlier, and click on Apply.
🔗 ShareX
>_ Terminal & Shell Setup
🖥️ Windows Terminal
🐚 PowerShell
This only applies to the recent versions of PowerShell from the official GitHub releases. If you want to stick with the default Windows PowerShell, you should figure out the steps yourself.
Installing the following dependencies is recommended for a better experience with PowerShell:
winget install -e --id junegunn.fzf
winget install ajeetdsouza.zoxide
Install-Module -Name PSFzf -Scope CurrentUser -Force
🎨 Oh My Posh
⚙️ Fastfetch
📂 Superfile
⌨️ GlazeWM Keybindings
Show Keybindings
Window Management
| Keys |
Action |
| win + left / down / up / right |
Focus window left / down / up / right |
| win + shift + left / down / up / right |
Move focused window left / down / up / right |
| win + q |
Close focused window |
| win + m |
Toggle window minimization |
| win + f |
Toggle fullscreen |
| win + t |
Toggle tiling mode |
| win + space |
Toggle floating mode |
| win + shift + v |
Toggle tiling direction |
| win + shift + space |
Cycle focus: tiling → floating → fullscreen |
| win + 1-9 |
Focus workspace {1-9} |
| win + shift + 1-9 |
Move focused window to workspace {1-9} |
| win + shift + j / l / i / k |
Move focused window’s workspace to monitor left / right / up / down |
| win + alt + left / right |
Resize active window’s width -/+ 2% |
| win + alt + up / down |
Resize active window’s height +/- 2% |
| win + shift + e |
Exit GlazeWM |
| win + shift + r |
Reload GlazeWM config |
| win + shift + p |
Pause/Resume all GlazeWM keybindings |
Application Shortcuts
| Keys |
Action |
| win + enter |
Open terminal |
| win + e |
Open File Explorer |
| win + c |
Open VSCode |
| win + b |
Open Zen Browser |
| win + s |
Open Spotify |
| win + y |
Open Youtube Music |
🖼️ Gallery
You can check out the wallpapers here if you’re interested!
| GUI Text Editor |
Start Menu, Taskbar and Notification Center |
 |
 |
| Spotify with Spicetify |
Power Menu |
 |
 |
| GlazeWM Window Manager |
Flow Launcher |
 |
 |
| Discord Client |
Web Browser |
 |
 |
You can check out all the previews here!
📢 Discussions
Have questions, suggestions, or want to showcase your setup? Or maybe you need some help?
Visit the Discussions section.
⚠️ Please open an issue only for reproducible bugs or critical problems.
For all other questions, feedback, or general help, Discussions is preferred.
🎉 Credits
Special mention to the following resources and projects that were especially helpful during setup:
- GlazeWM for delivering an outstanding tiling window manager that boosts productivity ✨
- YASB for a customizable and feature-rich status bar that fits seamlessly into the setup 🚀
- Catppuccin for creating the best color scheme ever 🖌️
- Windhawk for providing a powerful and flexible modding framework for Windows 🛠️
- Nilesoft Shell for the custom context menu that enhances usability 🖱️
- pivoshenko for the clean and aesthetic browser startpage 🌐
- ashish for some of the config files & readme design 🤍
评论