https://github.com/swopnil7/windots
My personal Windows dotfiles and configs.
https://github.com/swopnil7/windots
ahk autohotkey catppuccin dotfiles glazewm hydralauncher ricing terminal unixporn windhawk windows-11 windows-theme winrice yasb
Last synced: 11 months ago
JSON representation
My personal Windows dotfiles and configs.
- Host: GitHub
- URL: https://github.com/swopnil7/windots
- Owner: swopnil7
- License: mit
- Created: 2025-06-19T10:41:10.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-23T15:21:23.000Z (11 months ago)
- Last Synced: 2025-07-23T17:22:18.928Z (11 months ago)
- Topics: ahk, autohotkey, catppuccin, dotfiles, glazewm, hydralauncher, ricing, terminal, unixporn, windhawk, windows-11, windows-theme, winrice, yasb
- Homepage:
- Size: 69.9 MB
- Stars: 23
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README









## 💕 About
> _A Catppuccin Mocha themed Windows dotfiles setup for those who love a beautiful, unified, and productive desktop._
If you love customizing every detail or just want a gorgeous, cohesive look with minimal hassle, **Windots** is for you. Whether you're a power user or just want things to look and work great out of the box, you'll find something here to make your Windows experience smoother and more enjoyable.
---
## 🌠 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](https://github.com/swopnil7/windots/tree/main/wallies#readme) |
| 🐈⬛ [Catppuccin Mocha](https://github.com/catppuccin) color scheme everywhere | 🌺 Theme for Almost Everything |
---
## 🌺 Core System Overview
| Component | Tool |
|---|---|
| **OS** | [Windows 11](https://www.microsoft.com/en-in/windows/windows-11) 🖥️ |
| **Window Manager** | [GlazeWM](https://github.com/glzr-io/glazewm) 🪟 |
| **Shells** | [PowerShell](https://learn.microsoft.com/en-us/powershell/) 💻 |
| **Terminal** | [Windows Terminal](https://github.com/microsoft/terminal) 🖲️ |
| **Status Bar** | [YASB](https://github.com/amnweb/yasb) 📊 |
| **Editors** | [VSCode](https://code.visualstudio.com/) 📝 |
| **Launcher** | [Flow Launcher](https://www.flowlauncher.com/) 🔍 |
| **File Managers** | [File Explorer](https://www.microsoft.com/en-us/windows/tips/file-explorer) 🗂️ |
| **Web Browser** | [Zen-Browser](https://zen-browser.app) 🌎 |
| **Theme** | [Catppuccin](https://catppuccin.com/) 🧁 |
---
ℹ️ Complete System Overview
#### 🪟 System
| 📚 Entry | ✨ App |
|---|---|
| **OS** | [Windows 11](https://www.microsoft.com/en-in/windows/windows-11) |
| **Window Manager** | 🤍 [GlazeWM](https://github.com/glzr-io/glazewm) [⚙️](https://github.com/swopnil7/windots/blob/master/.dotfiles/glazewm/config.yaml) |
| **Bar** | 🤍 [YASB](https://github.com/amnweb/yasb) [⚙️](https://github.com/swopnil7/windots/blob/master/.dotfiles/yasb/) |
| **Application Launcher** | 🤍 [Flow Launcher](https://www.flowlauncher.com/) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/FlowLauncher/Settings.json) |
| **Mods** | 🤍 [Windhawk](https://windhawk.net/) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/windhawk/) |
| **Context Menu** | [Nilesoft Shell](https://nilesoft.org/) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/nilesoftshell/) |
| **Theme** | 🤍 [SecureUxTheme](https://github.com/namazso/SecureUxTheme) with [Nivuu's Catppuccin Mocha theme](https://www.deviantart.com/niivu/art/Catppuccin-for-Windows-11-1076249390) |
#### 🖥️ CLI/TUI Apps
| 📚 Entry | ✨ App |
|---|---|
| **Shell** | [pwsh](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_pwsh?view=powershell-7.4) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/Powershell/Microsoft.PowerShell_profile.ps1) |
| **Terminal Emulator** | [windows terminal](https://github.com/microsoft/terminal) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/terminal/settings.json) |
| **Shell Prompt** | [ohmyposh](https://ohmyposh.dev/) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/ohmyposh/zen.toml) |
| **System Fetch** | 🤍 [fastfetch](https://github.com/fastfetch-cli/fastfetch) [⚙️](https://github.com/swopnil7/dotfiles/blob/master/.dotfiles/fastfetch/config.jsonc) |
#### 🖱️ GUI Apps
| 📚 Entry | ✨ App |
|---|---|
| **Fallback Text Editor** | [VSCode](https://code.visualstudio.com/) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/vscode/settings.json) |
| **Music Player** | 🤍 [Spotify](https://open.spotify.com/) (patched with [Spicetify](https://spicetify.app/)) |
| **Web Browser** | 🤍 [Zen-Browser](https://zen-browser.app) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/zen/) |
| **Note Taking App** | 🤍 [Obsidian](https://obsidian.md/) |
| **File Manager** | [File Explorer](https://www.microsoft.com/en-us/windows/tips/file-explorer) | [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/explorer/) |
| **Game Launcher** | [Hydra Launcher](https://hydralauncher.gg/) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/HydraLauncher/styles.css) |
| **Clipboard Manager** | [CopyQ](https://github.com/hluk/CopyQ) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/copyq/catppuccin-mocha.ini) |
| **Torrent Manager** | [qBittorrent](https://www.qbittorrent.org/) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/qBittorrent/catppuccin-mocha.qbtheme) |
| **Discord Client** | 🤍 [Vencord](https://vencord.dev/) |
| **YouTube Music Client** | [Th-Ch YouTube Music](https://github.com/th-ch/youtube-music) [⚙️](https://github.com/swopnil7/windots/blob/main/.dotfiles/youtubemusic/) |
| **Web Themer** | 🤍 [Stylus](https://addons.mozilla.org/en-US/firefox/addon/stylus/) (for Firefox) with 🤍 [Catppuccin Mocha](https://github.com/catppuccin) [⚙️](https://github.com/catppuccin/userstyles/blob/main/docs/USAGE.md) |
#### 🔍 Other
| 📚 Entry | ✨ App |
|---|---|
| **Colorscheme** | 🤍 [Catppuccin Mocha](https://catppuccin.com) |
| **Font** | [JetBrainsMono Nerd Font](https://www.jetbrains.com/lp/mono/) |
---
## 🔧 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
- **Install** [**GlazeWM**](https://github.com/glzr-io/glazewm/releases/).
- [`windots/.dotfiles/glazewm/config.yaml`](.dotfiles/glazewm/config.yaml) → `%USERPROFILE%\.glzr\glazewm\`
- **Restart GlazeWM** for the changes to take effect.
### 📊 YASB (Yet Another Status Bar)
> [!NOTE]
> Ensure you have a Nerd Font installed for correct icon display. I use [**JetBrainsMono Nerd Font**](https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.zip); if you use another Nerd Font, adjust the font settings in the YASB `styles.css` as needed.
- **Install** [**YASB**](https://github.com/amnweb/yasb/releases/).
- [`windots/.dotfiles/yasb/`](.dotfiles/yasb/) → `%USERPROFILE%\.config\yasb\`
- **Restart YASB** for the changes to take effect.
### 📝 VSCode
> [!WARNING]
> If you want the **APC Customize UI Extension**, Use VSCode `v1.91.1` or below, as newer versions do not support it. It is not compulsory though and VSCode will still look good without it.
- Enhance your **VSCode UI** with these **extensions**:
- [APC Customize UI](https://marketplace.visualstudio.com/items?itemName=drcika.apc-extension) - Customize the VSCode interface (optional)
- [GlassIt-VSC](https://marketplace.visualstudio.com/items?itemName=s-nlf-fh.glassit) - Add a transparent/glass effect (optional)
- **Install** the [Alt Catppuccin Theme](https://marketplace.visualstudio.com/items?itemName=dooez.alt-catppuccin-vsc) extension.
- [`windots/.dotfiles/vscode/settings.json`](.dotfiles/vscode/settings.json) → `%APPDATA%\Code\User\`
- **Restart VSCode** to load the updated settings.
### 📂 Windows Explorer
- **Install** [**SecureUxTheme**](https://github.com/namazso/SecureUxTheme/releases/tag/v4.0.0) tool and reboot your PC. You can also use the winget command below to install it:
```bash
winget install namazso.SecureUXTheme
```
- Copy the files and folder inside [`windots/.dotfiles/explorer/Theme/`](.dotfiles/explorer/Theme/) to → `C:\Windows\Resources\Themes\`
- **Open** settings & go to themes under the personalization section and then select Catppuccin Mocha as the theme.
- **Get** the [**Resource Redirect**](https://windhawk.net/mods/icon-resource-redirect) mod on Windhawk and **select** Linuxfx 11 AIO as the icon theme from the available presets.
- **Copy** the [Explorerblur](.dotfiles/explorer/Explorerblur/) folder (I suggest creating a seperate folder in the C drive for windows rice tools, named scripts in my case) to somewhere safe. Then, run the register.cmd file.
### 🌐 Browser
> [!NOTE]
> These configs are applicable **only for Firefox-based browsers**.
#### Enable userChrome.css and userContent.css
1. Open `about:config` in the address bar.
2. Search for `toolkit.legacyUserProfileCustomizations.stylesheets`.
3. Set it to `true`.
#### Locate your profile folder
1. Open `about:support` in the address bar.
2. Find "Profile Folder" and click "Open Folder."
#### Copy the browser styling configs
- [`windots/.dotfiles/zen/userChrome.css`](.dotfiles/zen/userChrome.css) → `/chrome/`
- [`windots/.dotfiles/zen/userContent.css`](.dotfiles/zen/userContent.css) → `/chrome/`
- **Restart your browser** for the changes to take effect.
#### Optional: Theme websites
- **Install** the [**Stylus**](https://addons.mozilla.org/en-GB/firefox/addon/styl-us/) extension.
- **Download the [**Userstyles**](https://github.com/catppuccin/userstyles/releases/download/all-userstyles-export/import.json) 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**](https://addons.mozilla.org/en-US/firefox/addon/darkreader/) extension:
1. Open Dark Reader extension settings.
2. Click on Dev tools > Advance > Preview New Design and close the window.
3. Go to See all options > Colors > Color Schemes & choose Catppuccin from the list of presets.
4. Close the settings tab (no apply button).
#### Custom Start Page
- Get my [**Catppuccin Themed Start Page**](https://github.com/swopnil7/startpage) or fork it to create your own.
- **Host it** on Github Pages or Vercel. I suggest using [**Vercel**](https://vercel.com/) 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**](https://addons.mozilla.org/en-US/firefox/addon/new-tab-override/) extension.
### 🚀 Flow Launcher
- **Install** [**Flow Launcher**](https://www.flowlauncher.com/)
- [`windots/.dotfiles/FlowLauncher/`](.dotfiles/FlowLauncher/) → `%APPDATA%\FlowLauncher\`
- **Restart Flow Launcher**
### 🦅 Windhawk
- **Install** [**Windhawk**](https://windhawk.net/).
- **Install Relevant Mods** from the [Windhawk Store](https://windhawk.net/explore):
- Notification Center Styler
- Start Menu Styler
- Taskbar Styler
- Windows 11 File Explorer Styler
- Taskbar auto-hide when maximized
- **Copy** the Windhawk config files from [`windots/.dotfiles/windhawk/`](.dotfiles/windhawk/)
- Open the relevant mod’s **details page**, go to **Advanced > Mod Settings**, paste the config, and click **"Load"** to apply it.
### 🐚 Nilesoft Shell
- **Install** [**Nilesoft Shell**](https://nilesoft.org/).
- **Copy** the shell theme file from [`windots/.dotfiles/nilesoftshell/theme.nss`](.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`](.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`](.dotfiles/qBittorrent/catppuccin-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**](https://www.spotify.com/download/windows/) if you haven't already.
- **Open** Powershell and run the following commands to install **Spicetify** and **Spicetify Marketplace**:
- Spicetify:
```powershell
iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex
```
- Spicetify Marketplace:
```powershell
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 **Comfy** theme and install it. Then, select Catppuccin Mocha as the scheme.
### 🐈⬛ Discord
- **Install** [**Discord**](https://discord.com/download) if you haven't already.
- **Download** [**Vencord**](https://github.com/Vencord/Installer/releases/latest/download/VencordInstaller.exe) and **Install** it.
- Open Discord and the click on the **Settings** icon at the bottom beside your profile. Under the **Vencord** section, click on **Themes** and then click on **Edit QuickCSS**. Paste the text below into the editor:
```css
@import url("https://catppuccin.github.io/discord/dist/catppuccin-mocha-pink.theme.css");
```
- **Save** the changes with Ctrl + S and quit the editor.
### 🎥 YouTube Music
- **Install** [**Th-Ch YouTube Music**](https://github.com/th-ch/youtube-music/releases).
- **Download** the config from [`windots/.dotfiles/youtubemusic/ytmusic.css`](.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**](https://github.com/hluk/CopyQ/releases).
- **Copy** the config files from [`windots/.dotfiles/copyq/catppuccin-mocha.ini`](.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
- **Install** [**ShareX**](https://getsharex.com/).
- **Copy** the content of [`windots/.dotfiles/sharex/sharex.json`](.dotfiles/sharex/sharex.json) to your clipboard.
- **Open** ShareX's **Application Settings** and click to **Theme** > **Import** > **From Clipboard**.
---
## \>_ Terminal & Shell Setup
### 🖥️ Windows Terminal
- **Install** [**Windows Terminal**](https://github.com/microsoft/terminal)
- [`windots/.dotfiles/terminal/settings.json`](.dotfiles/terminal/settings.json) → `%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\`
- **Restart Windows Terminal** to see the updated config.
### 🐚 PowerShell
- [`windots/.dotfiles/Powershell/Microsoft.PowerShell_profile.ps1`](.dotfiles/Powershell/Microsoft.PowerShell_profile.ps1) → `%USERPROFILE%\Documents\WindowsPowershell\`
- Restart PowerShell to apply the changes.
### 🎨 Oh My Posh
- **Install** [**Oh My Posh**](https://ohmyposh.dev/docs/installation/windows) using winget:
```bash
winget install JanDeDobbeleer.OhMyPosh -s winget
```
- [`windots/.dotfiles/ohmyposh/zen.toml`](.dotfiles/ohmyposh/zen.toml) → `%USERPROFILE%\.config\ohmyposh\`
### ⚙️ Fastfetch
- **Install** [**fastfetch**](https://github.com/fastfetch-cli/fastfetch) using **winget**:
```bash
winget install fastfetch
```
- [`windots/.dotfiles/fastfetch/config.jsonc`](.dotfiles/fastfetch/config.jsonc) → `%USERPROFILE%\.config\fastfetch\`
- [`windots/.dotfiles/fastfetch/windows.txt`](.dotfiles/fastfetch/windows.txt) → `%USERPROFILE%\.config\fastfetch\`
- **Run fastfetch**.
### ⌨️AutoHotKey
- [`windots/.dotfiles/AutoHotKey/`](.dotfiles/AutoHotkey/) → `%USERPROFILE%\Documents\AutoHotKey`
- **Open** the AutoHotkey Folder and **Launch** the **WindowsUtilities.ahk** script.. You will see it appear in the tray menu.
> To configure the script to start with the system on boot:
- Create a shortcut of the **WindowsUtilities.ahk** filescript.
- Open **Run** (Win+R) and type shell:startup then hit Enter. Copy the created shortcut to the just launched directory.
---
## ⌨️ GlazeWM Keybindings
Show Keybindings
| Keys | Action |
|---|---|
| alt + enter | Open terminal |
| alt + shift + enter | Open terminal as administrator |
| alt + h / j / k / l | Focus window left / top / bottom / right |
| alt + shift + ⬅️ / ⬆️ / ⬇️ / ➡️ | Move focusing window left / top / bottom / right |
| alt + q | Close focusing window |
| alt + 1-9 | Focus workspace {n} |
| alt + shift + 1-9 | Move focusing window to workspace {n} |
| alt + m | Toggle window minimization |
| alt + f | Toggle window maximization |
| alt + v | Change tiling direction |
| alt + t | Make focusing window float/tiled |
| alt + shift + e | Exit glazewm |
---
## 🖼️ Gallery
> You can check out the **wallpapers** [**here**](https://github.com/swopnil7/windots/tree/main/wallies#readme) 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** |
|:--:|:--:|
|  |  |
---
## 📢 Discussions
Have questions, suggestions, or want to showcase your setup? Or maybe you need some help?
Visit the [Discussions](https://github.com/swopnil7/windots/discussions) section.
> **⚠️ Please open an [issue](https://github.com/swopnil7/windots/issues) _only_ for reproducible bugs or critical problems.**
> For all other questions, feedback, or general help, [Discussions](https://github.com/swopnil7/windots/discussions) is **preferred**.
---
## 🎉 Credits
Special mention to the following resources and projects that were especially helpful during setup:
- [**pivoshenko**](https://github.com/pivoshenko/catppuccin-startpage) for the clean and aesthetic **browser startpage** 🌐
- [**GlazeWM**](https://github.com/glzr-io/glazewm) for delivering an outstanding **tiling window manager** that boosts productivity ✨
- [**YASB**](https://github.com/amnweb/yasb) for a **customizable and feature-rich status bar** that fits seamlessly into the setup 🚀
- [**Catppuccin**](https://catppuccin.com) for creating the **best color scheme** ever 🖌️
- [**Ashish**](https://github.com/ashish0kumar) for some of the **file configs** & **readme design** 🤍