warp

About

warp is Google Chrome extension for rapid jump to required bookmark.

You can take a look at list of questions and problems that I faced during development.

Motivation

It's a bit strange, but I did not found Google Chrome extension that can do something like "Ctrl+P" in VS Code or "Ctrl+T" in Slack. OK, I just will make it by my own.

UPD: There are few competitors, but all of them (that I have tested) have a bit different features, restrictions and main goal. warp will evolve further.

Requirements

Developed and tested on Version 115.0.5790.170 (Official Build) (64-bit)

Installation

Chrome Web Store

Just go here and click "Add to Chrome"

From sources

1. Clone repo git clone https://github.com/vikian050194/warp.git
2. Create and activate Python virtual environment
3. Install dependencies pip install -r requirements.txt and run python mdConverter.py
4. Open Chrome and navigate here
5. Enable Developer mode via toggle
6. Load unpacked and select src directory of the cloned repo

Usage

1. Activate extension
2. Find required bookmark via typing plus up and down arrows
3. Press Enter to override current tab or Shift+Enter to open new tab

Configuration

Extension has few options.

You can setup your own shortcut for activation, but default one is Alt+W or Command+W.

Bookmarks

Name	Description
Use custom directory	Enable to be more specific (custom directory is in use) or disable for unlimited search (whole "Bookmarks bar")
Custom directory	Directory with bookmarks to search for. Name should be unique!

History

Name	Description
Maximum count of history items	All history items (starting from the oldest) that are above this threshold by count will be automatically deleted
Expiration time of history items	All history items that are older than this threshold will be automatically deleted

Search

Name	Description
Case sensitivity	Search algorithms work taking into account (or not) case sensitivity
Starts with	Search algorithms use "starts with" for sub-searching is enabled, otherwise "contains" is used
Split search	Split searching algorithm
Abbreviation search	Abbreviation searching algorithm

Results

Name	Description
Results per page	Results per page in the popup
Results sorting	Results sorting order
Results looping	Looping on attempt to move out of list boundaries

Appearance

Name	Description
Font size	Popup font size in pixels
Selected item color	Color of selected item in results list
Selected item font weight	Font weight of selected item in results list
Arrow pointer	Arrow appears in front of selected item

Tabs

Name	Description
Additional action	Press additional "Shift" (in other words "Shift+Enter") to open new tab if enabled and to update current tab if disabled
Keep group	Open new tab in the current group if it exists and additionaly press "Ctrl" to get opposite behaviour
Keep neighbour	Open new tab next to active one

Autoclosing

Name	Description
Autoclose enabled	Is popup autoclose enabled
Autoclose time	Popup autoclose time in seconds

Changelog

Name	Description
Show on update	If enabled then changelog page will be shown automatically on extension version update

Tests

Packages

• mocha is used for unit testing and c8 for coverage
• playwright is used for e2e testing

How to run

• npm test - run unit tests
• npm run cover - run code coverage
• npm run test:ui - run e2e tests