tabswitcher/README.md

# Tabswiper

The musthave extension for a mouse-free Firefox experience.
Switch between tabs and manage them with a fuzzy search and basic command toolset.

## How to Use It

1. Open the search page using the extension icon or by pressing `F2`.
  You can customize the keyboard shortcut by accessing the `Manage Extension Shortcuts` in Firefox settings.

1. Filter the list of open tabs with the searchbox.

1. Switch to the top tab in search results with the `Enter` key, choose any other tab with arrow keys or press the `Tab` key to activate the actionbox.

1. Press the Esc key to activate the search field or close the page if the search field is focused.

## Availible Commands

To invoke any of the commands, enter the command symbol and tab label, if
required, in the actionbox. For example: `fjk`, `dlum` or `S`.

- `f`: Navigate to the labeled tab.
- `F`: Jump to the first tab in search results.
- `d`: close (**delete**) the labeled tab.
- `D`: Close the first search results tab.
- `c`: Copy (or **clone**) the labeled tab.
- `C`: Duplicate the first search results tab.
- `s`: **Suspend** the labeled tab.
- `S`: Suspend all search results tabs.
- `p`: **Pin** or unpin the labeled tab.
- `e`: Move (**extract**) the tab to a popup window.
- `q`: **Quit** the search page.
- `?`: Navigate to this page.

## Keyboard Shortcut Conflict

If the default `F2` key does not work, check for conflicts on the "Manage Extension Shortcuts" page in the drop-down menu with "Gear" icon on the "Manage Your Extensions" page (`Ctrl + Shift + A`).

## Development

### Adding an Unpacked Extension to Firefox

1. In the Firefox address bar, type `about:debugging` and press Enter.

1. Click on `This Firefox`, then select `Load Temporary Add-on...`.

1. Choose the `manifest.json` file.

### Build the Package

To generate the XPI file, just use the `make package` command.
The output file will be stored in the `dist` directory.