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).
Tabs, a sidebar that folds down to icons, thumbnails, tags, and glass context menus.
Tabs, split panes, profiles, find, selection and mouse support, on a bundled ConPTY.
Live window previews on hover, drag to reorder, drop files onto icons, badges, progress bars and the Recycle Bin.
A "now" pill with your next event or what's playing, the calendar under the clock, and notifications under the bell.
| Calendar | Notifications |
|---|---|
![]() |
![]() |
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.
Today (calendar and weather) and Now playing, under the tray.
Processes, performance graphs, services and startup apps.
Appearance, display, sound, default apps, Windows Update, startup apps, accessibility, privacy, and the dock, top bar, launcher and terminal.
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 runshellman-session.exe --uninstallfrom its folder. - Or from Run new task,
cmd, thenreg delete "HKCU\Software\Microsoft\Windows NT\CurrentVersion\Winlogon" /v Shell /fand sign out and back in.
It only changes things for your own Windows account. Other accounts on the PC keep Explorer.
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.
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.
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.
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.
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.
| 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 |
- 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.
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.










