What is the "Badge Counter for Gmail" extension and how does it work?

This extension can be used to get notified of the number of unread emails in multiple Gmail accounts in the simple mode. Left-click on the toolbar button opens the most recent thread (assuming you have multiple threads). This can be configured from the options page to open the search query or the account itself. The extension can be configured to search for more complex search queries as well. Note that if you have several queries, clicking on the toolbar button, open the most recent thread belongs to one of the queries. This extension is capable of performing searches in all user logged-in accounts. Note that Google increments the account number when a new one is logged-in. For instance the first account has "/mail/u/0/" in the URL, however, the second account has "/mail/u/1/" in the URL. To perform a new search for the second account add "a:1" to the search query. For instance to search for all unread email in the inbox folder of the second account use "is:unread label:inbox a:1". Note that all the operators except the "a" one are the ones that Google Mail understands.

What are the known search operators?

• from: this is used to limit search queries to emails that their sender contains this string.
• to: this is used to limit search queries to emails that their recipient contains this string.
• subject: this is to limit search queries to emails that their subject line contains this string.
• OR: this operator is used to extend search queries to match multiple terms
• -: this operator makes sure the results will not have this string in their subject line or email body.
• label: this operator limits search results to the ones that have this label (tag).
• has:drive: limits messages that have a Google Drive attachment
• has:document: limits messages that have a Google Drive document
• has:spreadsheet: limits messages that have a Google SpreadSheet document
• has:presentation: limits messages that have a Google presentation document
• has:youtube: limits messages that have a YouTube link in them
• list: limit search queries to the ones that are from this particular mailing list
• filename: limit search queries to the ones that have at least one attachment with a filename containing this string
• ( ): this operator is used to group multiple search terms together
• in:anywhere: use this operator to extend your search to include messages in both Spam and Trash folders as well
• is:important: use this operator to limit search queries to the ones that Gmail has already marked them as important emails
• is:starred: limits the search queries to the starred emails. You can limit more by appending color specific operators like "has:yellow-star", "has:blue-info"
• is:unread: limits the search queries to the unread emails
• is:read: limits the search queries to the read emails
• cc: limit search queries to the recipients in "CC" field containing this string
• bcc: limit search queries to the recipients in "BCC" field containing this string
• after, before, older, newer: Use these operators to limit search queries to a specified time period (Example after:2004/01/01 AND before:2018/01/01).
• category: limit search queries to one or more categories like category:updates
• size or larger: limit search queries to the messages larger than a certain size in bytes
• smaller: limit search queries to the messages smaller than a certain size in bytes
• +: use this operator before a word to make sure the exact word is in either body or subject line of all search queries
• has:userlabels and has:nouserlabels: these operators limit messages to the ones that either have or not have at least one user-specified labels.

How can I ask "Badge Counter for Gmail" to perform a search on a non-primary account?

Use the non-standard "a:account_number" operator in your search queries. To find the account number, open the account in a browser tab and check the address bar URL for the account number. It appears as "/mail/u/0/". Note that the primary account always has "0" account number.

What's new in this version?

Please check the Logs section.

What does happen if I click on the toolbar button?

Left click on the toolbar button open a new Gmail account or updates an already opened Gmail account. There is an option on the options page to ask the extension to open a new tab or update an existing one. The new tab can be in one of the following formats:

• Query mode: this will open the query in a browser tab
• Thread: this will open the most recent thread that matches with one of your specified queries in a browser tab. Note that since the thread is loading when you have “is:unread” operator, the counter will decrement by one.
• Account: this will oprn the Google Mail account that has the most recent thread matching one of the queries

Note: You can edit the pattern of these URLs from the options page

What is the interval for performing a new search? Can force the extension to perform a search right away

The default search interval is 15 minutes. Use the options page to change the number (Minimum acceptable value is 2 minutes). Use the right-clicked item in the toolbar button to force a new check