Skip to content

Latest commit

 

History

History
85 lines (65 loc) · 2.67 KB

README.md

File metadata and controls

85 lines (65 loc) · 2.67 KB
Raw

Gravatar GNOME Shell Extension

Build Status Dependency Status

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)

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 [email protected]

License

The MIT License (MIT)