#ACL All:read
<<Include(hacks/gmailUnlabelled/NavBar)>>
<!>	This script is now [[http://jaidev.info/archives/2013/05/10/retiring-gmailunlabelled.html|obsolete]].
= gmailUnlabelled =
[[hacks/gmailUnlabelled|{{http://jaidev.info/content/wp-content/gallery/misc/gmail-unlabelled.png|gmailUnlabelled in Action}}]]
[[hacks/gmailUnlabelled|gmailUnlabelled]] is a [[https://addons.mozilla.org/firefox/addon/748|greasemonkey]] script for gmail that creates a special label -- '''Unlabelled''' to search for all the conversations without a real label.


= Source Code =
Download the latest version [[http://jaidev.info/home/hacks/gmailUnlabelled2.user.js|here]]. The source is released under GPL v2 and a full revision history is available [[http://jaidev.info/git/?p=gm-scripts.git;f=gmailUnlabelled2.user.js;a=history|here]]. You can watch for changes by subscribing to the [[http://jaidev.info/git/?p=gm-scripts.git;f=gmailUnlabelled2.user.js;a=rss|RSS feed]]. [[http://jaidev.info/git/?p=gm-scripts.git;f=gmailUnlabelled2.user.js;a=rss|{{attachment:feed.png|Project Changes RSS}}]]
== Installation Instructions for Firefox ==
 * Install the [[https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/|greasemonkey]] extension and restart firefox.
 * [[http://jaidev.info/home/hacks/gmailUnlabelled2.user.js|Click here]] to obtain the latest version of gmailUnlabelled. Greasemonkey should prompt you for confirmation to install the script.
 * Refresh gmail. You should see a new link just above "edit labels". You can also type "'''-label'''" in the gmail search box.
== [NEW] Installation Instructions for Google Chrome or Chromium ==
 * These browsers directly support userscripts. [[http://jaidev.info/home/hacks/gmailUnlabelled2.user.js|Click here]] to obtain the latest version of gmailUnlabelled. Your browser should prompt you for confirmation to install the script.
 * Refresh gmail. You should see a new link just above "edit labels". You can also type "'''-label'''" in the gmail search box.
== [NEW] Installation Instructions for Safari on Mac OSX ==
 * Install SIMBL and !GreaseKit.
 * Restart Safari.
 * [[http://jaidev.info/home/hacks/gmailUnlabelled2.user.js|Click here]] to obtain the latest version of gmailUnlabelled. !GreaseKit should prompt you for confirmation to install the script.
 * Refresh gmail and search away!
= Known Issues =
 * The search may throw up 'conversations' with a label. This indicates that '''at least one''' 'individual email' in the conversation does not have a label. For instance, emails sent or received in a conversation '''after''' you added the original label to the conversation are not tagged with that label automatically. The gmail display can be misleading in this scenario. This is typically seen the first time you use !gmailUnlabelled.
 * If you have too many labels, the search string gets too long and gmail complains with an '''error 600''' or '''Oops… the system encountered a problem (#6400)'''.
 * If you've tweaked with the layout of the gmail pages, it may not work. For example:
  * If labels are moved from their original position, for instance to the right side.
  * If labels are collapsed.
 * For the older version of gmail, use the [[http://jaidev.info/git/?p=gm-scripts.git;a=blob_plain;f=gmailUnlabelled.user.js|earlier script]] ([[http://jaidev.info/git/?p=gm-scripts.git;f=gmailUnlabelled.user.js;a=history|history]]). This version is not maintained anymore.
= Contact =
Feel free to [[contact]] me if you have any suggestions or bug reports. If you'd like a more useful response, please include the following information: 
 * What is the gmail account type - regular personal gmail account vs google apps account?
 * Does any other user-script work for you? 
 * What are the version numbers of the following - OS, Browser, Greasemonkey (if applicable) and !gmailUnlabelled
 * What steps did you follow in installing !gmailUnlabelled and greasemonkey (if applicable)
 * If the script ever worked, when did it stop working?