Hexa's Blog

How to install gnome extension manually?

01/05/2025 @ Saigon Linux

if you want to install automatically with gnome-browser-connector, you can visit this guide: https://gnome.pages.gitlab.gnome.org/gnome-browser-integration/pages/installation-guide.html

Step 1: Go to https://extensions.gnome.org, find and download extension in zip file.

In this example, I would like to install AppIndicator and KStatusNotifierItem Support by 3v1n0

Step 2: Extract the zip file, and find a file named metadata.json

This is file content of metadata.json.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "_generated": "Generated by SweetTooth, do not edit",
  "description": "Adds AppIndicator, KStatusNotifierItem and legacy Tray icons support to the Shell",
  "gettext-domain": "AppIndicatorExtension",
  "name": "AppIndicator and KStatusNotifierItem Support",
  "settings-schema": "org.gnome.shell.extensions.appindicator",
  "shell-version": [
    "45",
    "46",
    "47"
  ],
  "url": "https://github.com/ubuntu/gnome-shell-extension-appindicator",
  "uuid": "appindicatorsupport@rgcjonas.gmail.com",
  "version": 59
}

Look at line 13, looking for the uuid, it’s appindicatorsupport@rgcjonas.gmail.com.

Step 3: Rename the extracted directory to the uuid that is copied in Step 2.

It’s appindicatorsupport@rgcjonas.gmail.com

Step 4: Copy the renamed directory in Step-3 to ~/.local/share/gnome-shell/extensions.


How to test?

You can go to terminal and type gnome-extensions list.

$ gnome-extensions list

appindicatorsupport@rgcjonas.gmail.com
apps-menu@gnome-shell-extensions.gcampax.github.com
background-logo@fedorahosted.org
launch-new-instance@gnome-shell-extensions.gcampax.github.com
places-menu@gnome-shell-extensions.gcampax.github.com
window-list@gnome-shell-extensions.gcampax.github.com

On the other hand, you can open gnome extensions - https://apps.gnome.org/Extensions/. Your new extension should be there in Manually installed list.

[1] Gnome Extensions
[1] Gnome Extensions