gnome-extensions-cli 0.1.0

Command line tool to manage your Gnome Shell extensions

gnome-extensions-cli

Install, update and manage your Gnome Shell extensions from your terminal

Features

• You can install any extension available on Gnome website
• Automatically select the compatible version to install for your Gnome Shell
• Automatic Gnome Shell restart if needed
• Simple update command to keep your extensions up-to-date
• You can also uninstall, enable and disable extensions
• Handles extensions installed on the system (with apt install) to automatically update them

Install

Install from PyPI

$ pip3 install --user gnome-extensions-cli

Install latest version from the repository

$ pip3 install --user git+https://github.com/essembeh/gnome-extensions-cli

Or setup a development environment

$ git clone https://github.com/essembeh/gnome-extensions-cli
$ cd gnome-extensions-cli
$ make venv
$ source venv/bin/activate
(venv) $ pip install -e .

Using

List your extensions

$ gnome-extensions-cli list
Installed extensions:
[X] [e-mail]  (v37)
[X] [e-mail]  (v25)

# Also include system extensions
$ gnome-extensions-cli list --all
Installed extensions:
[ ] [e-mail]
[X] [e-mail]  (v37)
[X] [e-mail]  (v25)

# Use verbose to see available updates
$ gnome-extensions-cli list -a -v
Installed extensions:
[ ] [e-mail]
      available version: 37
[X] [e-mail]  (v37)
[X] [e-mail]  (v25)

Note: the first [X] or [ ] indicates if the extension is enabled or not

You also have a search command to print informations from Gnome extensions website

$ gnome-extensions-cli search 570
Todo.txt: [e-mail]
    url: https://extensions.gnome.org/extension/570
    tag: 8141
    recommended version: 25
    installed version: 25
    available versions:
      version 30 for Gnome Shell 3.36
      version 29 for Gnome Shell 3.34
      version 28 for Gnome Shell 3.32
      version 25 for Gnome Shell 3.28
      version 25 for Gnome Shell 3.26
      version 25 for Gnome Shell 3.24
      version 25 for Gnome Shell 3.22
      version 25 for Gnome Shell 3.20
      version 25 for Gnome Shell 3.18
      version 25 for Gnome Shell 3.16
      version 25 for Gnome Shell 3.14
      version 25 for Gnome Shell 3.12
      version 25 for Gnome Shell 3.10
      version 21 for Gnome Shell 3.8
      version 21 for Gnome Shell 3.6
      version 21 for Gnome Shell 3.4

Install, uninstall and update

# Install extension by its UUID
$ gnome-extensions-cli install [e-mail]
Install Dash to Panel version 37 from https://extensions.gnome.org/download-extension/[e-mail]?version_tag=16231

# or use its package number from https://extensions.gnome.org
$ gnome-extensions-cli install 1160
Install Dash to Panel version 37 from https://extensions.gnome.org/download-extension/[e-mail]?version_tag=16231
Restarting Gnome Shell ...

# You can also install multiple extensions
$ gnome-extensions-cli install 1160 570
Install Dash to Panel version 37 from https://extensions.gnome.org/download-extension/[e-mail]?version_tag=16231
Install Todo.txt version 25 from https://extensions.gnome.org/download-extension/[e-mail]?version_tag=8141
Restarting Gnome Shell ...

# Uninstall extensions
$ gnome-extensions-cli uninstall [e-mail]                     
Uninstall [e-mail] from /home/seb/.local/share/gnome-shell/extensions/[e-mail]
Disable [e-mail]
Restarting Gnome Shell ...

# You can enable and disable extensions
$ gnome-extensions-cli disable [e-mail]
Disable [e-mail]
Restarting Gnome Shell ...
$ gnome-extensions-cli enable [e-mail] 
Enable [e-mail]
Restarting Gnome Shell ...

The update command by default updates only the enabled extensions, use --all/-a to also update disabled extensions

# Update all enabled extensions
$ gnome-extensions-cli update
Extension [e-mail] is up-to-date
Update [e-mail] from 21 to 25

# Update only given extensions
$ gnome-extensions-cli update [e-mail] is up-to-date
Extension [e-mail] is up-to-date