FreeBSD manual
download PDF document: gnome-extensions.1.pdf
GNOME-EXTENSIONS(1) User Commands GNOME-EXTENSIONS(1)
NAME
gnome-extensions - Command line tool for managing GNOME extensions
SYNOPSIS
gnome-extensions help [COMMAND]
gnome-extensions version
gnome-extensions enable UUID
gnome-extensions disable UUID
gnome-extensions reset UUID
gnome-extensions info UUID
gnome-extensions show UUID
gnome-extensions list [OPTION...]
gnome-extensions prefs UUID
gnome-extensions create [OPTION...]
gnome-extensions pack [OPTION...]
gnome-extensions install [OPTION...] PACK
gnome-extensions uninstall UUID
DESCRIPTION
gnome-extensions is a utility that makes some common GNOME extensions
operations available on the command line.
COMMON OPTIONS
All commands except for help and version handle the following options:
--quiet, -q
Do not print error messages
COMMANDS
help [COMMAND]
Displays a short synopsis of the available commands or provides
detailed help on a specific command.
version
Prints the program version.
enable UUID
Enables the extension identified by UUID.
The command will not detect any errors from the extension itself,
use the info command to confirm that the extension state is
ENABLED.
If the extension is already enabled, the command will do nothing.
The extension will be disabled in GNOME, but may be enabled by
other sessions like GNOME Classic.
info UUID
Show details of the extension identified by UUID, including name,
description and state.
show UUID
Synonym of info.
list [OPTION...]
Displays a list of installed extensions.
Options
--user
Include extensions installed in the user's $HOME
--system
Include extensions installed in the system
--enabled
Include enabled extensions
--disabled
Include disabled extensions
--prefs
Only include extensions with preferences
--updates
Only include extensions with pending updates
-d, --details
Show some extra information for each extension
prefs UUID
Open the preference dialog of the extension identified by UUID.
create [OPTION...]
Creates a new extension from a template.
Options
--name=NAME
Set the user-visible name in the extension's metadata to
NAME
--description=DESC
Set the description in the extension's metadata to DESC
--uuid=UUID
Set the unique extension ID in the metadata to UUID
--template=TEMPLATE
Use TEMPLATE as base for the new extension
-i, --interactive
Prompt for any extension metadata that hasn't been provided
on the command line
specified with --extra-source.
If the extension includes one or more GSettings schemas, they can
either be placed in a schemas/ folder to be picked up
automatically, or be specified with --schema.
Similarily, translations are included automatically when they are
located in a po/ folder, otherwise the --podir option can be used
to point to the correct directory. If no gettext domain is provided
on the command line, the value of the gettext-domain metadata field
is used if it exists, and the extension UUID if not.
All files are searched in SOURCE-DIRECTORY if specified, or the
current directory otherwise.
Options
--extra-source=FILE
Additional source to include in the bundle
--schema=SCHEMA
A GSettings schema that should be compiled and included
--podir=PODIR
A directory with translations that should be compiled and
included
--gettext-domain=DOMAIN
The gettext domain to use for translations
-f, --force
Overwrite an existing pack
-o, --out-dir=DIRECTORY
The directory where the pack should be created
install [OPTION...] PACK
Installs an extension from the bundle PACK.
The command unpacks the extension files and moves them to the
expected location in the user's $HOME, so that it will be loaded in
the next session.
It is mainly intended for testing, not as a replacement for the
extension website. As extensions have privileged access to the
user's session, it is advised to never load extensions from
untrusted sources without carefully reviewing their content.
Options
--force
Override an existing extension
uninstall UUID
Uninstalls the extension identified by UUID.
EXIT STATUS
On success 0 is returned, a non-zero failure code otherwise.
BUGS
The tool is part of the gnome-shell project, and bugs should be