Gravatar GNOME Shell Extension

A GNOME Shell extension to synchronize your user icon with Gravatar.

Prerequisites

• gnome-shell
• dconf (optional)
• gnome-tweaks (optional)
• gnome-shell-extension-prefs (optional)

Installation

If you wish to build and install the extension manually, you will need the following tools:

• git
• npm - Node Package Manager
• node - Node.js (>= 8.0.0)
• glib-compile-schemas
• dconf (optional)

The packages which include the above tools may vary between different GNU/Linux distributions. Check your distribution's documentation / package list to find the most suitable packages.

# clone the repository
git clone https://github.com/jrouleau/gnome-shell-extensions-gravatar.git
# enter the local repository directory
cd gnome-shell-extensions-gravatar
# install the local build dependencies
npm install
# run the build/install toolchain
npm run install-extension

Uninstall

npm run uninstall-extension

Settings

Settings can be configured from the gnome-tweaks or gnome-shell-extension-prefs tools or from the command line via dconf. Settings marked with * can only be changed by using dconf.

*Debug Mode: (default: false)

dconf write /org/gnome/shell/extensions/gravatar/debug "'<BOOL>'"

Email Address: (default: null)

dconf write /org/gnome/shell/extensions/gravatar/email "'<EMAIL>'"

*Icon Size: (default: 192)

• 1 - 2048 pixel square (See: gravatar.com)

dconf write /org/gnome/shell/extensions/gravatar/icon-size <SIZE>

Bug Reporting

Bugs should be reported via the GitHub Issue Tracker

Development

You can run the extension in development mode with npm run dev. This will install the extension as a symlink to your development build dir and automatically rebuild when source files are changed.

To reload the extension you must reload GNOME with Alt + F2, r, [ENTER].

Logs

Extension

journalctl /usr/bin/gnome-shell -f

Prefs Widget

gnome-shell-extension-prefs gravatar@gnome-shell-extensions.rouleau.io

License

The MIT License (MIT)