# Install ddterm ## [extensions.gnome.org] 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. [extensions.gnome.org]: https://extensions.gnome.org/extension/3780/ddterm/ ## Install OS package ### Arch Linux #### [AUR] Package is available in [AUR]. [AUR]: https://aur.archlinux.org/packages/gnome-shell-extension-ddterm #### Binary repository Binary packages are also available: 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 bundle You can also install the extension from a `.zip` bundle. > [!CAUTION] > If you download and install the bundle from GitHub, or build it from source, > the extension won't be updated automatically when a new version is released. > In particular, `metadata.json` won't contain the `version` key, so it will be > ignored by GNOME Shell's automatic extension updater. ### 1. Obtain the bundle You can either download an already-built bundle, or build it from the source code yourself. #### 1.a) Prebuilt bundle You can download a released version from the [Releases] page. You need the file `ddterm@amezin.github.com.shell-extension.zip`. [Releases]: https://github.com/ddterm/gnome-shell-extension-ddterm/releases Also, the CI system builds a bundle for every commit. Latest bundle for the `master` branch is published here: #### 1.b) Build from source code See [Build.md] for build instructions. [Build.md]: /docs/Build.md ### 2. Install the bundle After downloading or building the bundle, run the following command to install it: gnome-extensions install -f /path/to/ddterm@amezin.github.com.shell-extension.zip > [!TIP] > Instead of installing the bundle on your system, you can test it in a > [nested (windowed) GNOME Shell], or in a [virtual machine]. [nested (windowed) GNOME Shell]: /docs/Debug.md [virtual machine]: /docs/Vagrant.md ### 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 ddterm@amezin.github.com > [!TIP] > It's not necessary to repeat this step after every reinstallation. > If an extension was already enabled for this user, this step can be skipped.