winbearable (wb)
Foreword: Why Does This Exist?
Let's be honest: nobody here wants to run Windows.
Maybe your company's IT department forced you onto a corporate Windows laptop and told you to "just use WSL." Or maybe you bought an otherwise glorious ex-work ThinkPad or Dell Precision on the secondhand market, only to discover that the previous IT department forgot to give you the BIOS/UEFI supervisor password—and left "Enable Microsoft 3rd Party UEFI CA" turned OFF. So Secure Boot flatly refuses to boot a Fedora or Ubuntu USB stick, the NVMe boot order is padlocked, and Windows 11 + WSL2 is the only Linux kernel you are ever going to get on that silicon.
Whatever cruel twist of fate landed you here, this tool is for you.
We don't like Windows either. That's why
winbearable(wb) is shamelessly opinionated:
- Latest Windows 11 Only (24H2 / 25H2+, Build >= 26100): We don't support Windows 10 or ancient Windows 11 builds. Maintaining one version of Windows is painful enough.
- 100% Native Python, Zero PowerShell Wrappers: We use Python's standard library (
winreg,ctypes,tomllib) and direct Win32 binaries (wsl.exe,winget.exe,sc.exe,taskkill.exe) withshell=False. It works even when corporate AppLocker/WDAC locks PowerShell into Constrained Language Mode.- Kills the Annoying OneDrive Tray Icon: Terminates
OneDrive.exe, deletes theHKCU\...\Run\OneDriveautorun key so it stops haunting your system tray, unpins OneDrive from File Explorer, blocks it via machine policy when admin, and can uninstall it outright.- Installs VS Code + Remote-WSL on the Windows Side: Automatically installs
Microsoft.VisualStudioCode(in user scope, no admin needed) plus thems-vscode-remote.remote-wslextension so typingcode .in your WSLbashshell just works.- Gives WSL2 75% of Your Host RAM: Sizes
%USERPROFILE%\.wslconfigto 75% of physical host RAM (rounded up to whole GiB) withnetworkingMode=mirrored,dnsTunneling=true,firewall=true, andsparseVhd=true.
🚀 Zero-to-Bash Bootstrap (Fresh Windows 11 -> Linux Shell Fast)
If you are a Linux person staring at a fresh Windows 11 desktop, do not open Edge, do not open the Microsoft Store, and do not click through GUI installers.
Press Win + R, type cmd, hit Enter, and paste these commands to get uv, Python, VS Code, winbearable, and your Linux bash shell running in under two minutes:
Step 1: Install uv (and Python) via winget (No Admin Required)
winget is built into Windows 11. Installing uv with --scope user requires zero Administrator privileges, and uv automatically downloads and manages a standalone Python interpreter when needed:
winget install --exact --id Astral-sh.uv --scope user --accept-source-agreements --accept-package-agreements
(Optional: if you also want a standalone user-scoped Python on PATH, run winget install --exact --id Python.Python.3.13 --scope user --accept-source-agreements --accept-package-agreements)
Refresh your PATH (or open a new cmd / Windows Terminal tab), then install winbearable:
uv tool update-shell
uv tool install winbearable
Step 2: Install VS Code, Kill OneDrive Tray, Kill Bing Search & Fix Explorer (wb)
Preview every exact registry key, value, and winget package wb will touch (dry-run by default), then apply:
wb plan --profile user-only
wb apply --profile user-only --apply
If you have Administrator rights on the machine (personal PC or unlocked local admin on an ex-work PC), open cmd as Administrator (Ctrl + Shift + Enter) and apply the owner profile instead:
wb plan --profile owner
wb apply --profile owner --apply
Step 3: Give WSL2 75% of Host RAM & Drop Into Your bash Shell
Configure %USERPROFILE%\.wslconfig (sets WSL2 memory to 75% of physical host RAM rounded up to whole GiB, networkingMode=mirrored, dnsTunneling=true, firewall=true, sparseVhd=true) and /etc/wsl.conf:
wb wsl plan --mode convenient
wb wsl apply --mode convenient --apply
Now install your Linux distribution and enter bash:
REM Install Ubuntu 24.04 LTS or Fedora Linux 42
wsl.exe --install -d Ubuntu-24.04
REM Or: wsl.exe --install -d FedoraLinux-42
REM Apply hardened /etc/wsl.conf inside the distro and restart WSL
wb wsl apply --mode convenient --distro Ubuntu-24.04 --apply
wsl.exe --shutdown
wsl.exe
Once inside your WSL bash shell, type code . to open your Linux project in the Windows-side VS Code GUI via ms-vscode-remote.remote-wsl.
Locked-Down PC Fallback (When
wingetor Microsoft Store is Blocked):
- Download the standalone
uv-x86_64-pc-windows-msvc.zipbinary release from GitHub (github.com/astral-sh/uv/releases) into%USERPROFILE%\.local\bin.- Run
uv tool install winbearable(uvfetches Python into%APPDATA%\uv\pythonwith zero admin rights).- If the Windows Store is blocked by GPO/MDM, install WSL via
wsl.exe --install --web-download -d Ubuntu-24.04.
📋 Complete Registry & Package Changes Reference
Every wb plan, wb apply, wb status, and wb rollback command prints the exact registry hive, key path, value name, value type, and current -> target value transition. Below is the complete reference of what each tweak modifies:
1. Opinionated Developer Apps (apps.*)
| Tweak ID | Admin? | Mechanism / Package ID | Scope | Extensions / Details |
|---|---|---|---|---|
apps.install_vscode |
No | winget.exe install --id Microsoft.VisualStudioCode --exact |
user |
Also installs ms-vscode-remote.remote-wsl via code.cmd --install-extension |
2. OneDrive Eradication (onedrive.*)
| Tweak ID | Admin? | Registry Hive & Key Path | Value Name | Type | Target Value / Action |
|---|---|---|---|---|---|
onedrive.disable_tray_autorun |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Run |
OneDrive |
REG_SZ |
DELETE (+ stops OneDrive.exe) |
onedrive.unpin_explorer |
No | HKCU\Software\Classes\CLSID\{018D5C66-4533-4307-9B53-224DE2ED1FE6} |
System.IsPinnedToNameSpaceTree |
REG_DWORD |
0 |
onedrive.unpin_explorer |
No | HKCU\Software\Classes\Wow6432Node\CLSID\{018D5C66-4533-4307-9B53-224DE2ED1FE6} |
System.IsPinnedToNameSpaceTree |
REG_DWORD |
0 |
onedrive.disable_policy |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\OneDrive |
DisableFileSyncNGSC |
REG_DWORD |
1 |
onedrive.uninstall |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\OneDrive |
DisableFileSyncNGSC |
REG_DWORD |
1 (+ runs OneDriveSetup.exe /uninstall) |
3. Search, Start Menu, Taskbar & File Explorer (search.*, start.*, taskbar.*, explorer.*)
| Tweak ID | Admin? | Registry Hive & Key Path | Value Name | Type | Target Value |
|---|---|---|---|---|---|
search.disable_bing |
No | HKCU\Software\Policies\Microsoft\Windows\Explorer |
DisableSearchBoxSuggestions |
REG_DWORD |
1 |
search.disable_bing |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Search |
BingSearchEnabled |
REG_DWORD |
0 |
search.disable_highlights |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\SearchSettings |
IsDynamicSearchBoxEnabled |
REG_DWORD |
0 |
search.hide_taskbar_box |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Search |
SearchboxTaskbarMode |
REG_DWORD |
0 |
search.disable_cloud_and_history |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\SearchSettings |
IsMSACloudSearchEnabled |
REG_DWORD |
0 |
search.disable_cloud_and_history |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\SearchSettings |
IsAADCloudSearchEnabled |
REG_DWORD |
0 |
search.disable_cloud_and_history |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\SearchSettings |
IsDeviceSearchHistoryEnabled |
REG_DWORD |
0 |
search.disable_wsearch_service |
Yes | HKLM\SYSTEM\CurrentControlSet\Services\WSearch |
Start |
REG_DWORD |
4 (Disabled) |
start.disable_recommendations |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager |
SystemPaneSuggestionsEnabled |
REG_DWORD |
0 |
start.disable_recommendations |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager |
SubscribedContent-338388Enabled |
REG_DWORD |
0 |
start.disable_recommendations |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager |
SubscribedContent-338389Enabled |
REG_DWORD |
0 |
start.disable_recommendations |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager |
SoftLandingEnabled |
REG_DWORD |
0 |
start.disable_recommendations |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced |
Start_IrisRecommendations |
REG_DWORD |
0 |
taskbar.disable_widgets_and_chat |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced |
TaskbarDa |
REG_DWORD |
0 |
taskbar.disable_widgets_and_chat |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced |
TaskbarMn |
REG_DWORD |
0 |
taskbar.disable_widgets_and_chat |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced |
ShowTaskViewButton |
REG_DWORD |
0 |
explorer.classic_context_menu |
No | HKCU\Software\Classes\CLSID\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\InprocServer32 |
(Default) |
REG_SZ |
"" |
explorer.show_file_extensions |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced |
HideFileExt |
REG_DWORD |
0 (Always show file extensions) |
explorer.show_hidden_files |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced |
Hidden |
REG_DWORD |
1 (Show hidden files & dotfiles) |
4. AI, Privacy & Native CIS Hardening (ai.*, privacy.*, hardening.*)
| Tweak ID | Admin? | Registry Hive & Key Path | Value Name | Type | Target Value |
|---|---|---|---|---|---|
ai.disable_copilot_user |
No | HKCU\Software\Policies\Microsoft\Windows\WindowsCopilot |
TurnOffWindowsCopilot |
REG_DWORD |
1 |
ai.disable_copilot_user |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced |
ShowCopilotButton |
REG_DWORD |
0 |
ai.disable_copilot_machine |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsCopilot |
TurnOffWindowsCopilot |
REG_DWORD |
1 |
ai.disable_recall |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsAI |
DisableAIDataAnalysis |
REG_DWORD |
1 |
ai.disable_recall |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsAI |
TurnOffSavingSnapshots |
REG_DWORD |
1 |
privacy.disable_advertising_id |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\AdvertisingInfo |
Enabled |
REG_DWORD |
0 |
privacy.disable_tailored_experiences |
No | HKCU\Software\Microsoft\Windows\CurrentVersion\Privacy |
TailoredExperiencesWithDiagnosticDataEnabled |
REG_DWORD |
0 |
privacy.telemetry_minimal |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\DataCollection |
AllowTelemetry |
REG_DWORD |
0 |
privacy.telemetry_minimal |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\System |
PublishUserActivities |
REG_DWORD |
0 |
privacy.telemetry_minimal |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\System |
UploadUserActivities |
REG_DWORD |
0 |
hardening.disable_wsh_user |
No | HKCU\Software\Microsoft\Windows Script Host\Settings |
Enabled |
REG_DWORD |
0 |
hardening.disable_llmnr |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows NT\DNSClient |
EnableMulticast |
REG_DWORD |
0 |
hardening.disable_wpad |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\CurrentVersion\Internet Settings\Wpad |
WpadOverride |
REG_DWORD |
1 |
hardening.disable_autorun |
Yes | HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Explorer |
NoDriveTypeAutoRun |
REG_DWORD |
255 |
hardening.powershell_scriptblock_logging |
Yes | HKLM\SOFTWARE\Policies\Microsoft\Windows\PowerShell\ScriptBlockLogging |
EnableScriptBlockLogging |
REG_DWORD |
1 |
hardening.cmdline_process_audit |
Yes | HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\Audit |
ProcessCreationIncludeCmdLine_Enabled |
REG_DWORD |
1 |
hardening.enable_lsa_protection |
Yes | HKLM\SYSTEM\CurrentControlSet\Control\Lsa |
RunAsPPL |
REG_DWORD |
1 |
hardening.enable_vbs_hvci |
Yes | HKLM\SYSTEM\CurrentControlSet\Control\DeviceGuard |
EnableVirtualizationBasedSecurity |
REG_DWORD |
1 |
hardening.enable_vbs_hvci |
Yes | HKLM\SYSTEM\CurrentControlSet\Control\DeviceGuard\Scenarios\HypervisorEnforcedCodeIntegrity |
Enabled |
REG_DWORD |
1 |
Built-in TOML Profiles
| Profile | Requires Admin? | What It Configures |
|---|---|---|
profiles/user-only.toml |
No (HKCU / user scope) |
Installs Windows-side VS Code + ms-vscode-remote.remote-wsl, kills OneDrive tray autorun & Explorer pin, disables Bing web search, Search Highlights, taskbar search box, Start menu ads/recommendations, Widgets/Chat/Task View, restores classic Windows 11 right-click menu, shows file extensions/dotfiles, disables user Copilot, Advertising ID, and WSH. |
profiles/owner.toml |
Yes (extends = "user-only") |
Adds machine-wide OneDrive sync block (DisableFileSyncNGSC=1), disables Windows Recall & Copilot machine-wide, sets minimal telemetry, disables LLMNR, WPAD, AutoRun, and enables PowerShell ScriptBlock & 4688 command-line auditing. |
profiles/paranoid.toml |
Yes (extends = "owner") |
Uninstalls the OneDrive client, disables the WSearch indexer service, enables LSA RunAsPPL protection, enforces VBS/HVCI (--i-know-what-im-doing), and switches WSL2 to strict isolation ([interop] enabled=false, [automount] enabled=false). |
Windows Build Support Policy
We don't like Windows enough to maintain legacy workarounds for EOL operating systems. Only the latest Windows 11 releases (24H2 / 25H2+, build >= 26100) are supported.
| Build Number | OS Release | Support Status |
|---|---|---|
26200+ |
Windows 11 25H2 | Supported |
26100 |
Windows 11 24H2 | Supported |
< 26100 |
Older Windows 11 / Windows 10 | Unsupported (unsupported_build) |
Development & Test Coverage Gate (uv)
make venv # Create .venv and install dev dependencies via uv
make lint # ruff check + ruff format --check
make test # mypy --strict + pytest-cov (enforces >=80% coverage) + badge generation
make release-check # lint + test + TruffleHog + Trivy
Documentation
- Project Roadmap & TODO
- Linux Person's Windows Cheat Sheet
- AI Agent Instructions (
AGENTS.md) - Security Policy (
SECURITY.md) - Contributing Guide (
CONTRIBUTING.md)
📄 License
This project is licensed under the MIT License.
Metadata
Release files for winbearable 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| winbearable-0.1.0.tar.gz | 102.1 kB | Without provenance | Details for winbearable-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| winbearable-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for winbearable-0.1.0-py3-none-any.whl |
Total release size: 146.5 kB
Release files / winbearable-0.1.0.tar.gz
| Download URL | winbearable-0.1.0.tar.gz |
|---|---|
| Size | 102.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
353f717ceeea8b390ca7e991ad69f4150ae3a50bd8bd0cf10ff088e52b44c44f
|
|
BLAKE2b-256 checksum How to use checksums |
8c67f649fc06cca571c5f3c9ecb87be5ccd4adfb74b3136d89e388021996e443
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1
|
Release files / winbearable-0.1.0-py3-none-any.whl
| Download URL | winbearable-0.1.0-py3-none-any.whl |
|---|---|
| Size | 44.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a4b7bcd3cdf48c9291509a81e7a49c0b8d44fc58b2fa928361cf72e3d59c87f7
|
|
BLAKE2b-256 checksum How to use checksums |
dfaa2dab4a67b897b848a0ce45f437ab425181336b96f589742998ce5255f6f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1
|
Security for winbearable 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.