README.md

searchlauncher

Search multiple websites at once using your default browser.

The search (launcher) can be triggered from anywhere as it's listening for a global keypress.

Installation

pip install searchlauncher

Requirements

Python >=3.10 with tkinter installed.

Running in background

searchlauncher

to start as a daemon waiting for a configurable keypress (e.g., Ctrl + Shift + E).

Then type your query and press Enter to submit or Esc to close the window.

This will open the search for each website in a new tab.

Searching different website groups can be triggered with different hotkeys.

Searching from console

Instead of running in background, you can use the CLI run a one-off search.

To open a search for all configured websites:

searchlauncher search "an item I'm looking for"

You can also select a custom search group:

searchlauncher search "and now for something completely different" -g en

Settings and supported websites

To open the config file location, you can run

searchlauncher config

after installing.

See the available default websites and groups.

You can easily modify this file to add and modify target websites as well as their groups.

You can also customise the default shortcut hotkey as well as shortcuts for all groups.

TODO

• CLI to search for a single item
• GUI (popup on hotkey)
• Configurability
  • Customise the hotkey(s)
  • Customise search sites
  • Customisable search groups
  • Add and select different browsers

Development

Setup

1. Install poetry and cd to this folder.

2. poetry install

3. poetry run pre-commit install