searxng-cli

Search the web from your terminal.
Shell wrapper for SearXNG with carapace completions

---

Install

Manual (any Linux / macOS)

git clone https://github.com/3dyuval/searxng-cli.git
cd searxng-cli
sudo make install

To customize the prefix:

make install PREFIX=/usr/local DESTDIR=/tmp/staging

Arch Linux (AUR)

cd packaging
makepkg -si

Debian / Ubuntu

cd packaging
dpkg-buildpackage -us -uc
sudo dpkg -i ../searxng-cli_*.deb

Fedora / RHEL

rpmbuild -ba packaging/searxng-cli.spec

Homebrew

brew install --formula packaging/homebrew/searxng-cli.rb

Nix

nix-build packaging/nix/default.nix

Uninstall

sudo make uninstall

Environment Variables

Variable	Default	Description
SEARXNG_URL	http://localhost:8855	SearXNG instance URL
SearXNG Installation SearXNG Search API Public Instances
SEARXNG_CONFIG	/etc/searxng/settings.yml	Fallback for engine completions
Settings Reference Engine Configuration
SEARXNG_DATADIR	/usr/share/searxng-cli	Data directory (yaml spec, script)
carapace-spec

Usage

searxng [flags] QUERY...

Search

searxng 'arch linux wayland'                # open in browser
searxng -o url 'neovim plugins'             # print URL only
searxng -o json 'neovim plugins' | jq       # JSON to jq
searxng -e wikipedia -o url 'type theory'   # engine + URL
searxng -c images -l fr -o url 'paris'      # combined filters

Flag	Standalone (no query)	With query
-o, --output	searxng -o — list formats	searxng -o url 'query' — print URL
		searxng -o json 'query' — fetch JSON
url json html csv rss

Engines & Shortcuts

searxng -e                             # list engines
searxng -e -j | jq '.[:3]'            # engines as JSON
searxng -s                             # list shortcuts
searxng -e google 'query'             # search with engine
searxng -s g -c images 'query'        # shortcut + category

Flag	Standalone (no query)	With query
-e, --engine	searxng -e — list engines	searxng -e google 'query'
	searxng -e -j — as JSON	searxng -e wikipedia -l fr 'query'
-s, --shortcut	searxng -s — list shortcuts	searxng -s g 'query'
	searxng -s -j — as JSON	searxng -s g -c images 'query'

Filtering

searxng -c images 'tiling wm'         # category
searxng -l fr 'paris'                  # language
searxng -p 2 'query'                   # page 2
searxng -c images -l ja -o url 'query' # combined

Flag	Standalone (no query)	With query
-c, --category	searxng -c — list categories	searxng -c images 'query'
	searxng -c -j — as JSON	searxng -c videos -l de 'query'
general images videos news music files it science
-l, --lang	searxng -l — list languages	searxng -l fr 'query'
	searxng -l -j — as JSON	searxng -l ja -o url 'query'
en de fr es it pt nl ru zh ja ko ar ...
-p, --page	—	searxng -p 2 'query'

Modifiers

Flag	Description
-j, --json	JSON output — applies to both listing and search mode
-h, --help	Show help
-v, --version	Print version

Setup

searxng -v                             # show version
export SEARXNG_URL=http://localhost:8855
ln -s /usr/share/searxng-cli/searxng.yaml ~/.config/carapace/specs/searxng.yaml

License

MIT