gnome-shell(1)
๐ gnome-shell โ the manual page, but make it cute
okay so bestie, welcome to gnome-shell(1) ๐ this is the User Commands part of the manual, and we're about to read it together like it's a group chat. grab a snack ๐
โจ NAME โจ
gnome-shell โ the Graphical shell for the GNOME desktop, aka the thing literally making your screen exist ๐
๐ SYNOPSIS ๐
gnome-shell [OPTION...]
๐ฆ DESCRIPTION ๐ฆ
GNOME shell provides core user interface functions for the GNOME 3 desktop, like switching to windows and launching applications. (yes, bestie, that's the whole "click thing, thing opens" pipeline ๐ซถ) GNOME shell takes advantage of the capabilities of modern graphics hardware and introduces innovative user interface concepts to provide a visually attractive and easy to use experience. it's giving glow-up, it's giving polish โจ
gnome-shell is a required component of the GNOME desktop, i.e. it is listed in the RequiredComponents field of /usr/share/gnome-session/sessions/gnome.session. It is started in the window manager phase of the session. so likeโฆ it's not optional. it's the main character. periodt ๐
๐ OPTIONS ๐
--waylandโ Run as a wayland compositor. letting it cook at the compositor level, no cap ๐ฅ--display-serverโ Run as a full display server, rather than nested. full send, not tucked inside anything else ๐ธ--no-x11โ Run wayland compositor without starting Xwayland. X11? never met her ๐--wayland-display=DISPLAYโ Wayland display name to use. you're picking which display it walks into ๐--mode=MODEโ Use a specific mode, e.g."gdm"for login screen. yes bestie, that example is literally in here, i didn't make it up โญ--list-modesโ List possible modes and exit. window shopping only ๐--versionโ Print version and exit. classic. iconic. ๐ฆ--helpโ Display help and exit. the most relatable flag of all ๐ญ
๐ FILES ๐
/usr/share/gnome-session/sessions/gnome.session/usr/share/applications/org.gnome.Shell.desktop
(yes, that's one list, and yes, it ends in a period in the original. copy it exactly, bestie ๐ซถ)
๐ BUGS ๐
The bug tracker can be reached by visiting the website https://gitlab.gnome.org/GNOME/gnome-shell/issues. ๐
Before sending a bug report, please verify that you have the latest version of gnome-shell. Many bugs (major and minor) are fixed at each release, and if yours is out of date, the problem may already have been solved.
fr fr, check your version first โ nothing sadder than reporting a bug that got fixed three releases ago, iykyk ๐ญ
๐ ADDITIONAL INFORMATION ๐
For further information, visit the website https://gitlab.gnome.org/GNOME/gnome-shell/-/blob/main/README.md. go read it, she ate ๐ฅ
okay that's the whole page, no skips, no summaries, every flag accounted for ๐ this was gnome-shell(1) from the User Commands section of the manual โ same title, same section, just with way better vibes ๐ stay hydrated, back up your configs, and stan open source ๐งโจ
๐ฆ where this page comes from
- nixpkgs unstable: gnome-shell 50.4
- ubuntu stonking: gnome-shell 51.0-2ubuntu3
- ๐ girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms