No description
  • V 96.2%
  • Verilog 2.1%
  • GLSL 1.4%
  • Nix 0.2%
  • CSS 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
freya eb9441d2c5
Start Michaelsoft 10: the Windows 10 look
`theme = ten`, or the edition once upgraded, gives flat white title bars
with the caption buttons of Windows 10, a one pixel accent border and a
soft shadow; a dark acrylic taskbar with the start button, a search box
that opens the quick launcher, Task View, underlined program icons, the
desktops, a two line clock and the Action Center; and a wallpaper of a
window of blue light in a dark room.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 15:52:52 +01:00
aero Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00
conf Document the new features 2026-11-17 13:13:14 +01:00
dbus Add User Account Control, a polkit authentication agent 2026-11-17 15:22:53 +01:00
examples psyconf: make the configuration Turing complete 2026-11-17 12:42:22 +01:00
LICENSES Decode WebP, lossy, lossless, with alpha and animated 2026-11-17 14:16:13 +01:00
protocol Add window feelings and gravity mode 2026-11-17 12:51:39 +01:00
wayland Add User Account Control, a polkit authentication agent 2026-11-17 15:22:53 +01:00
.envrc psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
.gitignore psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
boot.v Add a boot animation 2026-11-17 12:58:48 +01:00
calc.v psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
center.v Say who shows the notifications, and reap only launch's own child 2026-11-17 15:37:52 +01:00
clippy.v Give every monitor its own desktops and taskbar, and add scripting 2026-11-17 14:59:50 +01:00
config.v Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00
desktop.v Give every monitor its own desktops and taskbar, and add scripting 2026-11-17 14:59:50 +01:00
edition.v Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00
face.v Add a notification server and center, and read ~/.face in any format 2026-11-17 13:40:35 +01:00
feelings.v Add window feelings and gravity mode 2026-11-17 12:51:39 +01:00
flake.lock psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
flake.nix psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
generate.vsh psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
gravity.v Add a scratchpad terminal 2026-11-17 15:03:10 +01:00
icons.v Add a notification server and center, and read ~/.face in any format 2026-11-17 13:40:35 +01:00
input.v Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00
ipc.v Give every monitor its own desktops and taskbar, and add scripting 2026-11-17 14:59:50 +01:00
keymap.v Add the Mystify screensaver and a Windows 7 screen locker 2026-11-17 13:09:19 +01:00
launcher.v Give every monitor its own desktops and taskbar, and add scripting 2026-11-17 14:59:50 +01:00
lock.v Call it Michaelsoft 9 2026-11-17 14:37:22 +01:00
main.v Say who shows the notifications, and reap only launch's own child 2026-11-17 15:37:52 +01:00
media.v Add a music panel with a spectrum analyzer to the notification center 2026-11-17 15:10:44 +01:00
notifications.v Say who shows the notifications, and reap only launch's own child 2026-11-17 15:37:52 +01:00
overlay.v Add a boot animation 2026-11-17 12:58:48 +01:00
psychosewm.conf Document every binding and action, monitors, scripting, the scratchpad, 2026-11-17 15:26:08 +01:00
quick.v Give every monitor its own desktops and taskbar, and add scripting 2026-11-17 14:59:50 +01:00
README.md Document every binding and action, monitors, scripting, the scratchpad, 2026-11-17 15:26:08 +01:00
scratchpad.v Add a scratchpad terminal 2026-11-17 15:03:10 +01:00
screensaver.v Add the Mystify screensaver and a Windows 7 screen locker 2026-11-17 13:09:19 +01:00
shell.v Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00
surface.v psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
task_view.v Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00
tree.v psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
uac.v Add User Account Control, a polkit authentication agent 2026-11-17 15:22:53 +01:00
v.mod psychosewm: Windows 7 glass on a bspwm tree, in V 2026-11-17 12:33:11 +01:00
window.v Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00
wm.v Start Michaelsoft 10: the Windows 10 look 2026-11-17 15:52:52 +01:00

psychosewm

Windows 7 glass on a bspwm tree: a river window manager written in V. On screen it goes by Michaelsoft 9.

  • Binary space partitioning, like bspwm. Every desktop is a binary tree of windows. A new window splits the focused one along its longest side, or in the direction you preselected. Splits can be rotated, flipped, balanced and resized, and windows can float, go fullscreen, maximize and minimize.
  • Desktops on every monitor. Each monitor has its own desktops and its own taskbar, and focus moves between monitors like between windows.
  • Scriptable like bspwm. psychosewm focus west, psychosewm query windows -j, psychosewm subscribe and runtime config from any shell.
  • Windows 7. The Harmony wallpaper, Aero glass frames with the caption buttons of 7.css, the superbar with a big icon per program and the Start menu, with real program icons from your icon theme. Or plain pixel borders, if you prefer.
  • A quick launcher, as on macOS: a search box in the middle of the screen that finds programs, runs commands and does math.
  • Notifications. psychosewm is a notification server: notifications pop up in balloons above the clock, and clicking the clock opens a sidebar with a calendar, quick toggles, a spectrum analyzer for your music and all of them.
  • Configured in psyconf, a small lazy functional language that borrows from Haskell, Nix and YAML. It is Turing complete; the examples include a Brainfuck interpreter that computes the gaps. Saved changes apply at once.
  • Windows have feelings. Ignore one and a little sad face appears on it, its glass turns gray, and eventually it cries. Focus it and it is happy.
  • Gravity. Windows fall onto the taskbar and pile up, as heavy as the memory their programs use, wobble like jelly when they land, and can be thrown.
  • Clippy, the paperclip assistant, with a boymoder mode.
  • The boot animation, the Mystify screensaver and the logon screen of Windows 7, including Ctrl+Alt+Delete, as a real screen locker, and User Account Control dimming the screen when something wants your password.
  • A scratchpad terminal that drops down from the top of the screen.
  • Pure V. psychosewm speaks the Wayland wire protocol itself and draws everything with its own renderer, including PNG, JPEG and WebP decoding. It talks D-Bus itself, too. It needs no libwayland, no wayland-scanner, no libdbus and no C code, only a few libc system calls.

Bindings

The modifier is Super. When river runs nested inside another compositor, which usually takes Super for itself, the modifier is Ctrl instead. Set modifier in the configuration or PSYCHOSEWM_MOD to super, ctrl or alt to choose it yourself. Note that with Ctrl, combinations such as Ctrl+C and Ctrl+W no longer reach programs.

