Skip to content

JSSatchell/HyperSearch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

HyperSearch

Instant internet search, minus the distractions.

In video editor language: It's FX Console/Excalibur for the internet.

Now fully updated to AHK v2

GUIDE CONTENTS


OVERVIEW

Preview:

image

HyperSearch is a minimalist bookmark managing utility that focuses on speed and distraction-free access to what you're searching for.

It provides customizable hotkeys for searching any highlighted text as well as a search bar that can search both the internet and your personal index of link categories.

HyperSearch Lite is a streamlined version of the searchbar and favorites without the bookmark manager.

Preview:

image

HyperSearch Lite is built into HyperSearch and can be activated by typing Set>Min

Set>Min

^ TOP ^


GENERAL USAGE

Open the GUI with Win+Space or search any highlighted text with Ctrl+Win+Space. (These hotkeys can be reconfigured to user preference.)

Close the GUI with Escape or Close Window from the X menu.

The app will stay open in the system tray unless closed from the tray or via Exit App from the X menu.

When the app is launched for the first time it will create HS_Settings.ini and HSR_Master.csv sidecar files. If the .exe is moved the .ini and .csv files must stay in the same root folder as the .exe or the settings will be reset. Do not rename these files or new ones will be created the next time the app is launched and the app will be reset to it's default configuration.

^ TOP ^


NAVIGATION

Navigate the favorites menu easily with Alt+1 - 9 or Alt+X for the exit menu.

Type in the search bar and press enter to search the internet via your default search engine (see changing the default search engine below)

Type a Space at the beginning of your search to search the index on the left instead

_Category Name

If the search starts with a Space, pressing Enter will set the focus to the links window below the search bar. Pressing Enter again will activate the highlighted link.

Type a # followed by a number to highlight the link in the specified position.

#10

Alt+A and Alt+D will also toggle between the two listboxes, skipping the search bar.

If one of the listboxes is active, Alt+W and Alt+S will toggle the slection up and down, respectively.

If the search bar is active, Alt + S will activate the links window and start cycling down through the links.

Also with the search bar active, Alt + Q will clear all of the current text so a new search can be started more quickly.

^ TOP ^


ADDING & REMOVING CATEGORIES & LINKS

To add a category, type the category name and +

Category Name+

To add a link to the current category, type + followed the name of the link followed by + followed by the URL. New links without a specified position will be added to the top of the links list

+GMail+mail.google.com

Note: Link names should not contain the characters [ ] ( ) or |

To add a link at a specific position, type + followed by the position number followed by + followed by the link name followed by + followed by the URL

+1+Calendar+calendar.google.com

To add a link at the bottom of the links list, substitute v for the position value

+v+GDrive+drive.google.com

To move a link to a new position, type the starting position of the link, followed by ~ and the new positon of the link

1~5

To move a range of links to a new position, type the first position of the range followed by - and the last number of the range, followed by ~ and the new starting positon of the link range

1-3~5

To remove the current link, type Delete- and select Yes on the prompt

Delete-

To remove a link at a specific position, type Delete- followed by the position number and select Yes on the prompt

Delete-1

To remove a sequential range of links, type Delete- followed by the first number of the range, then - and the last number of the range

Delete-1-5

To remove the current category, type Delete- followed by Category and select Yes on the prompt

Delete-Category

^ TOP ^


EDITING CATEGORY NAMES, LINK LABELS, AND URLs

To rename the current category, type the new category name followed by ++

New Category Name++

To relabel the current link, type + followed by the new label followed by +

+New Link Label

To relabel a link at a specific position, precede the command with + and the desired position #

+1+New Link Label

To reassign the URL of the current link, type ++ followed by the new URL

++New URL

To reassign a URL of a link at a specific position, precede the command with + and the desired position #

+1++New URL

^ TOP ^


CROSSLINKING

To have a link activate a specific category in the index, encapsulate the exact text of the desired category with <...> and set the link URL to *

+1+<Category Label>+*

^ TOP ^


UPDATE FAVORITES

To update favorites, type a number 1 - 9 and then > followed by your desired label name then > followed by the link URL. For example:

1>GMail>mail.google.com

To clear a selection, type the number of the favorite followed by only >

1>

To set a new label for a favorite, simply omit the last >

1>GMail

To set a new link for an existing favorite without updating the label, use >>

1>>drive.google.com

^ TOP ^


LOAD & IMPORT

To load a repository other than the default HSR_Master.csv file, type Load> followed by the pathname of a .csv file that is formatted consistently with HyperSearch. If the file is in the same folder as the HyperSearch executable, only the filename need be typed.

Load>C:\Users\username\Documents\HyperSearch\Repositories\MyCustomRepository.csv

To import bookmarks from Google Chrome, type Import> followed by the pathname of a .html file that has been generated by the "Export Bookmarks" function of Google Chrome. If the file is in the same folder as the HyperSearch executable, only the filename need be typed (with .html extension and case-sensitive spelling).

Import>C:\Users\username\Documents\HyperSearch\Imports\bookmarks_m_d_yyyy.html

NOTE: When importing from Chrome you will have the option to add the bookmarks to the exisiting repository or replace the existing repository with the bookmarks. If you choose to replace the existing repository all links will be permanently deleted. It is recommended to make a copy of the existing repository before choosing to replace it.

To import a HyperSearch category or full HyperSearch repository, type Import> followed by the pathname of a .csv file that is formatted consistently with HyperSearch. If the file is in the same folder as the HyperSearch executable, only the filename need be typed (with .csv extension and case-sensitive spelling).

Import>C:\Users\username\Documents\HyperSearch\Imports\SharedLinks.csv

When importing a .csv, all links will be added to the current repository.

NOTE: When adding new categories via .csv if any imported category has the same name as an existing category, the links from the new category will not be visible. To get around this, rename the exisiting category before or after the import and the new category and its corresponding links will be revealed.

To create a new repository with the default categories, type New> followed by the desired filename or path of the new repository.

New>HSR_New.csv

NOTE: If the new filename is the same as a file in the specified folder, the existing file will be loaded. If no filename is provided, the default name "HSR_Master.csv" will be used. If "HSR_Master.csv" already exists, it will be loaded.

^ TOP ^


EXPORT

To export the active category or full repository in a more accessible CSV file of hyperlinks, type Export> followed by either Category or Repository

Export>Repository

To export the current category in a way that can be read and imported by the HyperSearch import function listed above, add >HyperSearch

Export>Category>HyperSearch

A new .csv file with the name of either the current repository or the active category will be created in the same folder as the HyperSearch executable.

^ TOP ^


UPDATE THE SETTINGS

Begin the search with Set>

To update the search engine, type Search> and then either Google, Bing, or DuckDuckGo. DuckDuckGo is currently the default.

Set>Search>Google

To edit the hotkeys, type Hotkey1/2> followed by your desired hotkey

For reference: Hotkey1 opens the GUI, Hotkey2 searches for highlighted text

Set>Hotkey1>ctrl+space

To turn on/off window jumping, type Jump>On/Off

Set>Jump>Off

To set the interface to the more streamlined one of HyperSearch Lite, type Min

Set>Min

To return to the full HyperSearch interface, type Max

Set>Max

To set the color mode, type either Dark or Light. Dark is the default

Set>Light

To set the opacity, type Opacity> and enter a number between 1 - 100. Default is 90%

Set>Opacity>80

^ TOP ^