.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "gnome-extensions" "1" "" "" "User Commands"
.SH Name
gnome-extensions \- Command line tool for managing GNOME extensions
.SH SYNOPSIS
.nf
\fBgnome\-extensions\fP help [\fICOMMAND\fP]
\fBgnome\-extensions\fP version
\fBgnome\-extensions\fP enable \fIUUID\fP
\fBgnome\-extensions\fP disable \fIUUID\fP
\fBgnome\-extensions\fP reset \fIUUID\fP
\fBgnome\-extensions\fP info \fIUUID\fP
\fBgnome\-extensions\fP show \fIUUID\fP
\fBgnome\-extensions\fP list [\fIOPTION\fP\&...]
\fBgnome\-extensions\fP prefs \fIUUID\fP
\fBgnome\-extensions\fP create [\fIOPTION\fP\&...]
\fBgnome\-extensions\fP pack [\fIOPTION\fP\&...]
\fBgnome\-extensions\fP install [\fIOPTION\fP\&...] \fIPACK\fP
\fBgnome\-extensions\fP uninstall \fIUUID\fP
\fBgnome\-extensions\fP upload [\fIOPTION\fP\&...] \fIPACK\fP\&...
.fi
.sp
.SH DESCRIPTION
.sp
\fBgnome\-extensions\fP is a utility that makes some common GNOME extensions
operations available on the command line.
.SH COMMON OPTIONS
.sp
All commands except for \fBhelp\fP and \fBversion\fP handle the following options:
.sp
\fB\-\-quiet\fP, \fB\-q\fP
.INDENT 0.0
.INDENT 3.5
Do not print error messages
.UNINDENT
.UNINDENT
.SH COMMANDS
.sp
\fBhelp\fP [\fICOMMAND\fP]
.INDENT 0.0
.INDENT 3.5
Displays a short synopsis of the available commands or provides
detailed help on a specific command.
.UNINDENT
.UNINDENT
.sp
\fBversion\fP
.INDENT 0.0
.INDENT 3.5
Prints the program version.
.UNINDENT
.UNINDENT
.sp
\fBenable\fP \fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Enables the extension identified by \fIUUID\fP\&.
.sp
The command will not detect any errors from the extension itself, use the
\fBinfo\fP command to confirm that the extension state is \fIACTIVE\fP\&.
.sp
If the extension is already enabled, the command will do nothing.
.UNINDENT
.UNINDENT
.sp
\fBdisable\fP \fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Disables the extension identified by \fIUUID\fP\&.
.sp
If the extension is not enabled, the command will do nothing.
.UNINDENT
.UNINDENT
.sp
\fBreset\fP \fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Reset the extension identified by \fIUUID\fP\&.
.sp
The extension will be disabled in GNOME, but may be enabled by other sessions
like GNOME Classic.
.UNINDENT
.UNINDENT
.sp
\fBinfo\fP \fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Show details of the extension identified by \fIUUID\fP, including name,
description and state.
.UNINDENT
.UNINDENT
.sp
\fBshow\fP \fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Synonym of info.
.UNINDENT
.UNINDENT
.sp
\fBlist\fP [\fIOPTION\fP\&...]
.INDENT 0.0
.INDENT 3.5
Displays a list of installed extensions.
.sp
\fBOptions\fP
.INDENT 0.0
.INDENT 3.5
\fB\-\-user\fP
.INDENT 0.0
.INDENT 3.5
Include extensions installed in the user\(aqs \fB$HOME\fP
.UNINDENT
.UNINDENT
.sp
\fB\-\-system\fP
.INDENT 0.0
.INDENT 3.5
Include extensions installed in the system
.UNINDENT
.UNINDENT
.sp
\fB\-\-enabled\fP
.INDENT 0.0
.INDENT 3.5
Include enabled extensions
.UNINDENT
.UNINDENT
.sp
\fB\-\-disabled\fP
.INDENT 0.0
.INDENT 3.5
Include disabled extensions
.UNINDENT
.UNINDENT
.sp
\fB\-\-active\fP
.INDENT 0.0
.INDENT 3.5
Only include extensions in active state
.UNINDENT
.UNINDENT
.sp
\fB\-\-inactive\fP
.INDENT 0.0
.INDENT 3.5
Only include extensions in inactive state
.UNINDENT
.UNINDENT
.sp
\fB\-\-prefs\fP
.INDENT 0.0
.INDENT 3.5
Only include extensions with preferences
.UNINDENT
.UNINDENT
.sp
\fB\-\-updates\fP
.INDENT 0.0
.INDENT 3.5
Only include extensions with pending updates
.UNINDENT
.UNINDENT
.sp
\fB\-d\fP, \fB\-\-details\fP
.INDENT 0.0
.INDENT 3.5
Show some extra information for each extension
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBprefs\fP \fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Open the preference dialog of the extension identified by \fIUUID\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBcreate\fP [\fIOPTION\fP\&...]
.INDENT 0.0
.INDENT 3.5
Creates a new extension from a template.
.sp
\fBOptions\fP
.INDENT 0.0
.INDENT 3.5
\fB\-\-name\fP=\fINAME\fP
.INDENT 0.0
.INDENT 3.5
Set the user\-visible name in the extension\(aqs metadata
to \fINAME\fP
.UNINDENT
.UNINDENT
.sp
\fB\-\-description\fP=\fIDESC\fP
.INDENT 0.0
.INDENT 3.5
Set the description in the extension\(aqs metadata to \fIDESC\fP
.UNINDENT
.UNINDENT
.sp
\fB\-\-uuid\fP=\fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Set the unique extension ID in the metadata to \fIUUID\fP
.UNINDENT
.UNINDENT
.sp
\fB\-\-gettext\-domain\fP=\fIDOMAIN\fP
.INDENT 0.0
.INDENT 3.5
Set the gettext domain used by the extension
.UNINDENT
.UNINDENT
.sp
\fB\-\-settings\-schema\fP=\fISCHEMA\fP
.INDENT 0.0
.INDENT 3.5
Set the GSettings schema used by the extension
.UNINDENT
.UNINDENT
.sp
\fB\-\-template\fP=\fITEMPLATE\fP
.INDENT 0.0
.INDENT 3.5
Use \fITEMPLATE\fP as base for the new extension
.UNINDENT
.UNINDENT
.sp
\fB\-\-prefs\fP
.INDENT 0.0
.INDENT 3.5
Include a prefs.js template
.UNINDENT
.UNINDENT
.sp
\fB\-i\fP,
\fB\-\-interactive\fP
.INDENT 0.0
.INDENT 3.5
Prompt for any extension metadata that hasn\(aqt been provided
on the command line
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBpack\fP [\fIOPTION\fP\&...] [\fISOURCE\-DIRECTORY\fP]
.INDENT 0.0
.INDENT 3.5
Creates an extension bundle that is suitable for publishing.
.sp
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 \fB\-\-extra\-source\fP\&.
.sp
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 \fB\-\-schema\fP\&.
.sp
Similarily, translations are included automatically when they are
located in a po/ folder, otherwise the \fB\-\-podir\fP option can be
used to point to the correct directory. If no gettext domain is
provided on the command line, the value of the \fBgettext\-domain\fP
metadata field is used if it exists, and the extension UUID
if not.
.sp
All files are searched in \fISOURCE\-DIRECTORY\fP if specified, or
the current directory otherwise.
.sp
\fBOptions\fP
.INDENT 0.0
.INDENT 3.5
\fB\-\-extra\-source\fP=\fIFILE\fP
.INDENT 0.0
.INDENT 3.5
Additional source to include in the bundle
.UNINDENT
.UNINDENT
.sp
\fB\-\-schema\fP=\fISCHEMA\fP
.INDENT 0.0
.INDENT 3.5
A GSettings schema that should be included
.UNINDENT
.UNINDENT
.sp
\fB\-\-podir\fP=\fIPODIR\fP
.INDENT 0.0
.INDENT 3.5
A directory with translations that should be
compiled and included
.UNINDENT
.UNINDENT
.sp
\fB\-\-gettext\-domain\fP=\fIDOMAIN\fP
.INDENT 0.0
.INDENT 3.5
The gettext domain to use for translations
.UNINDENT
.UNINDENT
.sp
\fB\-f\fP, \fB\-\-force\fP
.INDENT 0.0
.INDENT 3.5
Overwrite an existing pack
.UNINDENT
.UNINDENT
.sp
\fB\-o\fP, \fB\-\-out\-dir\fP=\fIDIRECTORY\fP
.INDENT 0.0
.INDENT 3.5
The directory where the pack should be created
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBinstall\fP [\fIOPTION\fP\&...] \fIPACK\fP
.INDENT 0.0
.INDENT 3.5
Installs an extension from the bundle \fIPACK\fP\&.
.sp
The command unpacks the extension files and moves them to
the expected location in the user\(aqs \fB$HOME\fP, so that it
will be loaded in the next session.
.sp
It is mainly intended for testing, not as a replacement for
the extension website. As extensions have privileged access
to the user\(aqs session, it is advised to never load extensions
from untrusted sources without carefully reviewing their content.
.sp
\fBOptions\fP
.INDENT 0.0
.INDENT 3.5
\fB\-\-force\fP
.INDENT 0.0
.INDENT 3.5
Override an existing extension
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBuninstall\fP \fIUUID\fP
.INDENT 0.0
.INDENT 3.5
Uninstalls the extension identified by \fIUUID\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBupload\fP [\fIOPTION\fP\&...] \fIPACK\fP\&...
.INDENT 0.0
.INDENT 3.5
Upload one or more extension packs to \%<https://\:extensions\:.gnome\:.org>\&.
.sp
If login credentials are required, they can be entered interactively
when prompted. This is generally preferred over the \fB\-\-password\fP
or \fB\-\-password\-file\fP options, which risk exposing the password in
logs, the environment or filesystem (depending on how it was provided).
.sp
\fBOptions\fP
.INDENT 0.0
.INDENT 3.5
\fB\-\-accept\-tos\fP
.INDENT 0.0
.INDENT 3.5
Accept the terms of service at \%<https://\:extensions\:.gnome\:.org/\:upload/>
.UNINDENT
.UNINDENT
.sp
\fB\-\-user\fP=\fIUSER\fP
.INDENT 0.0
.INDENT 3.5
Username to log into \%<https://\:extensions\:.gnome\:.org>
.UNINDENT
.UNINDENT
.sp
\fB\-\-password\fP=\fIPASSWORD\fP
.INDENT 0.0
.INDENT 3.5
Password to log into \%<https://\:extensions\:.gnome\:.org>
.UNINDENT
.UNINDENT
.sp
\fB\-\-password\-file\fP=\fIFILE\fP
.INDENT 0.0
.INDENT 3.5
File to read \%<https://\:extensions\:.gnome\:.org> password from
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXIT STATUS
.sp
On success 0 is returned, a non\-zero failure code otherwise.
.SH BUGS
.sp
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>\&.
.\" End of generated man page.