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 ACTIVE.

          If the extension is already enabled, the command will do nothing.

       disable UUID
          Disables the extension identified by UUID.

          If the extension is not enabled, the command will do nothing.

       reset UUID
          Reset the extension identified by UUID.

          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

              --active
                 Only include extensions in active state

              --inactive
                 Only include extensions in inactive state

              --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

              --gettext-domain=DOMAIN
                 Set the gettext domain used by the extension

              --settings-schema=SCHEMA
                 Set the GSettings schema used by the extension

              --template=TEMPLATE
                 Use TEMPLATE as base for the new extension

              --prefs
                 Include a prefs.js template

              -i, --interactive
                 Prompt for any extension metadata that hasn't been provided on the command line

       pack [OPTION...] [SOURCE-DIRECTORY]
          Creates an extension bundle that is suitable for publishing.

          The  bundle  will  always include the required files extension.js and metadata.json, as well as any of
          the optional stylesheet.css, stylesheet-dark.css, stylesheet-light.css or  prefs.js  if  found.   Each
          additional source that should be included must be 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 reported in its issue tracker at
       <https://gitlab.gnome.org/GNOME/gnome-shell/issues> .

                                                                                             GNOME-EXTENSIONS(1)