Windows shell replacement in Rust: taskbar, file manager, NTFS search, task manager, disk cleaner. One installer exe.
WinRust: Roadmap
(Русская версия: ROADMAP.ru.md)
Each item says how far it was checked: tests (unit tests), built (compiles, never run), ran (run by hand on a live system), e2e (full install/uninstall on a live system).
Done
Installer
- One
plugin-launcher.exewith every plugin embedded (unpacked into Program Files, not %TEMP%), static CRT, dark Win32/GDI window. ran - "Install WinRust" installs what is missing in order (topbar before rust-explorer), updates when everything is there; "Remove all" removes in reverse order. built
- A failed install undoes its own changes (not when updating a working copy); original values (WSearch, search box, Explorer settings, services) are saved under
HKLM\SOFTWARE\plugin-launcher\<plugin>and put back on uninstall; non-fatal errors go to%ProgramData%\plugin-launcher\install.log. built - Restore point before install. built
- Choose what to install (#7): a checkbox per component in the window, several names or
allon the command line; a component that fails or is skipped does not stop the rest, the failures are listed at the end. A missing Windows Search service (stripped LTSC builds) is a warning, not an error, for both install and uninstall of rust-search. built - The signed-in user, not the elevated account (#4): if UAC was answered with another administrator, per-user settings (HKCU, scheduled tasks, the PowerShell profile, the rust-search pipe permission, the rs-launcher Run key, debloat's HKCU policies) go to the owner of explorer.exe (or topbar / rust-explorer / rs-shell) in the session, through
HKU\<SID>. If that user cannot be determined, install stops before writing anything. Uninstall carries on with a warning. tests (key rewriting), built - One button installs what is missing and updates what is installed, so running a newer
WinRust.exebrings its fixes to every plugin (v0.2.1). built - Command line:
list | install <plugin>...|all --yes | update <plugin> | uninstall <plugin> | rollback --yes, exit codes 0/1/2; the window and the command line call the same functions. Only the read-only commands were run. ran (partly) updateandscripts\update-plugin.ps1: reinstall frompayload\on disk without rebuilding the installer. ran- English by default, Русский/English switch in the installer and in the bar menu; the choice is stored in
%ProgramData%\WinRust\lang.txt. tests - Review fixes (v0.3.0): rs-du keeps its quarantine list next to its exe (admin-only),
payload\two levels up only fromtarget\release, rtaskmgr and rust-explorer save and restore another program's Task Manager / folder settings, rust-search brings Windows Search back before removing its files, DiagTrack is left to debloat, onereg queryparser with a test. tests, built - Settings without Explorer (Win+I and the bar's menus): Settings is a Store app that opens only while Explorer is the shell, so a hidden helper starts Explorer, waits for its taskbar, opens the page, brings the window to the front (also over a fullscreen game), and puts rust-explorer back when Settings is closed; a hung Settings process is killed first. The bar hides only for fullscreen games and video. built, ran by hand
- Code layout: one cargo workspace; the installer split into
install/(one file per plugin),cli.rs,ui.rs; sharedwinrust-commoncrate (language switch, MFT reader); onepayload.txtlist for the build and the scripts; CI on GitHub Actions. tests
Plugins
rust-search: NTFS search service + Alt+Space; disables WSearch, blocks SearchHost.exe, hides the taskbar search box. Right-click a result: rename, recycle bin, "delete permanently + clean the registry" (scan → confirm → delete; registry saved to
%LOCALAPPDATA%\rs-search\registry-backups\*.regfirst). tests, ranrtaskmgr-win32: replaces Task Manager through an IFEO Debugger (
taskmgr.exeuntouched); on a panic writes%APPDATA%\rtaskmgr\crash.logand opens the real Taskmgr. tests, rantopbar: Windows 11-style bottom bar instead of the taskbar;
topbar.exe --restorebrings the taskbar back. Installs with it: reshell hotkeys, rs-du, the PowerShell profile block (src/install/profile.ps1, Windows PowerShell 5.1 and pwsh 7). ran; the profile block only on a temporary profilereshell safety net: if topbar is not running while the taskbar is hidden, twice in a row (~10 s), it runs
topbar.exe --restore. tests; killing topbar was not triedreshell hotkeys: Win+D (show desktop) and Win+I (Settings) work without Explorer, like Win+E (v0.2.1). ran
Styles (v0.3.0): a gear at the left end of the bar switches Normal / Terminal / Floating dock / Tiling; the bar, rust-explorer and the search window repaint at once (a broadcast message,
%ProgramData%\WinRust\style.txt). The dock reserves no screen space and slides away from maximized windows; Tiling puts the bar at the top and can tile the windows. rantopbar look (v0.3.0): the network icon is drawn (Wi-Fi arcs by signal, a cross when offline, "!" when there is no internet, per Windows' connectivity hint); new Wi-Fi panel (status, connected card with its own Disconnect button, saved/open networks, rows fade in); text-only menus with key hints; input language picker (left click on ENG/RUS); the tray flyout fades in and its chevron turns. ran
rust-explorer: file manager (tabs, icons, IFileOperation copy/paste/delete, shell context menu, drag and drop), draws the desktop, turns off Explorer as the shell with
rs-shell --overlay(90 s after sign-in at the latest: Windows 26300 no longer writes the autostart markers it used to wait for, v0.2.1), trims services. tests, ranrs-du: disk cleaner (MFT analysis, caches,
target/node_modules, recycle bin, 30-day quarantine), started from the bar menu. testswiztree: disk-usage treemap from the MFT. tests (layout only); not run on a live disk
photoview: WIC photo viewer, EXIF rotation, "Open with" entry. ran; EXIF orientations 5 and 7 not checked
debloat: services and policies (telemetry, Copilot, Recall, ads, Edge background), old values in
%ProgramData%\winrust-debloat\undo.txt,--undo. dry run ran;--apply/--undonot runpurge: removes the bundled Store apps (installed and provisioned) and the telemetry scheduled tasks like Tiny11 does; OneDrive and Edge only with
--onedrive/--edge. IRREVERSIBLE, a log in%ProgramData%\winrust-purge emoved.txt.purge.exelists,--askasks for YES (the bar's right-click menu),--applyremoves. Protected names (Store, Settings, Start, runtimes) are tested. tests, dry run ran;--applynot runWhite road style and new topbar panels: a fifth, light style (ivory, gold accent, low-poly triangles, some traced in gold, drawn with GDI+ behind the bar, its panels, rust-settings and Explorer's list in white); Quick settings and Wi-Fi panels redrawn: tiles with round icon badges and labels inside, sliders on one card with a shadowed knob, battery pill and round gear, an iOS-style switch, the connected network on its own card with a check mark (link speed and security on hover, Disconnect appears on hover), other networks on one card split by hairlines; a right click on a network opens a small menu (connect / disconnect, forget, known networks); while joining, the signal arcs sweep and a bar slides under the row until it connects or 25 s pass. rust-settings: values that used to step on each click (resolution, refresh rate, scale, orientation, display, screen mode, power plan, screen-off and sleep timeouts) open an animated drop-down list with the current value checked (arrows, Enter, Esc and the wheel work in it); a display without an EDID name reads "Built-in display" instead of
\\.\DISPLAY1.topbar --preview quick|wifishows a panel alone. built, tests; panels screenshotted in White road and Tiling, rust-settings and Explorer in White roadNew look (all programs): the shared palette is now neutral graphite with Apple's system blue (Normal), midnight ink with indigo (Floating dock), refined Terminal and Tiling; Apple's dark-mode green/yellow/red for status everywhere; Segoe UI Variable and Segoe Fluent Icons on Windows 11 (Segoe UI / MDL2 on Windows 10). rtaskmgr, the installer, wiztree and photoview moved from their own colours to the same graphite. rust-settings is redrawn like macOS System Settings: coloured page icons, grouped rounded cards with hairlines and section headers, iOS-style switches, smooth (GDI+) shapes, a centred content column, a floating bottom bar.
WINRUST_STYLE=<name>previews a style in one process. built, tests; rust-settings screenshots checked in all four styles, the other programs not looked at after the changerust-settings (first steps): a small Settings window that needs neither Explorer nor the Store Settings app. Pages: Display (resolution and refresh rate of the primary display: a change is temporary, Enter keeps it, Esc or 15 s goes back; tested with
CDS_TESTfirst), Sound (volume slider and mute of the default playback device, Core Audio), Power & storage (battery, power plan switch, free space on fixed drives), Network (Wi-Fi/Ethernet adapters and link speed; Wi-Fi: radio on/off, connect to saved, open and new networks with the password typed in the window (profile through the WLAN API, a failed attempt deletes it), hidden networks, disconnect/forget on right click, the result shown with Windows' reason text; scans about every 30 s, not on every refresh), Personalization (dark theme for apps/system, transparency, accent on title bars: four HKCU values), About (read-only), More (opens the system pages through the existing helper). Only documented Win32 calls, nothing run as a command. Installable like wiztree (a file in Program Files and a Start menu shortcut); once installed, Win+I and the bar menus open it for the exact addressesms-settings:(display),sound,personalization/colors/themes,powersleep/storagesense,network-status,about, all others still go to Windows' Settings. Installer wiring only built, never run; Ethernet: only real cards (Hyper-V, VPN and Wi-Fi Direct adapters hidden), each with address, link speed and an internet dot from the Network List Manager; a click shows IPv4/IPv6, gateway, DNS, DHCP or manual, MAC. Next: Bluetooth, per-device volume. Wi-Fi password entry not tried on a live network yet. Written from scratch (the code offered in PR #14 was not used). Long pages scroll with the wheel, clickable rows highlight under the pointer. tests (mode, slider, scroll and page-key logic), built, started; display change and volume not tried on a live systemNo more stubs in the settings (rust-settings, the bar's quick settings, the task manager): rust-settings now has pages for Bluetooth (radio, airplane mode, paired devices with their connection state, pairing a nearby device, removal on a second click), Apps (installed programs, uninstall with a second click) and Windows Update (check, download and install through the Windows Update Agent; installing needs administrator rights). Sound: choose the playback and recording device (the default-device switch is the one undocumented call, the COM class every switcher uses) and the volume of each app. Display: night light (a colour filter of our own, a gamma ramp kept by a background
rust-settings --nightlight, autostart through a HKCU Run value that uninstall removes; not Windows' schedule-driven one, which is an undocumented per-build blob) and the arrangement of several displays by dragging (snaps flush against a neighbour, Windows refuses gaps; a click picks the display). Network: VPN profiles (connect with the password Windows saved, disconnect), proxy (on/off, address, PAC script, applications told to re-read), Wi-Fi on every adapter and 802.1X (PEAP-MSCHAPv2: user name and password, the profile and per-user credentials through the WLAN API; EAP-TLS with certificates is not offered). Power & storage: disk cleanup (user temp files older than a day, recycle bin with Windows' own confirmation). The bar's quick-settings tiles Bluetooth, Airplane mode, Accessibility (Narrator, Magnifier, sticky and filter keys) and Energy saver show their state and act, with Russian labels; the Wi-Fi tile and panel use every adapter and send enterprise networks to rust-settings. Task manager: core affinity takes a 64-bit mask (winapi 0.3 declares it as 32-bit), so cores above the 32nd work (a process still lives in one processor group, up to 64 logical processors). tests (new logic: addresses, colour gains, cleaning, snapping, picture mapping, EAP documents, mask), release builds, every page started for 9 s; not tried on a live system: pairing, VPN dialling, Windows Update install, the 802.1X sign-in (no such network at hand), the arrangement drag (one display here), and the quick-settings tilesShortcuts closed: reshell's watchdog restores the taskbar and then restarts the bar (up to 3 tries in a row, a bar stable for a minute gives them back); topbar remembers the user's own taskbar mode (auto-hide / always on top) in
%APPDATA% opbar-taskbar-state.txtand gives it back on exit and--restore; the rust-explorer desktop sizes its icon area from the real work area (bar at the top or bottom, any height, dock style) and follows changes; rust-settings gets a Scale step and an HDR switch for the primary display (orientation was already there). Night light stays a link to Windows. built, tests; scale and HDR only read on a live system, not switched; the watchdog restart and the other changes not run on a live systemSeveral displays and icons: rust-settings picks the display its rows act on (resolution, rate, scale, orientation, HDR), switches extend / duplicate / one screen only (confirmed like a resolution, goes back after 15 s) and makes a display the main one. rust-explorer, rust-settings, topbar, wiztree, photoview and the installer got icons in one style (graphite tile, one coloured glyph, drawn 4x and shrunk: smooth at 16-256 px) from
scripts\make-icons.py; rtaskmgr keeps its own. built, tests; the display logic ran only on a one-display PC (reads), the icons were checked in the built exesv0.5.0, from the issue tracker: the gear menu has "Hide the bar automatically" (
%ProgramData%\WinRust\autohide.txt, off by default); Win+Shift+S is our own region clipper (a dimmed copy of the desktop, drag a rectangle, it goes to the clipboard andPictures\Screenshots); the volume keys and Surface's power + volume-up work without Explorer; a keyboard button sits in the Start search; brightness goes through the video driver (\\.\LCD); the Wi-Fi switch goes through Windows' radio manager (the WLAN API cannot undo airplane mode); rust-explorer shows desktop shortcut names and mapped network drives, and Space opens a picture in photoview. built, tests; brightness read and write ran on a laptop; the clipper, volume keys, Surface buttons, Wi-Fi and Bluetooth fixes not run on a live deviceSpeed (after v0.5.0): rtaskmgr's new Speed page: Game / Work profiles (services stopped and apps closed are written to
%ProgramData%\WinRust\profile.txtand started again, apps with the token of the session'ssihost.exeso they do not inherit admin rights), clearing the memory standby list now or automatically (topbar's thread,%ProgramData%\WinRust\autopurge.txt), IFEO blocks for StartMenuExperienceHost / Widgets / WidgetService / PhoneExperienceHost (only with topbar), and four new debloat groups with their own undo files:updaters(third-party updater services and tasks off, a weeklywinget upgrade --alltask; browsers are left alone),defender(exclusions for cargo/rustup/npm/pip/NuGet/Gradle caches and Steam/Epic libraries, after a confirmation),ntfs(no last-access times, no 8.3 names),dns(about 170 ad domains in hosts, no Microsoft ones). debloat.exe ships next to the task manager; uninstalling the task manager runs--undo-speedfirst. Startup lists logon/boot tasks and third-party auto-start services and the slowdown each caused (events 100/101/103 of Diagnostics-Performance); What's slow shows DPC/interrupt time, hung windows, slow disk, free vs standby memory and boot times. rust-explorer: own copier for copies and moves to another drive (parallel unless a disk has a seek penalty,COPY_FILE_NO_BUFFERINGfrom 256 MB, sources deleted only after every file arrived), Compress to ZIP (files up to 64 MB compressed on all cores) and Extract here for ZIP and 7z. Emptying working sets was left out on purpose: trimmed pages go to the standby list, which already counts as available, so it only adds page faults. tests (debloat parsing, hosts round trip, boot log parsing, task XML, profile file, copy/move, ZIP and 7z round trips); dry runs of the debloat groups ran; nothing applied on a live system yet, the boot log and the memory lists need admin and were not read herev0.5.1 fixes: right click on the Start button opens a Win+X-style menu (apps, power options, event viewer, system, device manager, network, disk and computer management, terminal, task manager, settings, file explorer, run, desktop, lock / sleep / restart / shut down) (#40); the shell context menu in rust-explorer now passes the click point (
CMIC_MASK_PTINVOKE), so "Open with > Choose another app" should open on screen (#38, not confirmed on the reporter's monitor). Win+E opens rust-explorer through reshell (#41). built, tests; the new menu and dialog were not looked at on a live screenv0.5.2: topbar can sit on the left or right edge (gear menu), the buttons can go to the left end like Windows 10 (
align-left.txt), and a maximized window no longer hides the floating dock (#51, #56, #58). rust-explorer: Ctrl+A, mouse back / forward buttons, Quick access follows moved known folders and you can pin folders, the desktop menu hides the icons (desktop-icons-hidden.txt), our own ZIP engine and a.zipopens like a folder, Rename in the file menu (#42, #50, #54, #62). "Show in folder" from browsers and other programs selects the file: rust-explorer registers as a shell window inIShellWindows, and the desktop process keeps stand-ins for Downloads, Documents, Desktop, Pictures, Music, Videos and pinned folders, because Windows waits 20 s for its own window when none exists (#60; other folders without an open window still wait). "Open file location" in the search, the task manager and WinRust Disk goes to rust-explorer (#61). The task manager shows one GPU once (#59). topbar search: Ctrl+A, Ctrl+Backspace (#52). Installer: rust-explorer is opt-in for new installs, a shell switch in the gear panel, service startup values come back on uninstall, rollback journals are kept when validation fails, logon tasks for reshell and rs-launcher instead of HKCU Run values (MSIX), PowerShell calls replaced by Win32. Foreign PRs #43, #45, #46, #17 squashed. built, tests; "Show in folder" checked on a live system with PowerShell, not with a browser; the side bar and "buttons on the left" were not looked at on a live screen
Next (in order)
- Scripted shell customization (#39, Windhawk-style): a way to load small user mods that change the bar, Start panel and file manager without rebuilding WinRust. Not started: needs a mod format (script or DLL), a sandbox, and a stable API of the shell parts first.
- Phones and safe removal in rust-explorer (#2): not started, too big for a quick fix. (a) MTP/PTP phones have no drive letter, so they need the Windows Portable Devices API (
IPortableDeviceManager,IPortableDeviceContent, enumerate objects, read and write throughIPortableDeviceResourcesstreams) behind a second "file system" in rust-explorer next to the path-based one; copy, paste, delete and drag and drop have to be redone on it. (b) Safe removal: a tray icon in topbar (it already hosts tray icons) that lists removable drives, andCM_Request_Device_Ejecton the device node of the chosen drive (flush first, report "in use" with the process that holds it). (b) is the smaller half and works for USB sticks and disks; (a) is what the issue is mostly about. Needs a real phone and a USB stick to test: nothing here can be checked by unit tests alone. - Taskbar-style reordering in topbar (#6, wish): dragging a file onto the bar already pins it. Missing: dragging the window buttons to change their order, and dragging a button off the bar to unpin. Needs the order stored (like
topbar-start.txt) and a drag state intopbar(mouse capture, an insertion marker, a repaint per move). - Test on a clean Windows 11 VM: install, uninstall, rollback, reboot, for each plugin. Nothing has been checked on another machine yet.
- One undo journal for every plugin: each change (registry value, service, file) written as "before → after" before it is made; uninstall and rollback replay it backwards. Replaces the hand-written uninstall of each plugin. Needs step 1 first, and a migration for installs made by the current version.
- Registry through the Win32 API (
RegGetValueW/RegSetValueExW) instead of runningreg.exeand parsing its output. - Releases: SHA-256 next to the exe, version in the window, update check.
- Code signing (removes the SmartScreen warning and part of the antivirus false positives).
- PowerShell profile: optionally install rg/fd/bat/eza/zoxide through winget (a checkbox in the topbar settings).
- chrome-rs: a real install once the browser is ready (see
plugins/chrome-rs/ROADMAP.md). - Win+S / Start button open rust-search instead of Windows Search (risky, a separate decision).
- Non-NTFS drives in rust-search (skipped today).
Known limitations
- System components are disabled or bypassed (reversibly), not removed: deleting
taskmgr.exeor Windows Search outright would break system protection. - Administrator rights are required.
- Win+S and Start still open Windows Search.