Skip to content

Latest commit

 

History

History
97 lines (55 loc) · 3.91 KB

README.md

File metadata and controls

97 lines (55 loc) · 3.91 KB
Raw

Helper for GitHub notifications in Gmail

A browser extension for Chrome, Firefox(broken), and Safari that adds keyboard shortcuts to the Gmail interface for GitHub notification emails.

Features

Mail View Shortcut

Open your GitHub notifications in mail view:

  • Chrome/Firefox: shift + g, shift + b in the background
  • Safari: ctrl + g, ctrl + b in the background

Mail view button

List View Shortcut

ctrl + return to trigger one the action button when an email is selected using gmail key navigation (when the blue bar appears):

action button in list view

Mute Thread

Mute thread in mail view. It will open a background window to load the mute thread URL, and close itself when done. This only works if you have an active GitHub session.

  • Chrome/Firefox: shift + h
  • Safari: ctrl + h

Mute thread button

Installation

The easy way

Chrome: Install the extension via Chrome webstore
Firefox: Install the addon via Firefox addons gallery
Safari: N/A I have not signed up for Apple Developer Program

The manual way

Chrome

  1. Go to Releases and download the latest version and unzip it.
  2. Go to Chrome extensions page (chrome://extensions/) and load the folder as an Unpacked extension.

Firefox

muan#70

Safari

  1. Go to Releases and download the latest version and unzip it.
  2. Preferences > Advanced > Show Develop menu in menu bar
  3. Develop > Show Extension Builder > + > Add Extension > Choose the folder > Run

Settings

  1. Custom domains
  2. Mail view: open thread shortcut
  3. Mail view: open thread in background shortcut
  4. Mail view: mute thread shortcut

Custom Domains (for GitHub Enterprise)

If you are using GitHub Enterprise and have a custom domain, you can set it in the extension options page.

domain option

Mail View Shortcut

Customize the keyboard shortcut that triggers the View on GitHub button. Change the shortcut combination by focusing the input, and press whatever key(s) you want to be the shortcut. It will be displayed in keyCode which is why you see 71 here instead of g. Don't worry about it.

To open and focus the new window right away (shift + g):

image

To open a new window in the background (shift + b) – Chrome only:

image

To mute a thread in the background (shift + h) – Chrome only:

image

Development

Load the extension manually and modify the code accordingly in these places:

Chrome: chrome/src/inject/inject.js.
Firefox: firefox/data/index.js.
Safari: safari/github-gmail-safariextension/main.js

The End

Love it? Tell me!

Found a bug? Open an issue.