Windows 11, the Linux way
A comprehensive PowerShell-based dotfiles system that turns a fresh Windows 11 install into a highly automated, fully personalized power-user environment - in a single command.
|
|
| An example workspace layout opened across one ultrawide monitor | An example workspace layout opened across two stacked ultrawide monitors |
Today WinuX is a terminal/keyboard-driven system built for power users. The goal is to make it accessible to everyone - a guided installer and a GUI are on the roadmap - without ever taking away the deep configurability that defines it.
From one bootstrap command or a simple executable, all driven by a single configuration file, across as many machines as you own:
- One-command bootstrap - fresh Windows to your fully configured environment in a single line.
- Multi-machine - manage every machine from one configuration; machines can share an identical setup or each define their own.
- Package management - install software via WinGet, Scoop, and/or Chocolatey.
- Dotfiles management - symlink every config so the system behaves exactly as you want.
- Repository orchestration - clone and update all your repositories with one command.
- Workflow automation - open and position entire workspaces across monitors and virtual desktops.
- System theming - one-command, multi-monitor theme and wallpaper setup.
- Machine-type profiles - hostname-detected machine types give each machine the right subset of apps, layouts, and settings.
- WSL provisioning - optional, config-gated WSL/Ubuntu setup with a themed shell.
- Idempotent by design - every step is safe to re-run, so the bootstrap doubles as repair.
- Empty by default - WinuX imposes nothing. A vanilla install changes no theme, wallpaper, locale, keyboard layout, or taskbar; every feature above is opted into in your own
Configuration.local.psd1. - Tested and documented - the full Pester suite runs in CI, and every function has a man-style reference in the docs.
The documentation is the single source of truth for WinuX - installation, configuration, every module, and a man-style reference for every PowerShell function (each linked to its source).
Read it live at ivanpavlak.github.io/WinuX - or browse it
in this repository under docs/, or serve the site locally:
# From the repository root
npx docsify-cli serve docsWinuX is released under the MIT License.
This repository builds on the following, each under its own license (see THIRD-PARTY-LICENSES.md):
| Component | Author | License |
|---|---|---|
Win11Debloat (Windows/Win11Debloat/) |
Raphire | MIT |
JetBrains Mono / Nerd Fonts (JetBrainsMonoNerdFont/) |
JetBrains / Ryan L. McIntyre | SIL OFL 1.1 |
| Oh My Posh (configured, not vendored) | Jan De Dobbeleer | MIT |
Contributions of all kinds are welcome - code, docs, tests, bug reports, and ideas. Please read CONTRIBUTING.md and the Code of Conduct first. For security issues, follow SECURITY.md.
WinuX is free and open-source. If it saves you time, please consider supporting it.
AI was used throughout this project and is ingrained in it - but everything has been manually tested many times, over a long period, on multiple machines (VMware VMs, a personal PC, and personal and work laptops). Regardless, use it at your own discretion.
Known problems and their workarounds live in Known Issues.