Gravatar GNOME Shell Extension

A GNOME Shell extension to synchronize your user icon with an avatar service, one of Gravatar or Libravatar.

Prerequisites

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

Installation

Easiest way to install the extension is via extensions.gnome.org, the official Gnome extension platform. Head over there and install with one click by toggling the switch on the site.

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

• git
• glib-compile-schemas
• make
• 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/dsheeler/gnome-shell-extensions-gravatar.git
# enter the local repository directory
cd gnome-shell-extensions-gravatar
# run the build/install toolchain
make

Uninstall

make uninstall

Usage

Triggering a Download from Avatar Service

The extension downloads your avatar in various circumstances.

Starting the Extension

Every time the extension is enabled (for example at login), the extension downloads your user icon from the avatar service.

Settings Changes

When either the email or the service setting changes, the extension also performs a download.

Keyboard Shortcut

The extension provides another option to trigger a download: by pressing a user-defined keybinding. This enables the user to, for example, update their user icon after an update on the avatar service. The prefs widget provides an interface to change the keybinding. The default is <Ctrl><Super>g.

Settings

Settings can be configured from the preferences gui:

gnome-extensions prefs [email protected]

or from the command line via dconf. Settings marked with * can only be changed by using dconf.

Service: (default: gravatar)

dconf write /org/gnome/shell/extensions/gravatar/service "'<SERVICE_NAME>'"

Where <SERVICE_NAME> is one of gravatar or libravatar.

Email Address: (default: null)

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

Download Keybinding: (default: ["<Ctrl><Super>g"])

dconf write /org/gnome/shell/extensions/gravatar/gravatar-ondemand-keybinding '["<KEYBINDING_STRING>"]'

Desktop Notification on Update: (default: false)

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

Debug Mode: (default: false)

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

* 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

Logs

Extension

journalctl /usr/bin/gnome-shell -f

Prefs Widget

journalctl /usr/bin/gjs -f

Credits

This project is a fork of Daniel Demus' fork of the original Gravatar extension by Jon Rouleau.

License

The MIT License (MIT)