Icycoide/searxng
1
0
Fork 1
mirror of https://github.com/searxng/searxng.git synced 2025-08-09 21:36:44 +02:00
Code Issues Projects Releases Packages Wiki Activity

[doc] build from commit f32e91e51a

Browse source
This commit is contained in:
return42 2025-07-28 13:38:00 +00:00
commit 2aed3e5c5c
425 changed files with 96733 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

195
user/about.html Normal file
View file

@ -0,0 +1,195 @@
<!DOCTYPE html>
<html lang="en" data-content_root="../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>About SearXNG &#8212; SearXNG Documentation (2025.7.28+f32e91e51)</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=6625fa76" />
<link rel="stylesheet" type="text/css" href="../_static/searxng.css?v=52e4ff28" />
<script src="../_static/documentation_options.js?v=6c28674e"></script>
<script src="../_static/doctools.js?v=9a2dae69"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script data-project="searxng" data-version="2025.7.28+f32e91e51" src="../_static/describe_version.js?v=fa7f30d0"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Why use a private instance?" href="../own-instance.html" />
<link rel="prev" title="Configured Engines" href="configured_engines.html" />
</head><body>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="../own-instance.html" title="Why use a private instance?"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="configured_engines.html" title="Configured Engines"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">SearXNG Documentation (2025.7.28+f32e91e51)</a> &#187;</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">User information</a> &#187;</li>
<li class="nav-item nav-item-this"><a href="">About SearXNG</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="about-searxng">
<span id="about-searxng"></span><h1>About SearXNG<a class="headerlink" href="#about-searxng" title="Link to this heading"></a></h1>
<p>SearXNG is a <a class="reference external" href="https://en.wikipedia.org/wiki/Metasearch_engine">metasearch engine</a>, aggregating the results of other
<code class="docutils literal notranslate"><span class="pre">search</span> <span class="pre">engines</span></code> while not storing information about
its users.</p>
<p>The SearXNG project is driven by an open community. Come join us on Matrix if
you have questions or just want to chat about SearXNG at <a class="reference external" href="https://matrix.to/#/#searxng:matrix.org">#searxng:matrix.org</a></p>
<p>Make SearXNG better:</p>
<ul class="simple">
<li><p>You can improve SearXNG translations at <a class="reference external" href="https://translate.codeberg.org/projects/searxng/">Weblate</a>, or…</p></li>
<li><p>Track development, send contributions, and report issues at <a class="reference external" href="https://github.com/searxng/searxng">SearXNG sources</a>.</p></li>
<li><p>To get further information, visit SearXNG’s project documentation at <a class="reference external" href="https://docs.searxng.org/">SearXNG
docs</a>.</p></li>
</ul>
<section id="why-use-it">
<h2>Why use it?<a class="headerlink" href="#why-use-it" title="Link to this heading"></a></h2>
<ul class="simple">
<li><p>SearXNG may not offer you as personalized results as Google, but it doesn’t
generate a profile about you.</p></li>
<li><p>SearXNG doesn’t care about what you search for, never shares anything with a
third-party, and can’t be used to compromise you.</p></li>
<li><p>SearXNG is free software; the code is 100% open, and everyone is welcome to
make it better.</p></li>
</ul>
<p>If you do care about privacy, want to be a conscious user, or otherwise believe
in digital freedom, make SearXNG your default search engine or run it on your
own server!</p>
</section>
<section id="how-do-i-set-it-as-the-default-search-engine">
<h2>How do I set it as the default search engine?<a class="headerlink" href="#how-do-i-set-it-as-the-default-search-engine" title="Link to this heading"></a></h2>
<p>SearXNG supports <a class="reference external" href="https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md">OpenSearch</a>. For more information on changing your default
search engine, see your browser’s documentation:</p>
<ul class="simple">
<li><p><a class="reference external" href="https://support.mozilla.org/en-US/kb/add-or-remove-search-engine-firefox">Firefox</a></p></li>
<li><p><a class="reference external" href="https://support.microsoft.com/en-us/help/4028574/microsoft-edge-change-the-default-search-engine">Microsoft Edge</a> - Behind the link, you will also find some useful instructions
for Chrome and Safari.</p></li>
<li><p><a class="reference external" href="https://www.chromium.org/tab-to-search">Chromium</a>-based browsers only add websites that the user navigates to without
a path.</p></li>
</ul>
<p>When adding a search engine, there must be no duplicates with the same name. If
you encounter a problem where you cannot add the search engine, you can either:</p>
<ul class="simple">
<li><p>Remove the duplicate (default name: SearXNG) or</p></li>
<li><p>Contact the owner to give the instance a different name from the default.</p></li>
</ul>
</section>
<section id="how-does-it-work">
<h2>How does it work?<a class="headerlink" href="#how-does-it-work" title="Link to this heading"></a></h2>
<p>SearXNG is a fork of the well-known <a class="reference external" href="https://github.com/searx/searx">searx</a> <a class="reference external" href="https://en.wikipedia.org/wiki/Metasearch_engine">metasearch engine</a> which was
inspired by the <a class="reference external" href="https://beniz.github.io/seeks/">Seeks project</a>. It provides basic privacy by mixing your
queries with searches on other platforms without storing search data. SearXNG
can be added to your browser’s search bar; moreover, it can be set as the
default search engine.</p>
<p>The <code class="docutils literal notranslate"><span class="pre">stats</span> <span class="pre">page</span></code> contains some useful anonymous usage
statistics about the engines used.</p>
</section>
<section id="how-can-i-make-it-my-own">
<h2>How can I make it my own?<a class="headerlink" href="#how-can-i-make-it-my-own" title="Link to this heading"></a></h2>
<p>SearXNG appreciates your concern regarding logs, so take the code from the
<a class="reference external" href="https://github.com/searxng/searxng">SearXNG sources</a> and run it yourself!</p>
<p>Add your instance to this <a class="reference external" href="https://searx.space">list of public
instances</a> to help other people
reclaim their privacy and make the internet freer. The more decentralized the
internet is, the more freedom we have!</p>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<span id="sidebar-top"></span>
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/searxng-wordmark.svg" alt="Logo of SearXNG"/>
</a></p>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="index.html">User information</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="search-syntax.html">Search syntax</a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html">Configured Engines</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">About SearXNG</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#why-use-it">Why use it?</a></li>
<li class="toctree-l3"><a class="reference internal" href="#how-do-i-set-it-as-the-default-search-engine">How do I set it as the default search engine?</a></li>
<li class="toctree-l3"><a class="reference internal" href="#how-does-it-work">How does it work?</a></li>
<li class="toctree-l3"><a class="reference internal" href="#how-can-i-make-it-my-own">How can I make it my own?</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../own-instance.html">Why use a private instance?</a></li>
<li class="toctree-l1"><a class="reference internal" href="../admin/index.html">Administrator documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev/index.html">Developer documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../utils/index.html">DevOps tooling box</a></li>
<li class="toctree-l1"><a class="reference internal" href="../src/index.html">Source-Code</a></li>
</ul>
<h3>Project Links</h3>
<ul>
<li><a href="https://github.com/searxng/searxng/tree/master">Source</a>
<li><a href="https://github.com/searxng/searxng/wiki">Wiki</a>
<li><a href="https://searx.space">Public instances</a>
<li><a href="https://github.com/searxng/searxng/issues">Issue Tracker</a>
</ul><h3>Navigation</h3>
<ul>
<li><a href="../index.html">Overview</a>
<ul>
<li><a href="index.html">User information</a>
<ul>
<li>Previous: <a href="configured_engines.html" title="previous chapter">Configured Engines</a>
<li>Next: <a href="../own-instance.html" title="next chapter">Why use a private instance?</a></ul>
</li>
</ul>
</li>
</ul>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user/about.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright SearXNG team.
</div>
</body>
</html>

