How to manually install a Gnome Shell extension

This is a must-know for those who love some old extensions that are no longer compatible with their new upgrade of gnome shell, since many extensions are already compatible with the new versions of the gnome-shell, but all what differs is that this is not explicitly stated in the meta-data file.

My system is on Ubuntu 13.04 beta with Gnome 3.8.

Here are the steps:

  1. Get the exact version of your gnome-shell, “gnome-shell –version”, mine is
  2. Download the 2 files of any extension, extension.js and metadata.json, or simply copy their text into new empty files that you create (with the same name of course)
  3. In the .json file, go to the shell-version section and your version that you got into step 1, e.g.: “shell-version”: [
         “3.2”, “3.5.2”, “3.8.0”, “3.8”, “”
  4. From the same file, you will find a uuid section, you will use that name to create a folder with the same name, e.g. folder name would be in this example: “uuid”: “”
  5. Copy the two files into that folder
  6. Copy that folder into “~/.local/share/gnome-shell/extensions
  7. Restart your shell, you can do that by pressing Alt+F2 then typing r and pressing enter
  8. Go to your gnome-tweak tool and activate that new extension by setting to on or activate it through the web interface
  9. Enjoy!

About SoCRaT

Systems Engineer, OSS & Linux Geek
This entry was posted in Uncategorized and tagged , , , , , . Bookmark the permalink.

6 Responses to How to manually install a Gnome Shell extension

  1. PePa says:

    How do you do step 2, is there a place you can find the files??


  2. Pingback: How to manually install a Gnome Shell extension | Story Time in Oz

  3. rgriggs1 says:

    Thank you, I have looked all over for this solution. Works great


  4. Perry Linda says:

    .uoy knahT .rof gnikool saw i rewsna ehT .nam eht era uoY


  5. Worked perfectly even if my Gnome version 3.26 was not listed (3.20 was).
    Thank you!


  6. In step 3, what does, “and your version that you got into step 1, e.g.: “shell-version”: [
    “3.2”, “3.5.2”, “3.8.0”, “3.8”, “”
    ],” even mean?


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s