This repository contains my configuration files (dotfiles) for Windows, managed using Dotbot.
- Komorebi (Tiling Window Manager)
- whkd (HotKey Daemon)
- yasb (Status Bar)
- Windows Terminal
Before installing, ensure you have the following installed:
- Git
- Python (Required to run Dotbot)
- PowerShell (Must be run with Administrator privileges to create symbolic links)
Note: This setup only links configuration files. You must install the actual applications (komorebi, yasb, etc.) separately using
wingetorscoop.
Since this repository uses Dotbot as a git submodule, you must clone it with the --recursive flag.
# Clone to your desired location
git clone --recursive [https://github.com/](https://github.com/)<YOUR_USERNAME>/windows-dotfiles.git
# Enter the directory
cd windows-dotfilesIf you have already cloned the repo without the submodule:
git submodule update --init --recursiveOpen PowerShell as Administrator and run the installation script. This will create the necessary symbolic links.
# Run the install script
.\install.ps1If successful, your config files will be linked to ~/.config/ and AppData directories.
To update your dotfiles and apply changes:
# 1. Pull the latest changes
git pull
# 2. Update the Dotbot submodule (optional, but recommended)
git submodule update --remote
# 3. Re-run the installer to apply new links
.\install.ps1If you receive a permission error when running the script, change the execution policy temporarily:
Set-ExecutionPolicy RemoteSigned -Scope ProcessIf you see "Linking failed" or permission errors:
- Ensure you are running PowerShell as Administrator.
- Windows requires admin rights to create symlinks by default.
[komorebi + whkd]
- Open PowerShell or Command Prompt.
- Run the following command: komorebic enable-autostart --whkd
- (To disable it later, run: komorebic disable-autostart)
[yasb]
- Open PowerShell or Command Prompt.
- Run the following command: yasbc enable-autostart
- (To disable it later, run: yasbc disable-autostart)
- komorebi + whkd
- yasb
- winfetch
- bottom