3720
user/configured_engines.html Normal file
View file

File diff suppressed because it is too large Load diff

154
user/index.html Normal file
View file

@ -0,0 +1,154 @@
<!DOCTYPE html>
<html lang="en" data-content_root="../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>User information &#8212; SearXNG Documentation (2025.7.28+f32e91e51)</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=6625fa76" />
<link rel="stylesheet" type="text/css" href="../_static/searxng.css?v=52e4ff28" />
<script src="../_static/documentation_options.js?v=6c28674e"></script>
<script src="../_static/doctools.js?v=9a2dae69"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script data-project="searxng" data-version="2025.7.28+f32e91e51" src="../_static/describe_version.js?v=fa7f30d0"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Search syntax" href="search-syntax.html" />
<link rel="prev" title="Welcome to SearXNG" href="../index.html" />
</head><body>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="search-syntax.html" title="Search syntax"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="../index.html" title="Welcome to SearXNG"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">SearXNG Documentation (2025.7.28+f32e91e51)</a> &#187;</li>
<li class="nav-item nav-item-this"><a href="">User information</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="user-information">
<h1>User information<a class="headerlink" href="#user-information" title="Link to this heading"></a></h1>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="search-syntax.html">Search syntax</a><ul>
<li class="toctree-l2"><a class="reference internal" href="search-syntax.html#select-engine-and-category"><code class="docutils literal notranslate"><span class="pre">!</span></code> Select engine and category</a></li>
<li class="toctree-l2"><a class="reference internal" href="search-syntax.html#select-language"><code class="docutils literal notranslate"><span class="pre">:</span></code> Select language</a></li>
<li class="toctree-l2"><a class="reference internal" href="search-syntax.html#bang-external-bangs"><code class="docutils literal notranslate"><span class="pre">!!&lt;bang&gt;</span></code> External bangs</a></li>
<li class="toctree-l2"><a class="reference internal" href="search-syntax.html#automatic-redirect"><code class="docutils literal notranslate"><span class="pre">!!</span></code> automatic redirect</a></li>
<li class="toctree-l2"><a class="reference internal" href="search-syntax.html#special-queries">Special Queries</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="configured_engines.html">Configured Engines</a><ul>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-general">tab <code class="docutils literal notranslate"><span class="pre">!general</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-images">tab <code class="docutils literal notranslate"><span class="pre">!images</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-videos">tab <code class="docutils literal notranslate"><span class="pre">!videos</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-news">tab <code class="docutils literal notranslate"><span class="pre">!news</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-map">tab <code class="docutils literal notranslate"><span class="pre">!map</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-music">tab <code class="docutils literal notranslate"><span class="pre">!music</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-it">tab <code class="docutils literal notranslate"><span class="pre">!it</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-science">tab <code class="docutils literal notranslate"><span class="pre">!science</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-files">tab <code class="docutils literal notranslate"><span class="pre">!files</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html#tab-social-media">tab <code class="docutils literal notranslate"><span class="pre">!social_media</span></code></a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="about.html">About SearXNG</a><ul>
<li class="toctree-l2"><a class="reference internal" href="about.html#why-use-it">Why use it?</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#how-do-i-set-it-as-the-default-search-engine">How do I set it as the default search engine?</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#how-does-it-work">How does it work?</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#how-can-i-make-it-my-own">How can I make it my own?</a></li>
</ul>
</li>
</ul>
</div>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<span id="sidebar-top"></span>
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/searxng-wordmark.svg" alt="Logo of SearXNG"/>
</a></p>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">User information</a><ul>
<li class="toctree-l2"><a class="reference internal" href="search-syntax.html">Search syntax</a></li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html">Configured Engines</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html">About SearXNG</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../own-instance.html">Why use a private instance?</a></li>
<li class="toctree-l1"><a class="reference internal" href="../admin/index.html">Administrator documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev/index.html">Developer documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../utils/index.html">DevOps tooling box</a></li>
<li class="toctree-l1"><a class="reference internal" href="../src/index.html">Source-Code</a></li>
</ul>
<h3>Project Links</h3>
<ul>
<li><a href="https://github.com/searxng/searxng/tree/master">Source</a>
<li><a href="https://github.com/searxng/searxng/wiki">Wiki</a>
<li><a href="https://searx.space">Public instances</a>
<li><a href="https://github.com/searxng/searxng/issues">Issue Tracker</a>
</ul><h3>Navigation</h3>
<ul>
<li><a href="../index.html">Overview</a>
<ul>
<li>Previous: <a href="../index.html" title="previous chapter">Welcome to SearXNG</a>
<li>Next: <a href="search-syntax.html" title="next chapter">Search syntax</a>
</ul>
</li>
</ul>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user/index.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright SearXNG team.
</div>
</body>
</html>

