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!
| πͺ 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 |
| Component | Tool |
|---|---|
| OS | Windows 11 π₯οΈ |
| Window Manager | GlazeWM πͺ |
| Shells | PowerShell π» |
| Terminal | Windows Terminal π²οΈ |
| Status Bar | YASB π |
| Windows Border | Tacky Borders πΌοΈ |
| Editors | VSCode π |
| Launcher | Flow Launcher π |
| File Managers | File Explorer ποΈ |
| Web Browser | Zen-Browser π |
| Theme | Catppuccin Mocha π§ |
βΉοΈ Complete System Overview
| π Entry | β¨ App |
|---|---|
| OS | Windows 11 |
| Window Manager | π€ GlazeWM βοΈ |
| Bar | π€ YASB βοΈ |
| Application Launcher | π€ Flow Launcher βοΈ |
| Mods | π€ Windhawk βοΈ |
| Context Menu | Nilesoft Shell βοΈ |
| Theme | π€ SecureUxTheme with Nivuu's Catppuccin Mocha theme |
| π Entry | β¨ App |
|---|---|
| Shell | pwsh βοΈ |
| Terminal Emulator | windows terminal βοΈ |
| Shell Prompt | ohmyposh βοΈ |
| System Fetch | π€ fastfetch βοΈ |
| Terminal File Manager | superfile |
| π 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 βοΈ |
| π Entry | β¨ App |
|---|---|
| Colorscheme | π€ Catppuccin Mocha |
| Font | JetBrainsMono Nerd Font |
β οΈ 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
- Install GlazeWM.
windots/.dotfiles/glazewm/config.yamlβ%USERPROFILE%\.glzr\glazewm\config.yaml- Restart GlazeWM for the changes to take effect.
π 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.yamlrespectively.
To setup Libre Hardware Monitor for your specific hardware, check the YASB Wiki.
- Install YASB.
windots/.dotfiles/yasb/β%USERPROFILE%\.config\yasb\- Restart YASB for the changes to take effect.
πΌοΈ Tacky Borders
- Install Tacky Borders.
windots/.dotfiles/tackyborders/config.yamlβ%USERPROFILE%\.config\tacky-borders\config.yaml- Restart Tacky Borders for the changes to take effect.
π VSCode
- Install the Catppuccin Theme extension.
- Install the Catppuccin Icons extension.
- Install the Material Product Icons extension.
- Install the Custom UI Style extension.
- Install the GlassIt-VSC extension.
windots/.dotfiles/vscode/settings.jsonβ%APPDATA%\Code\User\settings.json- Restart VSCode to load the updated settings.
π Windows Explorer
[!WARNING] This process requires administrator privileges and system modifications.
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 SystemSettingsandRemove DefaultColorscheckbox. -
DO NOT check
Hook Explorer(can cause instability) -
Click Install
-
Reboot your PC
- Copy all files and folders from
windots/.dotfiles/explorer/Theme/βC:\Windows\Resources\Themes\ - After reboot, open SecureUxTheme again as administrator
- Select
Catppuccin Mochatheme from the list - Click Patch and Apply
- The theme is now active! You can now change it anytime from Settings β Personalization β Themes
- Create a folder for custom scripts (e.g.,
C:\scripts\) - Copy the
Explorerblurfolder βC:\scripts\ - Navigate to
C:\scripts\Explorerblur\ - Right-click
register.cmdand select Run as administrator - The blur effect is now active!
π Browser
[!NOTE] These configs are applicable only for Firefox-based browsers.
- Open
about:configin the address bar. - Search for
toolkit.legacyUserProfileCustomizations.stylesheets. - Set it to
true.
- Open
about:supportin the address bar. - Find "Profile Folder" and click "Open Folder."
windots/.dotfiles/zen/userChrome.cssβ<Your Profile Folder>/chrome/windots/.dotfiles/zen/userContent.cssβ<Your Profile Folder>/chrome/- Restart your browser for the changes to take effect.
- 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).
- 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
- Install Flow Launcher
windots/.dotfiles/FlowLauncher/β%APPDATA%\FlowLauncher\- Restart Flow Launcher
π¦ Windhawk
- Install Windhawk version 2.0 alpha 2 or later.
- Download the
Windhawk.jsonfile. - Open Windhawk, Go to Settings > Backup & Restore > Import > From a backup file and select the downloaded
Windhawk.jsonand click Import.[!NOTE] You may backup your current configs just to be safe.
π Nilesoft Shell
- Install Nilesoft Shell.
- Copy the shell theme file from
windots/.dotfiles/nilesoftshell/theme.nssβC:\Program Files\Nilesoft Shell\imports\ - Open the app with admin permissions and click on Register.
π 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 likeC:\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:
-
Spicetify:
iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex
-
Spicetify Marketplace:
iwr -useb https://raw.githubusercontent.com/spicetify/marketplace/main/resources/install.ps1 | iex
-
-
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.inifile you copied earlier, and click on Apply.
π ShareX
- Install ShareX.
- Copy the content of
windots/.dotfiles/sharex/sharex.jsonto your clipboard. - Open ShareX's Application Settings and go to Theme > Import > From Clipboard.
π₯οΈ Windows Terminal
- Install Windows Terminal.
windots/.dotfiles/terminal/settings.jsonβ%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\- Restart Windows Terminal to see the updated config.
π PowerShell
[!Note] 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.
-
windots/.dotfiles/Powershell/Microsoft.PowerShell_profile.ps1β%USERPROFILE%\Documents\PowerShell\ -
Restart PowerShell to apply the changes.
If you get an error about the execution policy, run the following command in PowerShell as administrator:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
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
-
Install Oh My Posh using winget:
winget install JanDeDobbeleer.OhMyPosh -s winget
-
windots/.dotfiles/ohmyposh/catppuccin.jsonβ%USERPROFILE%\.config\ohmyposh\
βοΈ Fastfetch
-
Install fastfetch using winget:
winget install fastfetch
-
windots/.dotfiles/fastfetch/config.jsoncβ%USERPROFILE%\.config\fastfetch\ -
windots/.dotfiles/fastfetch/windows.txtβ%USERPROFILE%\.config\fastfetch\ -
Run fastfetch.
π Superfile
-
Run this command in powershell:
winget install --id yorukot.superfile
Show Keybindings
| 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 |
| 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 |
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!
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.
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 π€













