gnome-extensions

GNOME Shell extension manager

TLDR

List the installed extensions

$ gnome-extensions list

List only the ones that are enabled

$ gnome-extensions list --enabled

List the ones with an update waiting

$ gnome-extensions list --updates

Show an extension's details

$ gnome-extensions info [extension_id]

Enable an extension

$ gnome-extensions enable [extension_id]

Disable an extension

$ gnome-extensions disable [extension_id]

Reset an extension to its system default state

$ gnome-extensions reset [extension_id]

Open an extension's preferences dialog

$ gnome-extensions prefs [extension_id]

Install an extension from a zip file

$ gnome-extensions install [path/to/extension.zip]

Reinstall over an existing copy

$ gnome-extensions install --force [path/to/extension.zip]

Uninstall an extension

$ gnome-extensions uninstall [extension_id]

Scaffold a new extension interactively

$ gnome-extensions create --interactive

Pack an extension for distribution

$ gnome-extensions pack [path/to/source]

SYNOPSIS

gnome-extensions command [options]

gnome-extensions is the command-line tool for managing GNOME Shell extensions. Extensions modify GNOME Shell's behavior and appearance, adding features like system monitors, window tiling, or custom themes.Extensions are identified by UUIDs like dash-to-dock@micxgx.gmail.com. They are installed in ~/.local/share/gnome-shell/extensions/ (user) or /usr/share/gnome-shell/extensions/ (system-wide).

PARAMETERS

list

List installed extensions (--user for user-only, --enabled for enabled-only)

info UUID

Show information about an extension

enable UUID

Enable an extension

disable UUID

Disable an extension

uninstall UUID

Remove an extension

create

Create a new extension from template

pack

Package extension for distribution

install BUNDLE

Install extension from bundle file

prefs UUID

Open extension's preferences window

INSTALL

sudo apt install gnome-shell

sudo dnf install gnome-shell

sudo pacman -S gnome-shell

sudo apk add gnome-shell

sudo zypper install gnome-shell

nix profile install nixpkgs#gnome-shell

CAVEATS

Extensions can cause GNOME Shell instability or crashes. Extensions must be updated for each new GNOME Shell version. Disabling a problematic extension may require logging out or using a TTY.

HISTORY

gnome-extensions was introduced in GNOME 3.34 (2019) as a modern replacement for the older gnome-shell-extension-tool. GNOME Shell extensions themselves have been available since GNOME 3.0 in 2011.