The default keys follow bspwm's example sxhkdrc, except that the ones bspwm puts on Ctrl use Alt, so that they also work nested. All of them can be changed in the configuration. With Mod being the modifier:

  • Mod+Return: Open a terminal
  • Mod+-: Drop down the scratchpad terminal, or put it away
  • Mod+Space: Open the quick launcher, Mod+d: the Start menu, Mod+a: the notification center
  • Mod+w: Close the focused window
  • Mod+Alt+q: Exit the Wayland session
  • Mod+Alt+r: Read the configuration file again
  • Mod+Escape: Lock the screen
  • Mod+Shift+g: Toggle gravity
  • Mod+h/j/k/l or arrow keys: Focus the window to the west, south, north or east, also on other monitors
  • Mod+Shift+h/j/k/l: Swap the window with the one in that direction
  • Mod+Alt+h/j/k/l: Preselect where the next window goes, shown as a blue rectangle. Again cancels, as does Mod+Alt+Space.
  • Mod+Alt+Shift+h/j/k/l: Move the split on that side of the window outwards, or the one on the other side inwards
  • Mod+1…9, 0: Focus a desktop of the focused monitor
  • Mod+Shift+1…9, 0: Send the window to a desktop of the focused monitor
  • Mod+[ / ]: Focus the previous or next desktop of the monitor
  • Mod+, / .: Focus the previous or next monitor, Mod+Shift+, / .: send the window there, and follow it
  • Mod+Tab: Focus the last desktop, Mod+`: the last window
  • Mod+c / Mod+Shift+c: Focus the next or previous window
  • Mod+m: Toggle the monocle layout, one window at a time
  • Mod+g: Swap the window with the biggest one
  • Mod+s: Float the window, or tile it again if it floats. Mod+t always tiles it, also out of fullscreen and maximized.
  • Mod+f: Toggle fullscreen, Mod+Shift+f: toggle maximized
  • Mod+n: Minimize the window, Mod+Shift+n brings back the last one
  • Mod+r / Mod+Shift+r: Rotate the window's parent split clockwise or counterclockwise
  • Mod+x / Mod+y: Mirror the splits left to right or top to bottom
  • Mod+e: Balance the desktop so all windows get the same area, Mod+Shift+e: reset every split to the configured ratio

Pointer:

  • Mod+Left drag or dragging a titlebar: Move a floating window, or drop a tiled one onto another to swap them, or onto an empty monitor
  • Mod+Right drag: Resize a floating window, or move the splits next to the corner nearest to the pointer
  • Clicking a window focuses it. The caption buttons minimize, maximize and close, and double-clicking a titlebar maximizes.
  • Taskbar buttons start a pinned program, focus its window, minimize it if it already has focus, or cycle through its windows. The desktop names next to the clock switch desktops, and so does the wheel over the taskbar or the desktop. The clock opens the notification center, and the sliver at the far right shows the desktop.

Dialogs and windows with a fixed size float.

Binding keys

Bindings go in the keys section of the configuration, on top of the defaults: a key combination, =, and an action.

keys =
  mod+b = spawn "firefox"
  mod+shift+s = exec "grim -g \"$(slurp)\" - | wl-copy"
  ctrl+alt+t = terminal
  XF86AudioRaiseVolume = exec "wpctl set-volume @DEFAULT_SINK@ 5%+"
  mod+q = none                      -- remove a default binding
  -- defaults = false               -- or drop all of them

A combination is any of mod (the modifier above), super, ctrl, alt and shift, joined with +, then a key. Keys are a single character (a, 1, -, ,), F1 to F35, a name (Return, space, Tab, Escape, BackSpace, Delete, Insert, Home, End, Prior, Next, Left, Up, Right, Down, Print, Pause, Menu, minus, plus, equal, bracketleft, bracketright, backslash, semicolon, apostrophe, grave, comma, period, slash), a media key (XF86AudioRaiseVolume, XF86AudioLowerVolume, XF86AudioMute, XF86AudioMicMute, XF86AudioPlay, XF86AudioPause, XF86AudioStop, XF86AudioNext, XF86AudioPrev, XF86MonBrightnessUp, XF86MonBrightnessDown and more), or a keysym number like 0x1008ff2a.

The actions, which psychosewm <action> runs as well:

Action What it does
terminal Open a terminal
spawn "cmd", spawn [ "cmd", "arg" ] Run a program
exec "shell command" Run a command with sh -c
launcher (or start_menu) Open or close the Start menu
quick Open or close the quick launcher
center (or notifications) Open or close the notification center
scratchpad Drop down the scratchpad terminal, focus it, or put it away
close Close the focused window
focus D, swap D Focus the window in direction D, or swap with it
presel D, cancel_presel Preselect where the next window goes, or not
grow D Move the split on side D outwards
desktop N, send N Focus desktop N of the focused monitor, or send the window there
next_desktop, prev_desktop, last_desktop Focus another desktop
monitor M, send_monitor M Focus monitor M, or send the window there
next_window, prev_window, last_window Focus another window
floating Float the window, or tile it if it floats
tiled Tile the window, out of floating, fullscreen and maximized
fullscreen, maximize Toggle fullscreen, or maximized
minimize, restore Minimize the window, or bring back the last one
monocle Toggle showing one tiled window at a time
swap_biggest Swap the window with the biggest one
rotate 90, rotate 180, rotate 270 Rotate the parent split
flip horizontal, flip vertical Mirror the parent split
balance, equalize Give all windows the same area, or reset the ratios
gravity Toggle gravity
lock, screensaver Lock the screen, or start Mystify
reload Read the configuration again
exit End the Wayland session
none Nothing, to remove a default binding

D is west, south, north or east (or left, down, up, right), N a desktop from 1 to 10, and M next, prev or a direction.

Configuration

psychosewm reads ~/.config/psychosewm/psychosewm.conf, or the file in $PSYCHOSEWM_CONFIG. Without one it uses the defaults. When you save the file, psychosewm reads it again within a second. Mistakes are shown in a balloon above the clock and the rest of the file still applies; a syntax error keeps the previous configuration.

psychosewm.conf in this repository documents every option with its default, copy it to start. A shorter example:

-- Comments as in Haskell
gaps = { inner = 12; outer = 24; }      -- attribute sets as in Nix

border =                                -- nesting by indentation as in YAML
  style = pixel                         -- aero, pixel or none
  width = 3
  color = #3399ff
  inactive = #5a6a7a

wallpaper:                              -- `:` works as well as `=`
  image: ~/Pictures/wallpaper.jpg
  mode: fill                            -- fill, fit, stretch, center, tile

desktops = [ web, code, chat, music ]
pinned =
  - terminal
  - firefox.desktop

keys =
  mod+b = spawn "firefox"               -- actions apply to their arguments
  mod+shift+Return = spawn [ "foot", "-e", "htop" ]
  XF86AudioRaiseVolume = exec "wpctl set-volume @DEFAULT_SINK@ 5%+"
  mod+q = none

The options:

  • modifier: auto, super, ctrl or alt
  • terminal: the command for Mod+Return
  • font: a TrueType font file
  • gaps: a number, or inner (between windows) and outer (at the screen edges)
  • scheme: longest_side like bspwm, or alternate; split_ratio: where new splits divide
  • focus_follows_pointer: true or false
  • desktops: how many desktops every monitor gets, up to 10, or a list of their names; monitors names them per monitor: monitors = { DP-1 = [ web, code ]; HDMI-A-1 = 3; }
  • border: style is aero for glass frames, colored by color and intensity (Windows 7's window color), pixel for a plain border of width pixels in color for the focused window and inactive for the others, or none. Windows are asked to leave out their own title bars, and the ones that cannot, like GTK apps and Firefox, still get the frame around them; csd = true leaves those to their own decorations.
  • wallpaper: harmony, a color, or an image (PNG, JPEG or WebP) with a mode and a background color
  • pinned: the taskbar's pinned programs. terminal, browser and files are yours from xdg-mime, other entries are desktop entries, program names or commands.
  • keys: key bindings on top of the defaults, see Binding keys
  • feelings: enabled, and after how many seconds without focus windows get sad (sad_after) and cry (cry_after)
  • gravity: strength and bounce
  • clippy: classic, boymoder or off
  • boot: whether to show the boot animation
  • screensaver: seconds idle after which Mystify starts, and whether it should lock
  • lock: ctrl_alt_del, and a checker command instead of unix_chkpwd
  • notifications: whether to be the notification server
  • visualizer: whether the notification center has the music panel, or enabled and the command that records what plays (16 bit mono samples at 44100 Hz on its output; pw-record by default)
  • scratchpad: the command of the scratchpad terminal and the app_id it has, by default your terminal with an app id set for foot, ghostty, alacritty, kitty and wezterm, and its width and height as parts of the monitor (1 and 0.45)
  • uac: whether to be the polkit authentication agent, or enabled and a helper command instead of polkit's

The language

The format in short: name = value entries; dotted names, indented blocks or { a = 1; b = 2; } for nested options; lists as [ a, b ], [ a b ] or - items; numbers, "strings", #rrggbb[aa] colors, true/false and bare words; and -- or {- -} comments.

It is also a lazy functional language. Entries with parameters, entries whose name starts with _ and everything below a let line are definitions instead of options, visible to the whole file. There are if then else, let ... in, \x -> x * 2 lambdas, arithmetic, comparisons, && ||, ++ for strings and lists, ranges like [1 .. 10] and builtins such as map, filter, foldl, show, env, mix and hour. Recursion in tail position runs in constant space.

let
  fib n = if n < 2 then n else fib (n - 1) + fib (n - 2)
  night = hour >= 20 || hour < 7
gaps.inner = fib 7
border.color = if night then #3a3f6b else #74b8fc
desktops = map upper [ "web", "code", "chat" ]

Evaluation is bounded, so a configuration that loops forever is reported as an error instead of hanging the window manager. examples/turing.conf computes its outer gap with a Brainfuck interpreter written in psyconf. The language is the conf module, v test conf runs its tests, Brainfuck included.

Feelings, gravity and Clippy

Windows that have not had focus for sad_after seconds get a little sad face in their corner, in the style of a 2006 instant messenger, and their glass turns gray. After cry_after they cry. Focusing one makes it happy for a moment.

Mod+Shift+g turns on gravity. Windows shrink a little and fall onto the taskbar, pile up, and slide off each other. Each weighs as much as the memory its program uses, shown in its titlebar: heavy windows fall faster through the air, push light ones aside, shake the others when they land and are harder to throw. Everything wobbles like jelly on impact. Drag a window and let go to throw it. Turn gravity off and windows go back to their tiles.

Clippy pops up above the taskbar now and then: when a window cries, when the tiles get uneven, when gravity turns on, when the configuration is broken. Click it for a tip. clippy = boymoder gives it a beanie, an oversized hoodie and a little pin.

Boot, screensaver and lock screen

When psychosewm starts, four orbs of light swirl in and become the flag before the desktop appears. After screensaver.after seconds without input the Mystify screensaver starts: your window frames come loose and bounce around as glowing polygons.

Mod+Escape locks the session with the Windows 7 logon screen: press Ctrl+Alt+Delete, type your password below your picture, and get welcomed back. Locking uses the ext-session-lock protocol, so the session stays locked even if the window manager crashes. Passwords are checked by unix_chkpwd, the setuid helper PAM itself uses, which psychosewm runs with the password on its standard input; it is in /run/wrappers/bin on NixOS. Without it, set lock.checker. psychosewm refuses to lock when it cannot check passwords.

Quick launcher and Start menu

Mod+Space opens the quick launcher in the middle of the screen. Type to find programs by name, description and keywords; Enter starts the selected one. A calculation like 2^10*3 or sqrt(2)*pi shows its result, and Enter copies it with wl-copy. The last result runs what you typed as a shell command.

The Start menu opens with the start orb or Mod+d. It lists your recently used programs, and "All Programs" lists all of them. Search works the same way. The links on the right open your folders with xdg-open, the shut down button ends the session and the arrow next to it locks the screen. Your picture, here and on the lock screen, is ~/.face, ~/.face.icon or your AccountsService icon, in PNG, JPEG or WebP.

The taskbar pins your terminal, web browser and file manager by default. Programs that are running get a glass button, glowing in the color of their icon when hovered. Icons come from the hicolor theme and the pixmaps directories, PNG only.

Programs you launch are remembered in $XDG_STATE_HOME/psychosewm/recent.

Notifications

psychosewm implements the freedesktop notification server, so notify-send and everything else that notifies just works. A notification pops up in a balloon above the clock for six seconds, or as long as the program asks; critical ones stay until you close them. Clicking a balloon runs its default action or focuses the program's window.

Clicking the clock, or Mod+a, slides in the notification center: the clock and a calendar, toggles for Do not disturb (no balloons but critical ones), gravity, Clippy, the screensaver, the lock screen and the settings (the configuration file in your $EDITOR), and below them every notification, with its picture and its action buttons. A badge on the clock counts the ones you haven't seen.

If another notification daemon, like mako or dunst, is already running, psychosewm waits in line and takes over when it exits. To leave notifications to it for good, set notifications = false.

The center also has a music panel. While it is open, pw-record listens to what your speakers play and a spectrum analyzer shows it, LED bars from green to red with peaks that hold and fall, under a green display with the track of the playing MPRIS player scrolling past. The buttons go back, play or pause, and skip. Nothing records while the center is closed.

Monitors

Every monitor has its own desktops, as in bspwm, and its own taskbar with its own windows and pager. Mod+1…0 and the other desktop keys work on the focused monitor; Mod+, and Mod+. move the focus between monitors, and with Shift take the window along. The Start menu, the quick launcher and the notification center open on the monitor they were opened from.

Desktops can be named per monitor with monitors; the others get desktops. When a monitor is unplugged, its desktops move to another one with their windows, and they go back when it returns.

Scripting

psychosewm with arguments talks to the window manager running in the session, like bspc does to bspwm:

psychosewm focus west             # any action of a key binding
psychosewm desktop 2
psychosewm spawn foot
psychosewm window 7 floating      # focus window 7, then float it
psychosewm query windows          # one per line, tab separated
psychosewm query monitors -j      # or as JSON
psychosewm config gaps 20         # an option for this session only
psychosewm config reset
psychosewm subscribe focus desktop

query lists windows (number, monitor, desktop, flags, app id, title), desktops, monitors or the focused window. subscribe prints a line for every change, tab separated: focus with the focused window, desktop when a monitor shows another desktop, window add and window remove, title and monitor. It suits status bars:

psychosewm subscribe focus | while IFS=$'\t' read -r _ id app title; do
  echo "${title:-$app}"
done

Options set with config apply on top of the configuration file and stay until config reset or the end of the session. The socket is in $XDG_RUNTIME_DIR, and programs started by the window manager find it in PSYCHOSEWM_SOCKET. Run psychosewm help for all of it.

Scratchpad

Mod+- drops a terminal down from the top of the focused monitor, and puts it away again. It keeps running while hidden, so whatever you leave in it is still there next time, on whichever monitor you call it. It is your terminal started with its own app id; for a terminal psychosewm does not know, set scratchpad.command and scratchpad.app_id.

User Account Control

psychosewm is the polkit authentication agent of its session. When pkexec or a system service needs your password, every screen dims and the Windows 7 dialog asks whether the program may make changes to this computer, amber for programs and blue for system services, with your picture and a password field. Yes checks the password with polkit's own helper, No refuses. If another agent such as polkit-gnome or soteria already runs in the session, it keeps the job; uac = false leaves it to others for good.

Building and running

With Nix, nix develop opens a shell with V, river, foot and the Selawik font, Microsoft's open stand-in for Segoe UI. The included .envrc does the same for direnv after direnv allow.

v .
river -c ./psychosewm

Use v -prod . for an optimized build. Run from inside an existing Wayland session, river opens nested in a window.

Without Nix you need V (0.5.2 tested), river (0.5.0 and 0.5.2 tested) and a TrueType font.

Environment

  • PSYCHOSEWM_CONFIG: the configuration file
  • PSYCHOSEWM_MOD: the binding modifier, overriding the configuration
  • PSYCHOSEWM_TERMINAL: the terminal, when the configuration sets none
  • PSYCHOSEWM_FONT: a TTF file, when the configuration sets none
  • PSYCHOSEWM_DEBUG: set to log every Wayland message, like WAYLAND_DEBUG
  • PSYCHOSEWM_SOCKET: the scripting socket, set by the window manager for the programs it starts
  • PSYCHOSEWM_UAC_PROCESS: a process id; User Account Control then serves only that process instead of the session, for testing it

Code

  • main.v, wm.v: startup, the event loop and the manage and render sequences of the river protocol
  • config.v, conf/: the configuration, and the psyconf lexer, parser and evaluator
  • tree.v, desktop.v: the bspwm trees, desktops, monitors and focus
  • ipc.v: scripting, scratchpad.v: the scratchpad terminal
  • window.v, shell.v, input.v, surface.v: window decorations, wallpaper and taskbar, bindings and pointer input, and buffers
  • feelings.v, gravity.v, clippy.v: feelings, physics and the paperclip; boot.v, screensaver.v, overlay.v: the boot animation and Mystify; lock.v, keymap.v: the screen locker and its keyboard
  • launcher.v: the Start menu, quick.v, calc.v: the quick launcher and its calculator, icons.v: program icons, face.v: your picture
  • notifications.v, center.v, media.v: the notification server and center, and its music panel; uac.v: User Account Control; dbus/: the D-Bus client
  • aero/: the renderer and the image decoders, see v run tools/preview for mock desktops
  • wayland/: the Wayland client. client.v handles the wire protocol and sys.c.v holds the only libc calls. The protocol_*.v bindings are generated from protocol/*.xml by v run generate.vsh.

Limitations

  • Everything is drawn at scale 1, so HiDPI outputs show it upscaled.
  • GTK apps always draw their own header bar, inside the frame. Some can turn theirs off, like Ghostty with gtk-titlebar = false.
  • Glass shows a blurred copy of the wallpaper, not the windows behind it.
  • Icons that only come as SVG are drawn as a lettered badge.
  • JPEG wallpapers must be baseline or progressive with Huffman coding, which is nearly all of them; EXIF rotation is ignored.
  • Animated WebP images show their first frame.
  • Fonts must be TrueType with glyf outlines.
  • Passwords in the User Account Control dialog can use the Latin-1 characters, and those on the lock screen the characters of the XKB keymap's first group, but no compose sequences or input methods.
  • A window's weight is the memory of its own process, which for some programs is only a part of what they use.

psychosewm is released under the Zero-Clause BSD license. The protocol files are MIT licensed, see LICENSES/. The WebP decoder in aero/vp8.v, aero/vp8l.v, aero/vp8_tables.v and aero/webp.v is a port of golang.org/x/image and keeps its BSD-3-Clause license. The caption button glyphs in aero/assets/ are from 7.css, MIT licensed, see aero/assets/LICENSE-7.css. The Windows flag is a trademark of Microsoft.