Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Clone in Desktop Download ZIP
Gmail notification in Menu Bar for Mac
Python
Latest commit 56f4a7f @rcmdnk added unkown exception
Failed to load latest commit information.
.gitignore added .gitignore
LICENSE Initial commit
MenuBarGmail.icns First commit
MenuBarGmail.py added unkown exception
MenuBarGmailMenuBarIcon.png First commit
README.md updated readme
menubargmaillabels.jpg updated README
setup.py First commit
ssl.py added modified ssl.py

README.md

MenuBarGmail

menubargmaillabels.jpg

Gmail notification in Menu Bar for Mac.

Unread messages of Gmail are checked and the number of unread messages is shown in the menu bar.

Default setting checks only Inbox. Multi-label can be set to be checked.

Short information of unread messages are shown in the menu.

New message notification is also available, too.

Installation

With Homebrew Cask, do:

$ brew cask install rcmdnk/rcmdnkcask/menubargmail

Or download the app and install it in /Applications or ~/Applications.

Uninstall

Launch MenuBarGmail, and click Uninstall menu from menu bar icon.

This function will remove

  • $HOME/.menubargmail_oauth
  • $HOME/.menubargmail_settings
  • $HOME/Library/LaunchAgents/menubargmail.plist
  • $HOME/Library/Application Support/MenuBarGmail/
  • MenuBarGmail.app

Usage

When you start MenuBarGmail, an authentication page will be open in a browser. Accept it, then a following icon will appear in the menubar.

MenuBarGmailMenuBarIcon.png

Following menus are available:

  • About: Show information of MenuBarGmail.
  • Account: Current account.
    • Gmail page will be open by clicking this.
  • Check now: Check mails now.
  • Reconnect: Renew account authentication.
    • If you want to change an account, login to other account in default browser, then click Reconnect.
  • Unread messages: Number and details of unread messages.
  • Set checking interval: Set interval to check mails (Default: 60 (sec)).
  • Set labels: Set labels (comma-separated) to be checked (Default: "").
  • Set filter: Set filter for mail search (Defalt: "").
  • Mail notification: Toggle if a notification is shown or not when the new message comes.
  • Start at login: Toggle if starting at login or not.
  • Uninstall: Uninstall MenuBarGmail.
  • Quit: Quit MenuBarGmail.

If both labels and filter are not set (empty), INBOX is checked (this is default).

For filter details, refer: Advanced search - Gmail Help.

Message details (Date, From, Subject, Short summary of message) can be seen as a submenu of Unread message.

If two different labels are set, each label is shown as a submenu then details are shown as a submenu of it.

A pop up window with full details will be shown by clicking these submenus. On the window, Mark as read and Open in browser buttons are availabl.

How to build

Tested at OS X 10.11.1 El Capitan, Python 2.7.10 (installed by Homebrew)。

In OS X 10.11 El Capitan, you may need to install pyobjc packages.

$ pip install pyobjc-core pyobjc-framework-Accounts pyobjc-framework-AddressBook pyobjc-framework-AppleScriptKit pyobjc-framework-AppleScriptObjC pyobjc-framework-Automator pyobjc-framework-CFNetwork pyobjc-framework-CalendarStore pyobjc-framework-Cocoa pyobjc-framework-Collaboration pyobjc-framework-CoreData pyobjc-framework-CoreLocation pyobjc-framework-CoreText pyobjc-framework-CoreWLAN pyobjc-framework-DictionaryServices pyobjc-framework-DiskArbitration pyobjc-framework-EventKit pyobjc-framework-ExceptionHandling pyobjc-framework-FSEvents pyobjc-framework-InputMethodKit pyobjc-framework-InstallerPlugins pyobjc-framework-InstantMessage pyobjc-framework-LatentSemanticMapping pyobjc-framework-LaunchServices pyobjc-framework-OpenDirectory pyobjc-framework-PreferencePanes pyobjc-framework-PubSub pyobjc-framework-QTKit pyobjc-framework-Quartz pyobjc-framework-ScreenSaver pyobjc-framework-ScriptingBridge pyobjc-framework-SearchKit pyobjc-framework-ServiceManagement pyobjc-framework-Social pyobjc-framework-StoreKit pyobjc-framework-SyncServices pyobjc-framework-SystemConfiguration pyobjc-framework-WebKit
  • Build

    $ python setup.py py2app

then, MenuBarGmail.app will appear in ./dist directory.

Something went wrong with that request. Please try again.