A simple program to search the searx search engine through dmenu or rofi, sort through the results and open the selected URL in you prefered web browser. Works with almost any Searx instance and you can change which one to use easily.
The program requires jq, a JSON processor, to work.
The program requires either dmenu or rofi to work.
If you wish to receive error notifications at anywhere but the terminal, see Notifier
under Config
on how to set a notification program.
The program does not have a set Searx instance, check in Searx Instance
under Config
below to see how to set one.
The default browser is set to surf, so see Browser
under Config
on how to change that. Make sure to pick an instance that will not severley rate limit you and you also want to pick an instance that will not block the program, it will notify you if you have. See Instance Report
to have some help picking one.
The entire script exists within menusearx
, open it up to start configuring things.
Uncomment the line under # assign menu prorgram
relating to your preferred menu application, or add your own.
If you wish to change the colour of your menu program, that can be accomplished by appending whatever flags are needed to the menu
variable.
To receive error notifcations at the desktop, as is highly reccomended, you can change the notifier
variable to the notification program. In many cases, it is notify-send
that is used.
You can set a Searx instance by changing the instance
variable to the instance's domain name.
You can set a Searx instance by changing the browser
variable to the instance's domain name.
If you do not wish to have temporary files be stored under /tmp/menusearx
, you can change this directory by changing the cachedir
variable to the desired directory.
Many large public instances will have systems in place that will block the program. If you host your own instance, you should have no problem using that, otherwise, here are some suggestions of large instances. (This is not an endorsement, just a list of compatible instances)
Confirmed working public instances:
- https://searx.bbaovanc.com/
- https://search.stinpriza.org/
- https://searx.decatec.de/
- https://search.mdosch.de/
- https://dynabyte.ca/
- https://zoek.anchel.nl/
- https://searx.rasp.fr/
- https://search.bluelock.org/
- https://searx.pwoss.org/
- https://search.disroot.org/
- https://searx.sunless.cloud/
- https://search.snopyta.org/