Documente Academic
Documente Profesional
Documente Cultură
Version 1.0.2.7
CONTENTS
1. INTRODUCTION ............................................................................................................................. 4
Contents
© Hulbee AG, 2009
Page 3 of 48
4.2 Copyrights ...................................................................................................................................................... 46
Contents
© Hulbee AG, 2009
Page 4 of 48
1. INTRODUCTION
The main purpose of Hulbee Desktop is to simplify a full text search on local computer,
even without using a keyboard. Hulbee Desktop supports both plain text and the majority of the
most popular formats including archives, Outlook messages with attachments and even audio
files (extracting textual data from tags only).
Formats supported:
Microsoft Word (97-2007),
Microsoft Outlook (2003-2007),
PDF format (.pdf),
Open Office (.odp, .odt, .sxw),
.rtf, .htm, .xml;
Archives (.rar, .zip)
Audio formats (.mp3, .ogg, .wma, .flac and others). Only textual tags of audio files are
indexed.
Hulbee Desktop can search in different languages. English, German, Dutch and Spanish
are included in the base package. Using intelligent technologies Hulbee Desktop can recognize
all word forms for the supported languages. For example: if search query includes word “light”
then the search results may contain texts with such words as “lights”, “lighted”, “lighting” etc.
However, some features are not yet implemented in the current version of Hulbee Desk-
top. These are some technical improvements that will be realized in later versions:
Ability to define monitored areas for Hulbee Desktop Indexer (local files and
folders, hidden and system files and folders, net drives, removable media, etc.);
Wider languages range support.
Later versions of Hulbee Desktop also will include additional intelligent features:
Data cloud clusterization;
Search results classification, etc.
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 5 of 48
2.1.2 INSTALLATION
Hulbee Desktop can be installed on the computer providing it has the necessary pro-
grams and meets the system requirements (listed in 2.1.1 subsection).
Hulbee Desktop installation is performed by a special installer: HulbeeDesk-
top_X.X.X.X_Install.exe. Where X.X.X.X is version of Hulbee Desktop. For example installer
file may be named as HulbeeDesktop_1.0.2.22_Install.exe.
HulbeeDesktop_X.X.X.X_Install.exe file should be started to begin Hulbee Desktop in-
stallation.
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 6 of 48
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 7 of 48
6. Read the license text (fig. 2.2 marker 1) in the license agreement dialog
(fig. 2.2);
1 – License text; 2 – I accept the terms of the license agreement checkbox; 3 – Yes button.
Figure 2.2 License agreement dialog
7. Check I accept the terms of the license agreement (fig. 2.2 marker 2)
to accept the terms of the license agreement in order to continue installa-
tion;
8. Click Yes button (fig. 2.2 marker 3);
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 8 of 48
9. Click Next button (fig. 2.3 marker 3) in Destination directory dialog (fig.
2.3);
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 9 of 48
10. If .Net Framework 3.5 SP1 has not been installed on the computer, the in-
staller will offer to install .Net Framework 3.5 SP1 (fig. 2.4). To download
.Net Framework 3.5 SP1 from the Internet and install it in automatic mode
(recommended action) Click Next button (fig. 2.4 marker 2).
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 10 of 48
1 – Restart Microsoft Outlook option; 2 – Index Microsoft Outlook later option; 3 – Next
button.
Figure 2.5 Warning dialog
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 11 of 48
13. Click Install button (fig. 2.6 marker 1) in the summary dialog;
14. The Hulbee Desktop files will be copied on to the computer;
1 – Install button.
Figure 2.6 Summary dialog
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 12 of 48
15. Wait until the all files are copied (the process may take several minutes).
When the files are copied, the installation completion dialog will be
shown (fig. 2.7);
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 13 of 48
18. If Hulbee search was integrated to internet browsers then notification win-
dow (fig. 2.8) will appear.
19. Click OK button (fig. 2.8 marker 1) in the notification window (fig. 2.8);
1 – OK button.
Figure 2.8 Notification window
20. If Hulbee Gadget checkbox (fig. 2.7 marker 2) was checked then Hulbee
Gadget installation dialog (fig. 2.9) will appear. To continue installation
of Hulbee Gadget (described in 3.2.8 subsection) click Install button (fig.
2.9 marker 1);
1 – Install button.
Figure 2.9 Hulbee Gadget installation dialog
If any errors occurred during the installation process, subsection 2.1.4 should be reviewed
for solution. If the problem won‟t be solved, it is recommended to communicate with the support
service for solving such situations (section 4.3).
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 14 of 48
2.1.3 REMOVING
There are two ways to remove Hulbee Desktop from the computer:
1. With the help of Control panel.
2. With the help of the shortcut in the Start menu.
Depending on which operating system (Windows XP or Windows Vista) is installed on
the computer, Hulbee Desktop removal may be started differently.
Instruction 2.2 Removing Hulbee Desktop with the help of the control panel
To remove Hulbee Desktop with the help of the control panel in Windows Vista:
Instruction 2.3 Removing Hulbee Desktop with the help of the shortcut
To remove Hulbee Desktop with the help of the shortcut in Windows Vista:
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 15 of 48
once more. If the error occurs again, it is recommended to communicate with the support service
(section 4.3).
The following errors may appear during the installation process:
The User Account Control window (fig. 2.10) may appear on the installation (or
deinstallation) launching.
1 – Allow command.
Figure 2.10 User Account Control window
Solution: Allow command (fig. 2.10 marker 1) should be selected to continue in-
stallation.
The following error message may appear during .Net Framework 3.5 SP1 installa-
tion process:
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 16 of 48
should be installed on the computer to eliminate this error. To get rid of the prob-
lem next actions is recommended:
o Reboot computer and try to install Hulbee Desktop again;
o Check Internet connection. If Internet connection works correctly try to in-
stall .Net Framework 3.5 SP1 manually using next link:
http://www.microsoft.com/downloads/details.aspx?familyid=AB99342F-
5D1A-413D-8319-81DA479AB0D7&displaylang=en;
o If Internet connection is unavailable install .Net Framework 3.5 SP1 from
other sources.
After .Net Framework 3.5 SP1 is successfully installed try to install Hulbee
Desktop again.
Instruction 2.5 Starting Hulbee Desktop in Windows Vista (by Hulbee Desktop
Indexer icon)
To start Hulbee Desktop:
1. Double click Hulbee Desktop Indexer icon in the notification zone (fig.
3.9);
2. Hulbee Desktop should start and main window (fig. 3.1) should be dis-
played.
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 17 of 48
Instruction 2.6 Starting Hulbee Desktop in Windows Vista (by desktop shortcut)
To start Hulbee Desktop:
1. Double click Hulbee Desktop shortcut on the windows desktop;
2. Hulbee Desktop should start and main window (fig. 3.1) should be dis-
played.
Instruction 2.7 Starting Hulbee Desktop in Windows Vista (by Start menu)
To start Hulbee Desktop:
Additionally, there is a way to shutdown Hulbee Desktop Indexer using Hulbee Desk-
top Indexer context menu (fig. 3.10).
Fehler! Verwenden Sie die Registerkarte 'Start', um Заголовок 1 dem Text zuzuweisen, der hier angezeigt
werden soll.
© Grossbay AG, 2009
Page 18 of 48
Hulbee Desktop and Hulbee Gadget are the user interface modules. These modules de-
veloped to interact with user, they receive user queries and process software responses to form
search results. Search results can be represented in different forms, as:
Search results list (fig. 3.1 marker 6);
Hulbee Desktop Data cloud (fig. 3.1 marker 8);
Hulbee Gadget Data cloud (fig. 3.15 marker 3).
Hulbee Desktop Indexer is a very important part of Hulbee Desktop software solution.
This module is used to find and collect textual data from defined locations. In current version of
Hulbee Desktop there is fixed list of locations for Hulbee Desktop Indexer to process (only
normal files and folders on local computer). It is planned to add feature that will allow user to
define locations for Hulbee Desktop Indexer to be monitored (local files and folders, hidden
and system files and folders, net drives, removable media, etc.)
Hulbee Desktop Indexer watches over the computer content and traces all changes (new
content added, some files moved or deleted). That is why Hulbee Desktop Indexer is so impor-
tant; it allows Hulbee Desktop to know about current files on a computer. However, usually it
takes some time to process newly added files.
When Hulbee Desktop Indexer processes textual data from files, it saves important data
in special index data base. Index data base allows to find files very quickly. Current version of
Hulbee Desktop can extract data from various sources. Not only the names of files and folders,
document files texts, archives and mail messages but even tags of audio files can be processed by
Hulbee Desktop to extract information (see list of formats supported in the 1.1.1 subsection).
Using this advanced techniques Hulbee Desktop has the power to find:
Files by file (or folder) names;
Documents by contained text;
Mail messages by message text or by attached files text or file name;
Audio files by tags (author, genre, album, etc.)
1 – Search panel; 2 – Hulbee.com button; 3 – New search button; 4 – Main menu; 5 – Hulbe
links; 6 – Search results list; 7 – Filter panel; 8 – Data cloud.
Figure 3.1 Hulbee Desktop main window interface
Options menu. Contains Language menu (fig. 3.4) used to change of interface
language;
1 – Sort order button; 2 – Sort by list; 3 – File name; 4 – Brief snippet; 5 – Full path.
Figure 3.6 Search results list
Available items for each filter depend on results from Search results list (fig. 3.1 marker
6). In other words if search results contain documents only in English and German then Lan-
guage filter (fig. 3.7 marker 1) will contain next items: All, English, Deutsch. Same is for Type
filter (fig. 3.7 marker 2), it will show only types of files found.
Usually filters are used after the search is performed to minimize number of results
showed in Search results list (fig. Figure 3.1 marker 6).
There is a feature that allows to select multiple filter
items (for example English and Deutsch in Language fil-
ter ). To do so:
1. Press and hold control (Ctrl) key on keyboard;
2. Click on desired filter items;
3. Release control (Ctrl) key.
During search process Data cloud (fig. 3.1 marker 8) is updated to correspond with
Search string (fig. 3.5 marker 3) and computer content. Any changes of Search string will
reflect on Data cloud and vice versa.
Data cloud contains characteristic words from computer content, concerning query
words the most. Data cloud words can come from different sources, like file or directory names,
documents texts, tags etc. (see section 3.1 and list of formats supported in the 1.1.1 subsection).
In other words Data cloud presents terms related with query terms by computer content.
In contrast to Search string, Data cloud visually presents possible ways of making a query, i.e.
offers possible variants in an easy and understandable form.
Adding or excluding query words with the Data cloud is a matter of mouse click.
Hulbee Desktop Indexer is designed for automated computer content indexing and mon-
itoring. Hulbee Desktop Indexer is important part of Hulbee Desktop software solution. It is
recommended to keep Hulbee Desktop Indexer in active mode for proper Hulbee Desktop
functioning. Anyway Hulbee Desktop Indexer can be paused or turned off using Hulbee Desk-
top Indexer context menu (fig. 3.10).
In current version of Hulbee Desktop only local files and folders are monitored by Hul-
bee Desktop Indexer. None of hidden, system files and folders, net drives or removable media
is indexed.
Hulbee Desktop Indexer has several modes:
Active mode
This is a normal Hulbee Desktop Indexer mode when it monitors computer con-
tent. To pause Hulbee Desktop Indexer command “Pause” from Hulbee Desk-
top Indexer context menu should be selected (see fig. 3.10).
Paused mode
In this mode Hulbee Desktop Indexer can‟t monitor computer content. To switch
to active mode command “Resume” from Hulbee Desktop Indexer context
menu should be selected (see fig. 3.10).
Hulbee Desktop Indexer context menu can be called by right button click on Hulbee
Desktop Indexer icon in the notification zone.
Hulbee Desktop Indexer status window (fig. 3.11) can be displayed by using Show Sta-
tus command from Hulbee Desktop Indexer context menu (fig. 3.10). Hulbee Desktop In-
dexer status window contains information on current tasks of Hulbee Desktop Indexer. Moni-
tored path string (fig. 3.11 marker 1) show current folder being indexed. When Hulbee Desk-
top Indexer processes files Status information field (fig. 3.11 marker 2) displays “Learning
…” and keywords from files processed (fig. 3.11). During processing of some files keywords
will not be displayed.
After all files processed Status information field will show “Learning … Finished” (fig.
3.12).
By using Pause/Resume button (fig. 3.11 marker 3, fig. 3.12 marker 3) Hulbee Desk-
top Indexer can be switched between Active and Pause modes.
When Hulbee Desktop Indexer is in Pause mode Status information field will show
“Learning … paused” and Hulbee Desktop Indexer status window will look like fig. 3.13.
! Click on New search button will clear not only Search string (fig.
3.5 marker 3), but also Search results list (fig. 3.1 marker 6) and Da-
ta cloud (fig. 3.8).
! Click on New search button will clear not only Search string (fig.
3.5 marker 3), but also Search results list (fig. 3.1 marker 6) and Da-
ta cloud (fig. 3.8).
If search results do not contain desired files for specific query, it is recommended to ad-
dress subsection 3.3.4.
Query clarification should be repeated by adding and excluding words until the items of
interest will be found. If the query clarification does not give the desired results, this means that
there are no such files on computer.
! Click on New search button will clear not only Search string (fig.
3.5 marker 3), but also Search results list (fig. 3.1 marker 6) and Da-
ta cloud (fig. 3.8).
If search results do not contain desired files for specific query, it is recommended to ad-
dress subsection 3.3.4.
Instruction 3.4 Clarifying search query with Data cloud by adding the word
To add the word to search query with Data cloud:
1. Select the word in Data cloud (fig. 3.8) which concerns search goal the
most;
2. Click the selected word;
3. The word will be added to the query and highlighted correspondingly.
Instruction 3.5 Clarifying search query with Data cloud by excluding the word
To exclude the word from search query with Data cloud:
1. Select the word in Data cloud (fig. 3.8) to exclude. The query must con-
tain that word (word highlighted correspondingly);
2. Point the cursor at the selected word. Strikethrough line should appear on
that word;
By default Hulbee Gadget is docked in sidebar panel (fig. 3.14). But as any gadget it can
be moved to desktop easily (instr. 3.8). To close Hulbee Gadget follow instr. 3.9.
Instruction 3.8 Moving Hulbee Gadget
To move Hulbee Gadget:
1. Point cursor at Gadget manipulation string (fig. 3.15 marker 4);
2. Drag „n drop Hulbee Gadget to desired position on desktop (or in Side-
bar panel).
Like any gadget Hulbee Gadget can be removed from Sidebar panel or uninstalled. If
Hulbee Gadget was removed from Sidebar panel it can be returned using The Gadget Gallery.
To know more about how to handle with gadgets see following links:
http://windowshelp.microsoft.com/Windows/en-US/Help/88e2f098-c570-4b36-959a-
3c449dee43ab1033.mspx;
http://support.microsoft.com/kb/944239.
Not as a problem, rather a small issue: usually, then search query words are added or ex-
cluded it makes the Search results list (fig. 3.1 marker 6) to refresh with changed content. But
there is one exception for that rule. When search query contains exact name of some file, adding
of words that is similar to the names of directories that build up file path for that file will not
change content of the Search results list (fig. 3.1 marker 6). Similar situation may occur when
some words (similar to the names of directories that build up file path) are excluded from the
search query with exact file name.
1 – Yes button.
Figure 3.19 Integration question window
To get better understanding of how to search with Hulbee Desktop see example in 3.4.4
subsection.
2. Clarify query by adding “Hulbee” word from Data cloud (fig. 3.8). Hulbee Desktop
main window will look like fig. 3.21.
3. Clarify query again by adding “Document” word from Data cloud (fig. 3.8). Hulbee
Desktop main window will look like fig. 3.22.
4. Now the query is accurate enough and search target document is displayed in the Search
results list (fig. 3.22). Double click document (in the Search results list) to open it.
Wildcard Searches
Hulbee Desktop supports single and multiple character wildcard searches within single
terms (not within phrase queries).
To perform a single character wildcard search use the "?" symbol.
To perform a multiple character wildcard search use the "*" symbol.
The single character wildcard search looks for terms that match that with the single char-
acter replaced. For example, to search for "text" or "test" next search query can be used:
te?t
Multiple character wildcard searches looks for 0 or more characters. For example, to
search for test, tests or tester, next search query can be used:
test*
Also wildcard symbols can be used in the middle of a term:
te*t
A * or ? symbol cannot be used as the first character of a
search.
AND
The AND operator matches documents where both terms exist anywhere in the text of a
single document. This is equivalent to an intersection using sets. The symbol && can be used in
place of the word AND.
To search for documents that contain "Grossbay hulbee" and "Hulbee Desktop" use the
query:
"Grossbay hulbee" AND "Hulbee Desktop"
+
The "+" or required operator requires that the term after the "+" symbol exist somewhere
in a field of a single document.
To search for documents that must contain "Grossbay" and may contain "desktop" use the
query:
+Grossbay desktop
NOT
The NOT operator excludes documents that contain the term after NOT. This is equiva-
lent to a difference using sets. The symbol ! can be used in place of the word NOT.
To search for documents that contain "Grossbay hulbee" but not "Hulbee Desktop" use
the query:
"Grossbay hulbee" NOT "Hulbee Desktop"
The NOT operator cannot be used with just one term. For
example, the following search will return no results:
NOT "Grossbay hulbee"
-
The "-" or prohibit operator excludes documents that contain the term after the "-" sym-
bol.
To search for documents that contain "Grossbay hulbee" but not "Hulbee Desktop" use
the query:
"Grossbay hulbee" -"Hulbee Desktop"
Grouping
Hulbee Desktop supports using parentheses to group clauses to form sub queries. This
can be very useful because it allows to control the boolean logic for a query.
To search for either "Grossbay" or "hulbee" and "website" use the query:
(Grossbay OR hulbee) AND website
This eliminates any confusion and ensures that website must exist and either term Gross-
bay or hulbee may exist.
Field Grouping
Hulbee Desktop supports using parentheses to group multiple clauses to a single field.
To search for a document, by file name or path that contains both the word "return" and
the phrase "pink panther" use the query:
4.1 License
Please read all of the following conditions thoroughly before you install the program. Us-
ing, transferring or installing this copy of Hulbee Desktop Software constitutes your acceptance
of the conditions of this license agreement, unless you have entered into a different written con-
tract with Grossbay AG.
If you do not agree with any of the terms of this agreement, you must not install, use or
transfer this copy of Hulbee Desktop Software. If you purchased Hulbee Desktop from Gross-
bay AG or one of its authorized distributors, you may obtain a refund by returning the unused
copy plus receipt to the seller within fifteen (15) days of the date of purchase. You acknowledge
that you obtained this Hulbee Desktop license directly from Grossbay AG.
LICENSE GRANT
This copy of Hulbee Software may either be installed on one or more workstations for
the sole and exclusive use of one person, or installed on a single workstation used non-
simultaneously by several persons, but not both. Installation on more than one computer for si-
multaneous use by several persons is prohibited.
You may install this copy of Hulbee Desktop Software in a network only if you have ob-
tained a license for every workstation that accesses the software via the network. If, for example,
eight (8) workstations in a network can access the Hulbee Desktop Software, then each worksta-
tion requires a separate Hulbee Desktop license, regardless of whether access occurs simulta-
neously.
Grossbay AG expressly prohibits the use of Hulbee Desktop Software in applications or
systems in which a malfunction of this software could lead to bodily injury or death. Use of the
program in such an environment is at one's own risk. Grossbay AG and its licensers disclaim
responsibility for any loss or damage incurred as a consequence of such unauthorized use.
WARRANTY
Warranty shall only apply to claims for malfunction made within six (6) months of pur-
chase of the Hulbee Desktop license. Obvious defects in the software must be reported within a
week of noticing them. Grossbay AG, at its own discretion, can either replace or refund defective
software. You may request a refund of the purchase price if Grossbay AG fails to provide a re-
placement.
LIABILITY
Grossbay AG and their licensers shall accept liability only for deliberate and gross negli-
gence; however, in the case where basic contractual obligations have been breached they shall be
liable for any culpable conduct on behalf of their employees.
Grossbay AG and its licensers shall not be liable for any direct or consequential damages,
in particular for loss of profits, except when these damages are caused deliberately by their em-
ployees or either deliberately or through gross negligence by authorized representatives or ex-
ecutives.
PLACE OF JURISDICTION
Inasmuch as you are a sole trader according to German Commercial Code, all disagree-
ments in connection with this license agreement shall be settled in the court of Frankfurt/Main.
GOVERNING LAW
This agreement shall be interpreted exclusively in accordance with German law. The ap-
plication of the convention for the international sale of goods (CISG) is expressly excluded.
This agreement represents the entire contract between both parties, and supersedes all
prior arrangements, purchase contracts and agreements, except when you have made a different
written agreement with Grossbay AG.
All rights to the Hulbee software, not explicitly authorized in this agreement, remain ex-
clusively with Grossbay AG and its licensers. You are not authorized to lend, rent, modify, trans-
late, attempt to decipher, decompile, disassemble or use the software program as a basis for your
own software. You are not authorized to provide the Hulbee Desktop software to a third party
that operates in conjunction with a DP service provider, application service provider or similar
company, or to any company that provides compression, decompression or conversion services
to third parties. You are not authorized to consign any rights that you may have under this li-
cense agreement to a third party.
4.2 Copyrights
Microsoft Windows, Office, Word, Excel, Outlook and PowerPoint are trademarks or
registered trademarks of Microsoft Inc.
Intel and Pentium are registered trademarks of Intel Corp.
Other product and company names herein may be trademarks of their respective owners.
4.3 Support
Please, visit our portal http://www.hulbee.com or http://www.grossbay.com to get sup-
port.