Skip to content
xnixyPublic

About

A Rust replacement for the Windows 11 shell

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

shellman

I wanted Windows 11 to look and feel the way I want, so I'm replacing the shell. shellman takes the place of explorer.exe: its own top bar, dock, desktop, launcher, Alt+Tab, Task View, control centre, file manager, terminal, settings and task manager. The look comes from my Glasshouse GTK theme: app windows are one sheet of frosted glass with a sidebar and boxed rows, the bar, dock and panels float as islands of glass, all in one accent colour. It's written in Rust.

I use it every day as my real shell. It's still a personal project and a lot is unfinished, so expect rough edges. What's done, what's not and why things work the way they do is in docs/PLAN.md (my working notes, long and detailed).

Screenshots

Files

Tabs, a sidebar that folds down to icons, thumbnails, tags, and glass context menus.

Files in a folder, in grid view

Terminal

Tabs, split panes, profiles, find, selection and mouse support, on a bundled ConPTY.

Terminal split in two, with the find bar open

Dock

Live window previews on hover, drag to reorder, drop files onto icons, badges, progress bars and the Recycle Bin.

Dock with window previews

Dock with progress bars and an attention mark

Top bar

A "now" pill with your next event or what's playing, the calendar under the clock, and notifications under the bell.

The now pill beside the clock

Calendar Notifications
Calendar panel Notifications panel

Control centre

Wi-Fi, Bluetooth, the sound output and microphone, brightness for each monitor, and lock, sleep, restart, shut down and sign out, from the top bar's right end.

Control centre

Desktop widgets

Today (calendar and weather) and Now playing, under the tray.

The Today widget under the tray

Task Manager

Processes, performance graphs, services and startup apps.

Task Manager, Performance page

Settings

Appearance, display, sound, default apps, Windows Update, startup apps, accessibility, privacy, and the dock, top bar, launcher and terminal.

Settings, Appearance page

Before you try it

shellman really replaces your shell if you let it. Installing it doesn't do that on its own: making it the shell is a separate switch, off unless you turn it on. If you do turn it on and something goes wrong, here's how to get Explorer back:

  • Hold Shift while you sign in. shellman steps aside and starts Explorer.
  • Or press Ctrl+Alt+Del, open Task Manager, Run new task, explorer.exe. Then uninstall shellman from Settings > Apps, or run shellman-session.exe --uninstall from its folder.
  • Or from Run new task, cmd, then reg delete "HKCU\Software\Microsoft\Windows NT\CurrentVersion\Winlogon" /v Shell /f and sign out and back in.

It only changes things for your own Windows account. Other accounts on the PC keep Explorer.

Install

Download shellman-<version>-setup.exe from the latest release, or build it yourself (see below). Run it:

  • Pick a folder. The default is %LOCALAPPDATA%\Programs\shellman, no admin rights needed.
  • Optional switches, all off by default: make shellman your shell from the next sign-in, make shellman Terminal the default terminal, use shellman Files for other apps' Open and Save dialogs, and, when Firefox is installed, give Firefox the Islands look (see below).
  • "Also install Blurman" (on unless it is already there) gets Blurman from the Microsoft Store without opening the Store. It is an app of its own: uninstalling shellman keeps it unless you tick "Also remove Blurman".
  • Click Install.

Running a newer setup over an existing install updates it and keeps your settings.

Updates

An installed shellman updates itself. About 5 minutes after you sign in, and then once a day, it asks GitHub whether there's a newer release. If there is, it downloads the setup file and checks it before running anything: every release comes with a signature made with my release key, and shellman has the public half of that key built in, so a file that wasn't signed by me, or was changed on the way, or is an older release, is refused. Then it installs quietly. It waits while something is fullscreen (a game, a video, a presentation) or while files are being copied. The apps restart by themselves; the shell process itself switches over the next time you sign in. It never signs you out.

You can turn this off in Settings > About > Update automatically. The same page has Check now, the version you're running and a link to the release notes. What it did each time is in %LOCALAPPDATA%\shellman\session.log.

A copy you built and ran from target\release never updates itself; only an installed one does.

Uninstall

Settings > Apps > Installed apps > shellman > Uninstall.

It puts back everything it changed (the shell, the default terminal, the Open and Save dialogs), closes shellman's apps and removes its files and shortcuts. You can also tell it to remove your settings. If shellman is the shell running right then, it keeps running until you sign out and the files go when you sign back in. If Firefox has the Islands look, it offers to take it out too (on by default) and puts back what it replaced; close Firefox first.

Firefox

shellman can give Firefox its Islands look: floating glass pills and rounded islands, no window frame. Settings > Appearance > Firefox shows whether Firefox is installed, lets you pick the profile (the one Firefox opens by default is preselected), says whether the look is installed there, and has Install, Update and Remove. Close Firefox first; it is changed from its next start. Install backs up the profile's chrome folder and user.js, and Remove puts them back exactly.

"With scripts" (on by default) adds the live look (accent and glass follow shellman without a restart) and more, smaller islands. Firefox then runs shellman's script files from your profile with full browser rights, and their small loader goes into Firefox's own folder, which asks for administrator rights once. Details, and the same thing as PowerShell scripts, in integrations/firefox.

Building

You need Windows 11 and a current Rust toolchain.

cargo build --release --workspace
target\release\shellman-installer.exe --pack target\release

The setup file ends up in target\dist.

While working on it I skip the setup file and use the command-line tool instead:

target\release\shellman-setup.exe install --from target\release
target\release\shellman-setup.exe update --from target\release --restart
target\release\shellman-setup.exe uninstall --revert

shellman-setup --help lists everything it can do.

Releases are made with cargo xtask release --version X.Y.Z: it builds, packs, signs the setup file and writes release notes from the commits since the last release, and only publishes it on GitHub with --publish. The signing key is in my password manager, not in the repo; see "Install and update" in docs/PLAN.md.

What's in here

Folder What it is
apps/session The shell process Windows starts at sign-in. Starts and watches over everything else
apps/bar Top bar, tray, dock, notifications, calendar
apps/desktop, apps/shelf Wallpaper, the file shelf and the widgets
apps/launcher, apps/switcher, apps/taskview App launcher, Alt+Tab, and Task View (Win+Tab)
apps/files, apps/pickhook File manager, and the hook that gives other apps its Open and Save dialogs
apps/terminal Terminal
apps/settings, apps/control, apps/tasks Settings, the control centre, task manager
apps/elevate The administrator helper: the few things that need admin rights, behind a UAC prompt
apps/setup, apps/installer Install, update and uninstall, and the one-file setup
apps/update, crates/update Automatic updates: finding, checking and installing a new release
xtask The release command (cargo xtask release)
crates/core, crates/ui Shared Windows code, and the shared look (glass, colours, controls)
integrations/firefox The Firefox look's files (shipped in the install folder's firefox); crates/core/src/firefox installs them

Known problems

  • shellman's own apps and panels sometimes opened slowly after a few idle minutes. I couldn't make it happen again in testing (5 to 15 minutes idle). The one big cost I found, Windows Defender scanning each app the first time it runs after an install or update, is now paid in advance. If you still see it, please open an issue.

Licence

Copyright (C) 2026 xnixy. shellman is free software under the GNU General Public License, version 3 or any later version: see LICENSE. You can use it, change it and share it, and if you share a changed version, you share its source under the same licence.

The bundled ConPTY is Microsoft's, under the MIT licence: see third_party/conpty.

About

A Rust replacement for the Windows 11 shell

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages