User Manual

The Three Stages of Keyboard Glee

Known issues:
Behavior might be unpredictable on pages that define their own keyboard shortcuts.
gleeBox won't search inside IFrames of a page.
Some bookmarklets don't work well as !commands.

1. The Basics

General keys

• g
  Launch gleeBox (If you're focussed on an input field, press Alt+g (Option+g on Mac))
• .
  Launch tab manager (In input fields, Alt+.). This feature is only in Chrome.
• Tab
  Move to the next selected element
• Shift + Tab
  Move to the previous selected element
• Enter
  Launch a link or execute a command
• Shift + Enter
  Launch a link in a new tab
• Esc
  Close gleeBox/Tab manager

Default behavior

When you enter any text, gleeBox will search for links on the current page whose text matches your query. If it finds any links, it will highlight them and you can scroll through them by pressing the TAB key. You can open a particular link by pressing ENTER.

In case gleeBox doesn't find any links, when you press ENTER, it will either search the text on a search engine, or if you enter a string matching a URL, gleeBox will take you to that page.

Tab Manager (only in Chrome)

This will be a list of the currently open tabs. You can start typing to filter through them. Move through them using TAB or Arrow Keys. Choose one and press ENTER to go to that tab. You can close a tab by selecting it and pressing c or Backspace.

2. Commands

?Scraper Commands

Scraper commands let you select particular types of elements on the page. You can navigate the selected elements via the TAB key.

• ?h
  Select main (h1, h2 & h3) headings
• ?img
  Select linked images
• ??
  Select text input fields. Hit ENTER to give focus to the selected field.
• ?a
  Select all links
You can define custom scraper commands in the Options page.

!Page Commands

These commands are used to take some action on the current page. Type in the command and press ENTER to execute.

• !read
  Transform the page for a better reading experience using the Readability project
• !shorten
  Shorten the URL of the current page using bit.ly
• !tweet
  Redirect to twitter.com with the URL of the current page in the text field
• !rss
  Open the current page's RSS feed in Google Reader
• !share
  Share the current page.
  Syntax: !share service
  Valid services are m(ail), g(mail), t(witter), fb/facebook, deli(cious), su/stumbleupon, (google)buzz, (google)reader and all of the over 200 service codes listed on the AddThis services directory.
• !help
  Open the manual (i.e. this page)
• !tipjar
  Open the TipJar
• !options
  Open the options page
• !inspect
  Syntax: !inspect text
  Search for link containing text and return the jQuery selector for it
• !v
  Play/Pause videos on YouTube
• !ext
  Open the Extensions page in Chrome
• !down
  Open the Downloads page in Chrome
• !plugins
  Open the Plugins page in Chrome
• !snap
  Take a screenshot of the current page in Chrome
• !set
  Set gleeBox Options
  Syntax: !set option = value

  Option
  theme
  position
  size
  scroll
  bsearch
  vision
  

  Valid values
  { default, white, console, greener, ruby, glee }
{ top, mid(dle), bottom }
{ large, med(ium), small }
{ on, off }
{ on, off }
jQuery selector to set as vision for current page
  

  
  Syntax: !set option += value

  Option
  scrapers
  visions
  

  Value
  name : selector
url : selector
  
• !<Any Text>
  Execute Matching Bookmarklet
  You can also save bookmarklets and then execute them as a page command. For example, if you bookmark the Instapaper bookmarklet and rename its title to "later", you can then run it by typing in "!later" in gleeBox and pressing ENTER.

:YubNub/Quix Commands

Syntax is :command where command is either a YubNub or a Quix command. By default, it is set to Yubnub.
YubNub commands are listed here and a list of Quix commands is available here. With Quix, you can also create your own set of commands. See an example.

While using this command, the dollar character ($) can be used to represent the URL of the current page.

Examples of Yubnub commands -

• :fbshare $
  Share the current page on Facebook
• :wp cricket
  Search Wikipedia for cricket
• :tube elvis
  Search YouTube for elvis
• :site2pdf $
  Get a PDF for the current page
• :tw gleebox
  Search Twitter for gleebox

ESP Visions

ESP mode lets you define default jQuery selectors for specific pages, so that you can just hit 'g' on the page to select the elements you always select. A combination of URL and jQuery selector for the ESP mode is called a 'vision'. Sorry, but we couldn't resist the nomenclature. We've included two 'visions' for Google and Bing search result pages, roll your own for your favorite websites or find ones created by other users on TipJar.

You can also define an ESP vision for your site using the <meta> tag so that when a user opens gleeBox on your site, it is automatically executed.

For example, here is the meta tag we're using for TipJar:

<meta name="gleebox-default-selector" content="li>h2>a, a:contains(Previous), a:contains(Next)" />

*jQuery Commands

Syntax is *selector where selector is a jQuery selector. Hitting ENTER will navigate across all elements that match the jQuery selector specified.
Examples -

• *a
  All Links
• *h3,h4,h5
  h3, h4 and h5 headers
• *textarea
  Textareas in the page
• **
  Do not try this at home

3. Customizations

Use the Options page to customize gleeBox. You can customize the appearance (size, theme), shortcut key, switch features on and off, change the default search engine and lots more.

Finally, don't forget to check the TipJar for finding and sharing tips, commands, bookmarklets, undocumented features and more.