Skip to main content

winbearable logo

winbearable (wb)

uv Ruff Coverage Python Version Windows 11

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) with shell=False. It works even when corporate AppLocker/WDAC locks PowerShell into Constrained Language Mode.
  • Kills the Annoying OneDrive Tray Icon: Terminates OneDrive.exe, deletes the HKCU\...\Run\OneDrive autorun 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 the ms-vscode-remote.remote-wsl extension so typing code . in your WSL bash shell just works.
  • Gives WSL2 75% of Your Host RAM: Sizes %USERPROFILE%\.wslconfig to 75% of physical host RAM (rounded up to whole GiB) with networkingMode=mirrored, dnsTunneling=true, firewall=true, and sparseVhd=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 winget or Microsoft Store is Blocked):

  1. Download the standalone uv-x86_64-pc-windows-msvc.zip binary release from GitHub (github.com/astral-sh/uv/releases) into %USERPROFILE%\.local\bin.
  2. Run uv tool install winbearable (uv fetches Python into %APPDATA%\uv\python with zero admin rights).
  3. 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


📄 License

This project is licensed under the MIT License.

Buy Me a Coffee

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)

Source distribution for winbearable 0.1.0
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)

Table of built distributions (wheels) for winbearable 0.1.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page