<div align="center">

Windows Dotfiles

System | Komorebi | Terminal | Neovim | Opencode | Firefox | Extras

https://github.com/user-attachments/assets/9cc1e7b9-8ae9-40cd-bf11-87ae4bc6b123

</div>

System

[!NOTE] Every folder in this repository is located locally at $Env:USERPROFILE\.config.

Dependencies

• 7Zip → Run winget install --id 7zip.7zip.
• PowerToys → Run winget install Microsoft.PowerToys --source winget.

Setup

1. Ensure you are able to access and use the Windows Store, winget relies on this for certain things. If you can't access the store (it's known to be glitchy for some accounts) then you can find alternative installs for all dependencies on either Chocolatey or the dependency's official website.
2. Go to the "System" and then "Advanced" section of the Windows settings and do the following:
   • Ensure "Developer Mode" is turned on.
   • Ensure "Enable long paths" is turned on.
   • Enable "Show hidden and system files" and "Show file extensions" under "File Explorer".
   • Enable local powershell scripts to run without signing under "PowerShell".
   • Enable Sudo.
3. Add the following environment variables:
   • XDG_CONFIG_HOME -> $Env:USERPROFILE\.config
   • XDG_DATA_HOME -> $Env:USERPROFILE\.config
   • XDG_STATE_HOME -> $Env:USERPROFILE\.config
   • XDG_CACHE_HOME -> $Env:USERPROFILE\.config\temp
4. My PowerToys setup is as follows:
   • Run with an activation shortcut of win+shift+backspace, input smoothing disabled, clear previous query on launch enabled, preferred monitor primary, all plugins off except "Program" and "Windows System Commands" - this behaves just like the windows run dialog but without cortana, searching the internet or any other annoyances and the ability to type shutdown, restart, etc.
   • Color Picker with an activation shortcut of win+shift+c and HEX, RGB and VEC4 enabled.
   • Mouse Jump with an activation shortcut of win+shift+d and a max size of 1600x1200.
   • Screen Ruler with an activation shortcut of win+shift+p and default measure style of Spacing.
   • Text Extractor with an activation shortcut of win+shift+t.
   • File Locksmith enabled.
5. You can right click your desktop and go to "View" and then "Hide desktop icons" to have a clean desktop.

Komorebi

Dependencies

• Komorebi → Run winget install LGUG2Z.komorebi and add the environment variable KOMOREBI_CONFIG_HOME -> $Env:USERPROFILE\.config\komorebi.
• Yasb → Run winget install --id AmN.yasb.
• AutoHotkey → Run winget install AutoHotkey.AutoHotkey.
• ToggleRoundedCorners → Download the portable executable from here and rename it to trc.exe. Place it in C:\Program Files\ToggleRoundedCorners and put that folder in your path.

Setup

1. Run Set-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name 'LongPathsEnabled' -Value 1 in PowerShellCore as an admin.
2. Open control panel and go to the "Ease of Access Center" then "Make the computer easier to see" - enable "Turn off all unnecessary animations (when possible)".
3. Press Windows + I and search taskbar, go to taskbar settings and turn on "Automatically hide the taskbar" under the taskbar behaviours.
4. Search multitasking and turn off "Snap windows".
5. Paste komorebi into your config. In komorebi.json ensure that the correct amount of monitors are configured.
6. Paste yasb into your config. Add the directory containing yasbc.exe to your path (C:\Program Files\YASB by default).
7. Paste ahk into your config. Right click wm.ahk and create a shortcut, then rename that shortcut to just wm and create a copy of it, one should be moved to C:\ProgramData\Microsoft\Windows\Start Menu\Programs and the other to that folder's sub-directory Start-up (or Startup). Now it will be run at startup and is accessible from the start menu in case you need to restart the manager, and all three processes can be killed from the task manager.
8. Restart your PC.

[!TIP] Keybinds and commands to run on startup can be configured in wm.ahk, the status bar can be configured in the Yasb config.yaml and styles.css files, and the window manager can be configured by Komorebi's komorebi.json, applications.json and any .json files for custom layouts.

Terminal

Dependencies

