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

!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
!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 Commands

Syntax is :command where command is a YubNub command. List of YubNub commands is available at yubnub.org. While using this command, the dollar character ($) can be used to represent the URL of the current page.
Examples -

: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

*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 in Chrome and the Options panel in Firefox to customize gleeBox. You can customize the appearance (size, location, theme), shortcut key, switch features on and off, change the default search engine and lots more.

Advanced customizations include custom ?scraper commands and ESP mode. 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. If you use a jQuery selector on several pages, create a custom ?scraper command for it instead of typing the entire selector out every time.

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)" />

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