Hugo Users Guide

Version 0.1.1 - 0.1.5

Overview:

Sidebar

Bottom view

Control panel closeup:

sidebar:

bottom view:

starting Hugo:

from Tools Menu
adding Toolbar button
keyboard command

The default keyboard command to open Hugo is:

alt-ctrl-H     Windows
alt-cmd-H     Mac

This can be changed in Options/Preferences > Keyboard

resize title and results column by dragging divider (bottom view):

 


 

Search mode selection radio buttons and invert checkbox:

Clicking one of the 4 radio buttons will initiate a search, and at the same time select by which criteria the tabs will be filtered during a search, based on the state of the tab filter checkboxes. (See "Ignore/Select filter checkboxes: below for more details of search filtering):

*see "URL/search engine filters" below

Note that clicking on a radio button that is already selected will still initiate a new search in that mode.

If using FAYT (Find as You Type) search, typing will initiate the search in the mode reflected by the button states.

 


 

Results context:

Set the length of context surrounding the search query terms in the results. The number will be reflected in the button label.

 


 

Progress indicator:

For searches rendering a large number of results, a progress indicator will appear. A "cancel" button is also provided which will cancel the search. Pressing "alt + esc" will also cancel the search.

Searches are limited to returning 5000 results.

 


 

Ignore/Select filter checkboxes:

Hugo provides a system that allows the user to filter tabs in the window that he/she may or may not want to be included in the search. Each tab may be flagged as "ignore", or "select", each one being relevant to the search mode chosen. See "Search mode selection radio buttons and invert checkbox" above for explanation on how filters are applied.

Tab filter checkboxes:

Checking one of the checkboxes in a title entry will flag a tab as "ignore" or "select". Then, when a search is done, the tab will be filtered based on what flags are set, and which search mode is selected.

Ignore and select column markers/buttons:

Note that the "i" and "s" column markers also behave as buttons. Clicking on them will open a popup giving the option to set or clear the respective "i" or "s" flags for all tabs that appear in the current search results, and thus clear the checkboxes in the respective column as well.

Note that this will only set or clear flags for tabs displayed in the current search results. Setting or clearing flags on ALL tabs can be done from the tabs panel:

Tabs panel:

Clicking on the "tabs" button will open a panel displaying all of the tabs in the window. This allows you to set/unset "i" (ignore) and "s" (select) flags on any tab, regardless of whether it is currently appearing in search results or not. Changes made to a tab in this panel will be instantly reflected in the results panel, if the tab is present in the results. If the tab is not currently appearing in the search results, the change will still be reflected if it appears in the results of a later search.

Clicking the "set i" and "set s" buttons in this panel will immediately set the respective flags in all tabs.
Likewise, clicking the "clear i" and "clear s" buttons in this panel will immediately clear the respective flags in all tabs.

Note that you may also change the currently selected tab in the browser window from here, by clicking on the arrow. Browser will then switch to that tab.

There is also the options to have the tabs panel "float", which can be set in Options/Preferences > General. The floating panel can be dragged to any place on the screen and resized, and will remain until explicitly closing it.

Note that in this mode, if All Tabs Helper addon is installed, the floating tabs panel can be made to toggle to the All Tabs Helper panel, by clicking on the "ATH" button. The All Tabs Helper panel will then display a "Hugo" button through which you can return to the Hugo tabs panel.

Tabs bar context menu extension:

User also has the option of setting "i" and "s" filters for an individual tab from the tab's context menu in the tabs bar.

 

Note that all setting/unsetting/clear actions on filters and flags will be immediately synced in all interfaces.

 


 

URL/search engine filters:

User may also apply filters based on the URLs of the pages visible in the tabs:

User may select pre-defined site filters for search...

Or by clicking "exclude user-defined urls"...

...user may define his/her own URL filters. If a tab's URL contains the entered text, it will be excluded. User may enter multiple filters by entering one on each line, up to 30 entries.

Note "exclude" filters are always excluded, regardless of tab flags/search mode.

 


 

Context menu:

Right-clicking anywhere in the Hugo panel (whether in sidebar or bottom view mode) will open the context menu:

"Move panel to bottom/Move panel to sidebar"

Switch between sidebar and bottom view mode.

"Close Panel"

Closes panel, whether in sidebar or bottom view mode. It basically "turns off" Hugo. Hugo can be started again at any time by clicking the "Hugo" button in the findbar. Hugo will then re-open in the last view it was in before closing.

 


 

Preferences:

General

"Enable FAYT (Find as You Type) for Hugo"

If this is checked, "Find as You Type" is enabled and typing into the search box will initiate a search. Without this checked you will have to manually initiate a search using one of the mode radio buttons or the "Hugo" button. Remember that even if a radio button is selected, you may still click on it to initiate a new search in that mode.

If using FAYT for Hugo, you may set the timeout. This is the time between typing strokes which must occur before the search is initiated.

NOTE: This is independent of FAYT for the default use of the Firefox findbar (searching within a page).

"Open tabs panel as floating panel"

Please see "Tabs panel" section above for an explanation.

"Inverted search - find tabs with no matches"

Options controlling the behavior of the "invert" checkbox in control panel, see "Search mode selection radio buttons and invert checkbox" above.

 

Appearance

"Choose background tinting for titles"

You may select the background color tint for titles, independently in sidebar and bottom view. You may also select to have no tinting for either.

 

Query

"Do not match fragment of word"

This corresponds with "Do not match fragment of word" option in context menu. This avoids matches where the search term is part of a larger word, so when searching for "difference", "indifference" won't match.

The options in this pref allow you to define additional characters as word characters.

"Speed Search: No copy needed for selected text from FF"

alt + 9 will automatically paste any copied text on system clipboard into search box and run search.
If "No copy needed for selected text from Firefox" is checked, you only need to select the text and press alt + 9 (can skip copy to clipboard step)

NOTE that "No copy needed for selected text from Firefox" ONLY works on text selected IN Firefox. You will still need to do the copy step for text from external apps. So be aware that this option can be confusing if alternately getting text from Firefox and outside apps.

 

Performance

"Throttle results rendering"

Read pref text for description. For most users with modern computers, this will probably normally be unnecessary.

 

Keyboard

This panel allows you to change the default keyboard shortcuts used by Hugo. If Detect Duplicates is checked, Hugo attempts to display all of the keybindings used in Firefox and other addons in green text for comparison. A warning message will appear if you attempt to change a Hugo keybinding to an already existing one. Only Hugo keybindings may be changed. Hugo bindings will always appear at the top of the list.

There is an option to sort alphabetically. This may or may not be helpful, as without sorting keybindings will tend to appear in an order more relevant to how corresponding commands appear on the graphical interface.

Cmd/Ctrl-F also opens Hugo

This is provided as a convenience to those who wish to open Hugo when opening FindBar.