Internet search based on selected text
Project description
SelSearch - Internet search based on selected text
SelSearch graps text selected in any application and opens a web browser to search for.
By default, it will search on Google, but you can custimize your search to, for example, look for a DeepL translation of your text (as in the demo below).
Installation
SelSearch can be installed using pip
:
pip install selsearch
SelSearch best works with XSel, a program that grabs current selection using X. If XSel is not available on your system, SelSearch will use the clipboard to grab current selection.
Live Demo
The demo hereunder shows how you can select text, Linux, in a terminal, search for it in Google. Then, search for an English to French translation of some text on DeepL.
Usage
The most basic usage of SelSearch is the following:
selsearch
Optionally, you can specify the place where text is gonna be searched on:
selsearch -w DeepL
You can obtain a list of search urls with:
selsearch -l
Recommended Usage
However, SelSearch is best used when set as a keyboard shortcut. For example, in the demo, selsearch
is mapped to <ctrl>+<m>
and selsearch -w DeepL
to <ctrl>+<n>
. How to set up keyboard shortcuts depends on your platform.
Customize
Other functionnalities can be listed with:
selsearch --help
If you desire to change the default search url, or set a custom one, you can set to environment variable SELSEARCH_DEFAULT_SEARCH_URL
to any key listed by selsearch -l
or any url.
Example in ~/.bashrc
:
export SELSEARCH_DEFAULT_SEARCH_URL="https://translate.google.be/?text="
Future Features
Here are a list of future features that I would like to add to SelSearch:
- App Icon
- Installation that defaults to launch on startup
- Ability to customize keyboard shortcuts
- GUI so customize app
- Use of a config folder (instead of environ variable?)
- ...
Contributing
Feel free to contribute or propose ideas using the Issues and Pull requests tabs.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for selsearch-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 02d22bd98b13fa4a2039d90377279bae4f9d1288a79725e263409366614d46ae |
|
MD5 | 821a4cd40ed4373af1bdf18812320a7f |
|
BLAKE2b-256 | e9965b0d2cbbec88c5a67de177d10fe0a5270dab1d2eef9a70894949fe94faf4 |