229
user/search-syntax.html Normal file
View file

@ -0,0 +1,229 @@
<!DOCTYPE html>
<html lang="en" data-content_root="../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Search syntax &#8212; SearXNG Documentation (2025.7.28+f32e91e51)</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=6625fa76" />
<link rel="stylesheet" type="text/css" href="../_static/searxng.css?v=52e4ff28" />
<script src="../_static/documentation_options.js?v=6c28674e"></script>
<script src="../_static/doctools.js?v=9a2dae69"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script data-project="searxng" data-version="2025.7.28+f32e91e51" src="../_static/describe_version.js?v=fa7f30d0"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Configured Engines" href="configured_engines.html" />
<link rel="prev" title="User information" href="index.html" />
</head><body>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="../py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="configured_engines.html" title="Configured Engines"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="User information"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">SearXNG Documentation (2025.7.28+f32e91e51)</a> &#187;</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">User information</a> &#187;</li>
<li class="nav-item nav-item-this"><a href="">Search syntax</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="search-syntax">
<span id="search-syntax"></span><h1>Search syntax<a class="headerlink" href="#search-syntax" title="Link to this heading"></a></h1>
<p>SearXNG comes with a search syntax by which you can modify the categories,
engines, languages, and more. See the <code class="docutils literal notranslate"><span class="pre">preferences</span></code> for
the list of engines, categories, and languages.</p>
<section id="select-engine-and-category">
<h2><code class="docutils literal notranslate"><span class="pre">!</span></code> Select engine and category<a class="headerlink" href="#select-engine-and-category" title="Link to this heading"></a></h2>
<p>To set category and/or engine names, use a <code class="docutils literal notranslate"><span class="pre">!</span></code> prefix. To give a few examples:</p>
<ul class="simple">
<li><p>Search Wikipedia for <strong>paris</strong>:</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">!wp</span> <span class="pre">paris</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">!wikipedia</span> <span class="pre">paris</span></code></p></li>
</ul>
</li>
<li><p>Search in category <strong>map</strong> for <strong>paris</strong>:</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">!map</span> <span class="pre">paris</span></code></p></li>
</ul>
</li>
<li><p>Image search</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">!images</span> <span class="pre">Wau</span> <span class="pre">Holland</span></code></p></li>
</ul>
</li>
</ul>
<p>Abbreviations of the engines and languages are also accepted. Engine/category
modifiers are chainable and inclusive. For example, <code class="docutils literal notranslate"><span class="pre">!map</span> <span class="pre">!ddg</span> <span class="pre">!wp</span> <span class="pre">paris</span></code> searches in the map category and searches DuckDuckGo and Wikipedia for <strong>paris</strong>.</p>
</section>
<section id="select-language">
<h2><code class="docutils literal notranslate"><span class="pre">:</span></code> Select language<a class="headerlink" href="#select-language" title="Link to this heading"></a></h2>
<p>To select a language filter use a <code class="docutils literal notranslate"><span class="pre">:</span></code> prefix. To give an example:</p>
<ul class="simple">
<li><p>Search Wikipedia with a custom language:</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">:fr</span> <span class="pre">!wp</span> <span class="pre">Wau</span> <span class="pre">Holland</span></code></p></li>
</ul>
</li>
</ul>
</section>
<section id="bang-external-bangs">
<h2><code class="docutils literal notranslate"><span class="pre">!!&lt;bang&gt;</span></code> External bangs<a class="headerlink" href="#bang-external-bangs" title="Link to this heading"></a></h2>
<p>SearXNG supports the external bangs from <a class="reference external" href="https://duckduckgo.com/bang">DuckDuckGo</a>. To directly jump to a
external search page use the <code class="docutils literal notranslate"><span class="pre">!!</span></code> prefix. To give an example:</p>
<ul class="simple">
<li><p>Search Wikipedia with a custom language:</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">!!wfr</span> <span class="pre">Wau</span> <span class="pre">Holland</span></code></p></li>
</ul>
</li>
</ul>
<p>Please note that your search will be performed directly in the external search
engine. SearXNG cannot protect your privacy with this.</p>
</section>
<section id="automatic-redirect">
<h2><code class="docutils literal notranslate"><span class="pre">!!</span></code> automatic redirect<a class="headerlink" href="#automatic-redirect" title="Link to this heading"></a></h2>
<p>When including <code class="docutils literal notranslate"><span class="pre">!!</span></code> within your search query (separated by spaces), you will
automatically be redirected to the first result. This behavior is comparable to
the “Feeling Lucky” feature from DuckDuckGo. To give an example:</p>
<ul class="simple">
<li><p>Search for a query and get redirected to the first result</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">!!</span> <span class="pre">Wau</span> <span class="pre">Holland</span></code></p></li>
</ul>
</li>
</ul>
<p>Please keep in mind that the result you are being redirected to can’t be
verified for trustworthiness and SearXNG cannot protect your personal privacy
when using this feature. Use it at your own risk.</p>
</section>
<section id="special-queries">
<h2>Special Queries<a class="headerlink" href="#special-queries" title="Link to this heading"></a></h2>
<p>In the <code class="docutils literal notranslate"><span class="pre">preferences</span></code> page you find keywords for
<em>special queries</em>. To give a few examples:</p>
<ul class="simple">
<li><p>Generate a random UUID</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">random</span> <span class="pre">uuid</span></code></p></li>
</ul>
</li>
<li><p>Find the average</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">avg</span> <span class="pre">123</span> <span class="pre">548</span> <span class="pre">2.04</span> <span class="pre">24.2</span></code></p></li>
</ul>
</li>
<li><p>Show the <em>user agent</em> of your browser (needs to be activated)</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">user-agent</span></code></p></li>
</ul>
</li>
<li><p>Convert strings to different hash digests (needs to be activated)</p>
<ul>
<li><p><code class="docutils literal notranslate"><span class="pre">md5</span> <span class="pre">lorem</span> <span class="pre">ipsum</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">sha512</span> <span class="pre">lorem</span> <span class="pre">ipsum</span></code></p></li>
</ul>
</li>
</ul>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<span id="sidebar-top"></span>
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/searxng-wordmark.svg" alt="Logo of SearXNG"/>
</a></p>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="index.html">User information</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">Search syntax</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#select-engine-and-category"><code class="docutils literal notranslate"><span class="pre">!</span></code> Select engine and category</a></li>
<li class="toctree-l3"><a class="reference internal" href="#select-language"><code class="docutils literal notranslate"><span class="pre">:</span></code> Select language</a></li>
<li class="toctree-l3"><a class="reference internal" href="#bang-external-bangs"><code class="docutils literal notranslate"><span class="pre">!!&lt;bang&gt;</span></code> External bangs</a></li>
<li class="toctree-l3"><a class="reference internal" href="#automatic-redirect"><code class="docutils literal notranslate"><span class="pre">!!</span></code> automatic redirect</a></li>
<li class="toctree-l3"><a class="reference internal" href="#special-queries">Special Queries</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="configured_engines.html">Configured Engines</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html">About SearXNG</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../own-instance.html">Why use a private instance?</a></li>
<li class="toctree-l1"><a class="reference internal" href="../admin/index.html">Administrator documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev/index.html">Developer documentation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../utils/index.html">DevOps tooling box</a></li>
<li class="toctree-l1"><a class="reference internal" href="../src/index.html">Source-Code</a></li>
</ul>
<h3>Project Links</h3>
<ul>
<li><a href="https://github.com/searxng/searxng/tree/master">Source</a>
<li><a href="https://github.com/searxng/searxng/wiki">Wiki</a>
<li><a href="https://searx.space">Public instances</a>
<li><a href="https://github.com/searxng/searxng/issues">Issue Tracker</a>
</ul><h3>Navigation</h3>
<ul>
<li><a href="../index.html">Overview</a>
<ul>
<li><a href="index.html">User information</a>
<ul>
<li>Previous: <a href="index.html" title="previous chapter">User information</a>
<li>Next: <a href="configured_engines.html" title="next chapter">Configured Engines</a></ul>
</li>
</ul>
</li>
</ul>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user/search-syntax.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright SearXNG team.
</div>
</body>
</html>