• NerdFont → Download from here (I use CaskaydiaCove), then in explorer select all .ttf files and right click them, now select "Install". After that you can delete the files.
• Windows Terminal → Run winget install --id Microsoft.WindowsTerminal.
• PowerShellCore → Run winget install --id Microsoft.Powershell --source winget.
• Git → Run winget install --id Git.Git --source winget.
• Github CLI → Run winget install --id GitHub.cli.
• fd → Run winget install --id sharkdp.fd --source winget.
• bat → Run winget install sharkdp.bat and add the environment variable BAT_THEME -> Visual Studio Dark+. You can choose any of the themes from bat --list-themes.
• fzf → Run winget install junegunn.fzf.

Setup

1. Paste terminal into your config and change the font settings account for whatever NerdFont you installed. Also, make sure you add whatever profiles you want to use other than the three that i have set up. Each new profile needs a unique guid - you can generate one by running [guid]::NewGuid() in PowerShellCore.
2. Find the location of the windows terminal settings file (it's different per machine) - open that directory and delete settings.json - then run this command in PowerShellCore: New-Item -ItemType SymbolicLink -Path ".\settings.json" -Target "$env:USERPROFILE\.config\terminal\settings.json".
3. Paste pwsh into your config, then run notepad $PROFILE and paste this line into the file that is opened (you may have to create the file first if it doesn't exist): . $Env:USERPROFILE"\.config\pwsh\main.ps1".
4. Go back to pwsh\main.ps1 and remove the line that sources personal.ps1, and delete that file too as it is specific to me. Other than that, skim the rest of the files and remove anything you know you won't need - everything is commented or self-explanatory so you can be sure of what you're doing.
5. Run git config --system core.longpaths true and ensure that [PATH_TO_GIT]\bin is in your path. After that you can run git config --global user.name "[YOUR_NAME]" and git config --global user.email "[YOUR_EMAIL]", followed by git config --global core.autocrlf true and git config --global core.editor nvim if you want.
6. Run gh auth login and follow the instructions to authenticate your local machine with your GitHub account. After that you can run gh config set editor nvim if you want.

Neovim

[!IMPORTANT] This section requires completion of the terminal setup first.

Dependencies

• Microsoft Visual C++ 2015-2022 Redistributable (x64) → Download from here and run the installation wizard.
• MinGW → Download from here and put the contents in C:\Program Files\MinGW (I recommend 64-bit with POSIX threads for general purpose use). Add C:\Program Files\MinGW\bin to your path.
• Make → Run winget install --id ezwinports.make.
• CMake → Run winget install --id Kitware.CMake.
• Python → Run winget install --id Python.Python.3.10.
• NodeJS → Run winget install OpenJS.NodeJS.
• ripgrep → Run winget install BurntSushi.ripgrep.MSVC.
• Neovim → Run winget install neovim --version 0.12.0 and add the environment variables NVIM_LOG_FILE -> $Env:USERPROFILE\.config\nvim-data\nvim.log and EDITOR -> nvim.
• Python Provider → Run pip install pynvim --upgrade.
• NodeJS Provider → Run npm install -g neovim.
• TreeSitterCLI → Run npm install -g tree-sitter-cli.

Setup

After completing the dependencies for this section, I recommend manually recreating nvim on your machine rather than just pasting it in, because this will allow you to single out any unexpected errors as they happen.

You should start with the top level init.lua and then lua\main\init.lua. Then you can create lua\main\util.lua, lua\main\set.lua and lua\main\map.lua and paste the config into each. set.lua is for global settings, map.lua is for global keybinds and util.lua is for helper functions used throughout the configuration, designed to remove the need for visible logic in any configuration files.

Now you can create lua\main\pack.lua, and populate it with only the following lines:

vim.keymap.set("n", "<leader>pu", function() vim.pack.update() end, { desc = "Update plugins" })

After creating an empty lua\plugin\init.lua, restart neovim and there should be no error messages.

Now, call the vim.pack.add({}) function and start adding plugins, do so in the following pattern (with some exceptions below):

1. Add the line to lua\main\pack.lua and restart neovim.
2. If it needs one, add a lua\plugin\[PLUGIN].lua file for the plugin and add require("plugin.[PLUGIN]") to lua\plugin\init.lua (order matters in this file), then restart neovim.
3. Customize the file to your liking.
4. Test the plugin.

The following plugins require some extra or different steps:

• Helpers → Some plugins are only here to help other plugins and files which you can remove if you don't need, these are: