Skip to content

Latest commit

 

History

History
89 lines (53 loc) · 2.46 KB

INSTALL.md

File metadata and controls

89 lines (53 loc) · 2.46 KB

The easiest way to install the extension is to go to extensions.gnome.org.

However, the review process on extensions.gnome.org is sometimes slow. A new release may be available here on GitHub, but not on extensions.gnome.org yet.

Install OS package

Arch Linux

Package is available in AUR.

Binary repository

Binary packages are also available: https://github.com/ddterm/aur

To use the repository, append the following section to /etc/pacman.conf:

[ddterm]
SigLevel = Never
Server = https://ddterm.github.io/aur

Install from GNOME Shell extension package

You can also install the extension from a .zip package.

1. Obtain the package

You could either download an already-built package or build it from the source code yourself.

1.a) Prebuilt package

You can download a released version from Releases page. You need the file [email protected].

Also, the CI system builds a package for every commit. Latest package for the master branch is published here:

https://ddterm.github.io/gnome-shell-extension-ddterm/[email protected]

Warning

If you install the package from the master branch, GNOME Shell will not update it automatically when a new version is released.

1.b) Build from source code

See BUILD.md for build instructions.

2. Install the package

After downloading or building the package, run the following command to install it:

gnome-extensions install -f /path/to/[email protected]

3. Restart GNOME Shell

To detect the newly installed or upgraded extension, GNOME Shell usually needs to be restarted.

On Wayland, the only way is to restart your session - log out, then login back.

On X11 you can restart the shell without logging out by pressing Alt+F2, r, Enter.

4. Enable the extension

After GNOME Shell had been restarted, you can enable the extension using the gnome-tweaks app, or by running:

gnome-extensions enable [email protected]

You'll have to perform this step only once.