MUTTER(1)
โจ MUTTER โ the manual page but make it make sense โจ
okay so bestie, you opened man mutter and now you're here. welcome. this is the mutter(1) manual page, from the General Commands Manual section, and we're gonna get through it together. grab a snack ๐
๐ธ NAME ๐ธ
MUTTER โ the Clutter-based compositing GTK2 window manager. that's the whole vibe. it's giving "window manager" and it's giving "compositing" and it's giving "GTK2" and honestly? iconic ๐
๐ SYNOPSIS ๐
mutter [--display=DISPLAY] [--sm-client-id=ID] [--sm-disable]
[--sm-save-file=FILENAME] [--version] [--help] [[--] command
[argument...]]
like, you can just run mutter with nothing. you can also pass it a whole little entourage of options. or you can be extra and hand it a command plus its argument...s, optionally after a --. the way that -- just sits there separating thingsโฆ we love a boundary setter ๐
๐ฆ DESCRIPTION ๐ฆ
so this manual page documents mutter briefly. briefly! it says so itself. no cap.
mutter is a minimal X window manager that is aimed at nontechnical users and is designed to integrate well with the GNOME desktop. that's the assignment and it ate. ๐
but real talk โ mutter lacks some features that may be expected by traditional UNIX or other technical users. the manpage said it, not me. and it has a suggestion: those users may want to investigate other available window managers for use with GNOME or standalone. no hard feelings, fr fr. go find your main character window manager. ๐ซถ
๐ OPTIONS ๐
one bullet per option, exactly as the original lists them, bestie. nothing skipped, nothing merged. ๐
--display=DISPLAYโ connects to X displayDISPLAY. that's the screen you're talking to. tell it which one. โจ--sm-client-id=IDโ specify a session management ID. drop thatIDin there. ๐--sm-disableโ disables the session management. no session management. none. gone. ๐--sm-save-file=FILENAMEโ loads a session fromFILENAME. hand it the file, it loads the session. simple as. ๐--versionโ prints the version number. that's it. that's the whole job. ๐ฅ-?,--helpโ shows a summary of options. when you're lost, you're not alone, bestie. ๐
โญ CONFIGURATION โญ
mutter configuration can be found under Preferences->Windows and Preferences->Keyboard Shortcuts on the menu-panel. yes, with the -> arrows, that's literally how it's written. click through, you got this. ๐
and if you're feeling like a main character? advanced configuration can be achieved directly through gsettings. that's the power-user route. iykyk. ๐ง
๐ AUTHOR ๐
the lore, because we respect the lore:
- the original manual page was written by Thom May
<thom@debian.org>. - it was updated by Akira TAGOH
<tagoh@debian.org>for the Debian GNU/Linux system (with permission to use by others). - and then updated by Luke Morton and Philip O'Brien for inclusion in
mutter.
three rounds of glow-ups on this page alone. obsessed. ๐ธ
okay that's the whole page, bestie โ every option, every path, every name, every email, all of it. go forth and composite. ๐
mutter(1) โ dated 11 February 2006 โ from the General Commands Manual, in the mutter era. that's a wrap, periodt. ๐โจ
๐ฆ where this page comes from
- alpine 3.24: mutter-doc 50.2-r1 ยท GPL-2.0-or-later
- arch rolling: mutter 51.1-1 ยท GPL-2.0-or-later
- fedora 44: mutter 50.0-1.fc44 ยท GPL-2.0-or-later
- fedora 44: mutter 50.0-1.fc44 ยท GPL-2.0-or-later
- fedora 44: mutter 50.5-1.fc44
- fedora 44: mutter 50.5-1.fc44
- fedora 44: mutter 50.6-1.fc44
- fedora 44: mutter 50.6-1.fc44
- fedora 44: mutter 50.6-2.fc44 ยท GPL-2.0-or-later
- fedora 44: mutter 50.6-2.fc44 ยท GPL-2.0-or-later
- nixos 26.05: mutter 50.5
- nixpkgs unstable: mutter 50.5
- ubuntu resolute: mutter 50.1-0ubuntu2
- ubuntu resolute: mutter 50.1-0ubuntu2.4
- ubuntu resolute: mutter 50.1-0ubuntu2.5
- ubuntu stonking: mutter 51.0-1ubuntu3
- ๐ girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms