Skip to content

dsheeler/gnome-shell-extensions-gravatar

 
 

Repository files navigation

Gravatar GNOME Shell Extension

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

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 Gravatar

Every time the extension is enabled (for example at login), the extension downloads your user icon from Gravatar. When the email setting is changed, the extension also performs a download.

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

Settings

Settings can be configured from the gnome-shell-extension-prefs tool 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>'"

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

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

*Icon Size: (default: 192)

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

Desktop Notification on Update: (default: false)

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

Bug Reporting

Bugs should be reported via the GitHub Issue Tracker

Logs

Extension
journalctl /usr/bin/gnome-shell -f
Prefs Widget
gnome-shell-extension-prefs gravatar@gnome-shell-extensions.dsheeler.net

Credits

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

License

The MIT License (MIT)

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages

  • JavaScript 92.0%
  • Makefile 8.0%