[upd] github-actions: Bump actions/setup-node from 6.4.0 to 7.0.0 (#6423)

Bumps [actions/setup-node](https://github.com/actions/setup-node) from 6.4.0 to 7.0.0.
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](48b55a011b...8207627860)

---
updated-dependencies:
- dependency-name: actions/setup-node
  dependency-version: 7.0.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.devcontainer/Dockerfile

@@ -1,4 +1,22 @@
-FROM mcr.microsoft.com/devcontainers/base:debian
+ARG DEBIAN_CODENAME="bookworm"
+
+FROM mcr.microsoft.com/devcontainers/base:$DEBIAN_CODENAME
+
+ARG DEBIAN_CODENAME="bookworm"
+
+RUN cat <<EOF > /etc/apt/sources.list.d/debian.sources
+Types: deb
+URIs: http://deb.debian.org/debian
+Suites: $DEBIAN_CODENAME $DEBIAN_CODENAME-updates $DEBIAN_CODENAME-backports
+Components: main
+Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
+
+Types: deb
+URIs: http://security.debian.org/debian-security
+Suites: $DEBIAN_CODENAME-security
+Components: main
+Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
+EOF
 
 RUN apt-get update && \
-    apt-get -y install python3 python3-venv redis firefox-esr graphviz imagemagick librsvg2-bin fonts-dejavu shellcheck
+    apt-get -y install python3 python3-venv valkey-server firefox-esr graphviz imagemagick librsvg2-bin fonts-dejavu shellcheck

.devcontainer/devcontainer.json

@@ -1,9 +1,13 @@
 {
   "build": {
+    "args": {
+      "DEBIAN_CODENAME": "bookworm",
+    },
     "dockerfile": "Dockerfile"
   },
   "features": {
-    "ghcr.io/devcontainers/features/github-cli": {}
+    "ghcr.io/devcontainers/features/github-cli": {},
+    "ghcr.io/devcontainers/features/docker-in-docker": {}
   },
   "customizations": {
     "vscode": {

.dir-locals-template.el

@@ -1,163 +0,0 @@
-;;; .dir-locals.el
-;;
-;; Per-Directory Local Variables:
-;;   https://www.gnu.org/software/emacs/manual/html_node/emacs/Directory-Variables.html
-;;
-;; For full fledge developer tools install emacs packages:
-;;
-;;    M-x package-install ...
-;;
-;;     magit gitconfig
-;;     nvm lsp-mode lsp-pyright lsp-eslint
-;;     pyvenv pylint pip-requirements
-;;     jinja2-mode
-;;     json-mode
-;;     company company-jedi company-quickhelp company-shell
-;;     realgud
-;;     sphinx-doc markdown-mode graphviz-dot-mode
-;;     apache-mode nginx-mode
-;;
-;; To setup a developer environment, build target::
-;;
-;;     $ make node.env.dev pyenv.install
-;;
-;; Some buffer locals are referencing the project environment:
-;;
-;; - prj-root                                --> <repo>/
-;; - nvm-dir                                 --> <repo>/.nvm
-;; - python-environment-directory            --> <repo>/local
-;; - python-environment-default-root-name    --> py3
-;; - python-shell-virtualenv-root            --> <repo>/local/py3
-;;       When this variable is set with the path of the virtualenv to use,
-;;      `process-environment' and `exec-path' get proper values in order to run
-;;      shells inside the specified virtualenv, example::
-;;         (setq python-shell-virtualenv-root "/path/to/env/")
-;; - python-shell-interpreter                --> <repo>/local/py3/bin/python
-;;
-;; Python development:
-;;
-;; Jedi, flycheck & other python stuff should use the 'python-shell-interpreter'
-;; from the local py3 environment.
-;;
-
-((nil
-  . ((fill-column . 80)
-     (indent-tabs-mode . nil)
-     (eval . (progn
-
-               (add-to-list 'auto-mode-alist '("\\.html\\'" . jinja2-mode))
-
-               ;; project root folder is where the `.dir-locals.el' is located
-               (setq-local prj-root
-                           (locate-dominating-file  default-directory ".dir-locals.el"))
-
-               (setq-local python-environment-directory
-                           (expand-file-name "./local" prj-root))
-
-               ;; to get in use of NVM environment, install https://github.com/rejeep/nvm.el
-               (setq-local nvm-dir (expand-file-name "./.nvm" prj-root))
-
-               ;; use nodejs from the (local) NVM environment (see nvm-dir)
-               (nvm-use-for-buffer)
-               (ignore-errors (require 'lsp))
-               (setq-local lsp-server-install-dir (car (cdr nvm-current-version)))
-               (setq-local lsp-enable-file-watchers nil)
-
-               ;; use 'py3' environment as default
-               (setq-local python-environment-default-root-name
-                           "py3")
-
-               (setq-local python-shell-virtualenv-root
-                           (expand-file-name
-                            python-environment-default-root-name python-environment-directory))
-
-               (setq-local python-shell-interpreter
-                           (expand-file-name
-                            "bin/python" python-shell-virtualenv-root))))))
- (makefile-gmake-mode
-  . ((indent-tabs-mode . t)))
-
- (yaml-mode
-  . ((eval . (progn
-
-               ;; flycheck should use the local py3 environment
-               (setq-local flycheck-yaml-yamllint-executable
-                           (expand-file-name "bin/yamllint" python-shell-virtualenv-root))
-
-               (setq-local flycheck-yamllintrc
-                           (expand-file-name  ".yamllint.yml" prj-root))
-
-               (flycheck-checker . yaml-yamllint)))))
-
- (json-mode
-  . ((eval . (progn
-               (setq-local js-indent-level 4)
-               (flycheck-checker . json-python-json)))))
-
- (js-mode
-  . ((eval . (progn
-               (ignore-errors (require 'lsp-eslint))
-               (setq-local js-indent-level 2)
-               ;; flycheck should use the eslint checker from developer tools
-               (setq-local flycheck-javascript-eslint-executable
-                           (expand-file-name "node_modules/.bin/eslint" prj-root))
-               ;; (flycheck-mode)
-
-               (if (featurep 'lsp-eslint)
-                   (lsp))
-               ))))
-
- (python-mode
-  . ((eval . (progn
-               (ignore-errors (require 'jedi-core))
-               (ignore-errors (require 'lsp-pyright))
-               (ignore-errors (sphinx-doc-mode))
-               (setq-local python-environment-virtualenv
-                           (list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
-                                 ;;"--system-site-packages"
-                                 "--quiet"))
-
-               (setq-local pylint-command
-                           (expand-file-name "bin/pylint" python-shell-virtualenv-root))
-
-               (if (featurep 'lsp-pyright)
-                   (lsp))
-
-               ;; pylint will find the '.pylintrc' file next to the CWD
-               ;;   https://pylint.readthedocs.io/en/latest/user_guide/run.html#command-line-options
-               (setq-local flycheck-pylintrc
-                           ".pylintrc")
-
-               ;; flycheck & other python stuff should use the local py3 environment
-               (setq-local flycheck-python-pylint-executable
-                           python-shell-interpreter)
-
-               ;; use 'M-x jedi:show-setup-info' and 'M-x epc:controller' to inspect jedi server
-               ;; https://tkf.github.io/emacs-jedi/latest/#jedi:environment-root -- You
-               ;; can specify a full path instead of a name (relative path). In that case,
-               ;; python-environment-directory is ignored and Python virtual environment
-               ;; is created at the specified path.
-               (setq-local jedi:environment-root
-                           python-shell-virtualenv-root)
-
-               ;; https://tkf.github.io/emacs-jedi/latest/#jedi:server-command
-               (setq-local jedi:server-command
-                           (list python-shell-interpreter
-                                 jedi:server-script))
-
-               ;; jedi:environment-virtualenv --> see above 'python-environment-virtualenv'
-               ;; is set buffer local!  No need to setup jedi:environment-virtualenv:
-               ;;
-               ;;    Virtualenv command to use.  A list of string.  If it is nil,
-               ;;    python-environment-virtualenv is used instead.  You must set non-nil
-               ;;    value to jedi:environment-root in order to make this setting work.
-               ;;
-               ;;    https://tkf.github.io/emacs-jedi/latest/#jedi:environment-virtualenv
-               ;;
-               ;; (setq-local jedi:environment-virtualenv
-               ;;             (list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
-               ;;                   "--python"
-               ;;                   "/usr/bin/python3.4"
-               ;;                   ))
-               ))))
- )

.dockerignore

@@ -1,44 +1,6 @@
-*~
-*/*~
-*/*/*~
-*/*/*/*~
-*/*/*/*/*~
+*
 
-# Git
-.git
-.gitignore
-
-# CI
-.codeclimate.yml
-.travis.yml
-.taskcluster.yml
-
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*/__pycache__/
-*/*/__pycache__/
-*/*/*/__pycache__/
-*.py[cod]
-*/*.py[cod]
-*/*/*.py[cod]
-*/*/*/*.py[cod]
-
-# node_modules
-node_modules/
-*/node_modules/
-*/*/node_modules/
-*/*/*/node_modules/
-*/*/*/*/node_modules/
-
-.tx/
-
-# to sync with .gitignore
-geckodriver.log
-.coverage
-coverage/
-cache/
-build/
-dist/
-local/
-gh-pages/
-*.egg-info/
+!container/*.template.*
+!container/entrypoint.sh
+!searx/**
+!requirements*.txt

.editorconfig

@@ -10,21 +10,50 @@ trim_trailing_whitespace = true
 end_of_line = lf
 charset = utf-8
 
-[*.py]
-max_line_length = 119
+[{*.py,*.pyi}]
+# code formatter accepts length of 120, but editor should prefer 80
+max_line_length = 80
+
+[{*.sh,manage}]
+indent_style = space
+indent_size = 4
+
+# shfmt options
+shell_variant  = bash
+switch_case_indent = true
 
 [*.html]
-indent_size = 4
+# in the jinja templates we use indent size of 2 and we do not use tabs
+indent_size = 2
+indent_style = space
+
+[*.css]
+indent_size = 2
+
+[*.less]
+indent_size = 2
 
 [*.js]
 indent_size = 2
 
+[*.ts]
+indent_size = 2
+
 [*.json]
-indent_size = 4
+indent_size = 2
+insert_final_newline = ignore
+
+[*.map]
+indent_size = ignore
 insert_final_newline = ignore
 
 # Minified JavaScript files shouldn't be changed
-[**.min.js]
+[*.min.js]
+indent_style = ignore
+insert_final_newline = ignore
+
+# Minified CSS files shouldn't be changed
+[*.min.css]
 indent_style = ignore
 insert_final_newline = ignore
 

.github/ISSUE_TEMPLATE/bug-report.md

@@ -1,39 +1,50 @@
 ---
-name: Bug report
-about: Report a bug in SearXNG
-title: ''
-labels: bug
-assignees: ''
-
+name: "Bug report"
+about: Report a bug in SearXNG"
+labels: ["bug"]
+type: "bug"
 ---
-<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-**Version of SearXNG, commit number if you are using on master branch and stipulate if you forked SearXNG**
-<!-- If you are running on master branch using git execute this command
-in order to fetch the latest commit ID:
-```
-git log -1
-``` 
-If you are using searxng-docker then look at the bottom of the SearXNG page
-and check for the version after "Powered by SearXNG"
+_Replace this placeholder with a meaningful and precise description of the bug._
 
-Please also stipulate if you are using a forked version of SearXNG and
-include a link to the fork source code.
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
+
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
 -->
-**How did you install SearXNG?**
-<!-- Did you install SearXNG using the official wiki or using searxng-docker
-or manually by executing the searx/webapp.py file? -->
-**What happened?**
-<!-- A clear and concise description of what the bug is. -->
 
-**How To Reproduce**
-<!-- How can we reproduce this issue? (as minimally and as precisely as possible) -->
+### How To Reproduce?
+
+<!-- How can we reproduce this issue? (as minimally and as precisely as
+     possible) -->
+
+### Expected behavior
 
-**Expected behavior**
 <!-- A clear and concise description of what you expected to happen. -->
 
-**Screenshots & Logs**
+### Screenshots & Logs
+
 <!-- If applicable, add screenshots, logs to help explain your problem. -->
 
-**Additional context**
+### Version of SearXNG
+
+<!-- Commit number if you are using on master branch and stipulate if you forked
+     SearXNG -->
+
+<!-- Look at the bottom of the SearXNG page and check for the version after
+     "Powered by SearXNG" If you are using a forked version of SearXNG include a
+     link to the fork source code. -->
+
+### How did you install SearXNG?
+
+<!-- Did you install SearXNG using the official documentation or using
+     searxng-docker? -->
+
+### Additional context
+
 <!-- Add any other context about the problem here. -->
+
+### Code of Conduct
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
   - name: Questions & Answers (Q&A)
     url: https://github.com/searxng/searxng/discussions/categories/q-a

.github/ISSUE_TEMPLATE/engine-request.md

@@ -1,31 +1,46 @@
 ---
-name: Engine request
-about: Request a new engine in SearXNG
-title: ''
-labels: enhancement, engine request
-assignees: ''
-
+name: Engine request"
+about: Request a new engine in SearXNG"
+labels: ["engine request"]
+type: "feature"
 ---
-<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-**Working URL to the engine**
-<!-- Please check if the engine is responding correctly before submitting it. -->
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
 
-**Why do you want to add this engine?**
-<!-- What's special about this engine? Is it open source or libre? -->
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+-->
 
-**Features of this engine**
-<!-- Features of this engine: Doesn't track its users, fast, easy to integrate, ... -->
+### Working URL to the engine
 
-**How can SearXNG fetch the information from this engine?**
-<!-- List API URL, example code (using the correct markdown) and more
-that could be useful for the developers in order to implement this engine.
-If you don't know what to write, let this part blank. -->
+<!-- Please check if the engine is responding correctly before submitting -->
 
-**Applicable category of this engine**
-<!-- Where should this new engine fit in SearXNG? Current categories in SearXNG:
-general, files, images, it, map, music, news, science, social media and videos.
-You can add multiple categories at the same time. -->
+### Why do you want to add this engine?
 
-**Additional context**
-<!-- Add any other context about this engine here. -->
+<!-- What's special about this engine?  -->
+
+### Features of this engine
+
+<!-- Features of this engine: Serves special content, is fast, is easy to
+     integrate, ... ? -->
+
+### How can SearXNG fetch results from this engine?
+
+<!-- List API URL, example code and more that could be useful for the developers
+     in order to implement this engine.  If you don't know what to write, let
+     this part blank. -->
+
+### Applicable category of this engine
+
+<!-- Where should this new engine fit in SearXNG?  Current categories in
+     SearXNG: general, files, images, it, map, music, news, science, social
+     media and videos. -->
+
+### Additional context
+
+<!-- Add any other context about the problem here. -->
+
+### Code of Conduct
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/ISSUE_TEMPLATE/feature-request.md

@@ -1,21 +1,32 @@
 ---
-name: Feature request
-about: Request a new feature in SearXNG
-title: ''
-labels: enhancement
-assignees: ''
-
+name: "Feature request"
+about: "Request a new feature in SearXNG"
+labels: ["new feature"]
+type: "feature"
 ---
-<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-**Is your feature request related to a problem? Please describe.**
-<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] -->
+_Replace this placeholder with a concise description of the feature._
+
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
+
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+-->
+
+### Is your feature request related to a problem?
+
+<!-- A clear and concise description of what the problem is. Ex. I'm always
+     frustrated when [...] -->
+
+### Describe the solution you'd like
 
-**Describe the solution you'd like**
 <!-- A clear and concise description of what you want to happen. -->
 
-**Describe alternatives you've considered**
+### Describe alternatives you've considered
+
 <!-- A clear and concise description of any alternative solutions or features you've considered. -->
 
-**Additional context**
-<!-- Add any other context or screenshots about the feature request here. -->
+### Code of Conduct
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/dependabot.yml

@@ -10,13 +10,66 @@ updates:
     target-branch: "master"
     commit-message:
       prefix: "[upd] pypi:"
+    groups:
+      minor:
+        applies-to: version-updates
+        update-types:
+          - "minor"
+          - "patch"
 
   - package-ecosystem: "npm"
-    directory: "/searx/static/themes/simple"
+    directory: "/client/simple"
     schedule:
       interval: "weekly"
       day: "friday"
     open-pull-requests-limit: 5
     target-branch: "master"
     commit-message:
-      prefix: "[upd] npm:"
+      prefix: "[upd] web-client (simple):"
+    groups:
+      minor:
+        applies-to: version-updates
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "friday"
+    open-pull-requests-limit: 5
+    target-branch: "master"
+    commit-message:
+      prefix: "[upd] searxng.org/devtools (Node.js):"
+    groups:
+      minor:
+        applies-to: version-updates
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "friday"
+    open-pull-requests-limit: 5
+    target-branch: "master"
+    commit-message:
+      prefix: "[upd] searxng.org/devtools (Go):"
+    groups:
+      minor:
+        applies-to: version-updates
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "friday"
+    target-branch: "master"
+    commit-message:
+      prefix: "[upd] github-actions:"

.github/workflows/checker.yml

@@ -1,31 +0,0 @@
-name: "Checker"
-on:  # yamllint disable-line rule:truthy
-  schedule:
-    - cron: "0 4 * * 5"
-  workflow_dispatch:
-
-jobs:
-  checker:
-    name: Checker
-    runs-on: ubuntu-22.04
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install Ubuntu packages
-        run: |
-          sudo ./utils/searxng.sh install packages
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-          architecture: 'x64'
-
-      - name: Install Python dependencies
-        run: |
-          make V=1 install
-
-      - name: Checker
-        run: |
-          make search.checker

.github/workflows/container.yml

@@ -0,0 +1,170 @@
+---
+name: Container
+
+# yamllint disable-line rule:truthy
+on:
+  workflow_dispatch:
+  workflow_run:
+    workflows:
+      - Integration
+    types:
+      - completed
+    branches:
+      - master
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  packages: read
+
+env:
+  PYTHON_VERSION: "3.14"
+
+jobs:
+  build:
+    if: |
+      github.event_name == 'workflow_dispatch'
+      || (github.repository_owner == 'searxng' && github.event.workflow_run.conclusion == 'success')
+    name: Build (${{ matrix.arch }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-26.04
+            arch: amd64
+          - runner: ubuntu-26.04-arm
+            arch: arm64
+          - runner: ubuntu-26.04-arm
+            arch: armv7
+
+    permissions:
+      packages: write
+
+    outputs:
+      docker_tag: ${{ steps.build.outputs.docker_tag }}
+      git_url: ${{ steps.build.outputs.git_url }}
+
+    steps:
+      - name: Login to GHCR
+        uses: docker/login-action@af1e73f918a031802d376d3c8bbc3fe56130a9b0  # v4.4.0
+        with:
+          registry: "ghcr.io"
+          username: "${{ github.repository_owner }}"
+          password: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Setup Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6.3.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+
+      - name: Setup QEMU
+        uses: docker/setup-qemu-action@96fe6ef7f33517b61c61be40b68a1882f3264fb8  # v4.2.0
+
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+        with:
+          ref: "${{ github.event.workflow_run.head_sha || github.sha }}"
+          persist-credentials: "false"
+          fetch-depth: "0"
+
+      - name: Setup cache Python
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        with:
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
+          path: "./local/"
+
+      - name: Setup cache container
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        with:
+          key: "container-${{ matrix.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            container-${{ matrix.arch }}-
+          path: "/var/tmp/buildah-cache-*/*"
+
+      - name: Build
+        id: build
+        env:
+          OVERRIDE_ARCH: "${{ matrix.arch }}"
+        run: make container.build
+
+  test:
+    name: Test (${{ matrix.arch }})
+    runs-on: ${{ matrix.runner }}
+    needs: build
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-26.04
+            arch: amd64
+          - runner: ubuntu-26.04-arm
+            arch: arm64
+          - runner: ubuntu-26.04-arm
+            arch: armv7
+
+    steps:
+      - name: Login to GHCR
+        uses: docker/login-action@af1e73f918a031802d376d3c8bbc3fe56130a9b0  # v4.4.0
+        with:
+          registry: "ghcr.io"
+          username: "${{ github.repository_owner }}"
+          password: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Setup QEMU
+        uses: docker/setup-qemu-action@96fe6ef7f33517b61c61be40b68a1882f3264fb8  # v4.2.0
+
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+        with:
+          ref: "${{ github.event.workflow_run.head_sha || github.sha }}"
+          persist-credentials: "false"
+
+      - name: Test
+        env:
+          OVERRIDE_ARCH: "${{ matrix.arch }}"
+          GIT_URL: "${{ needs.build.outputs.git_url }}"
+        run: make container.test
+
+  release:
+    if: github.repository_owner == 'searxng' && github.ref_name == 'master'
+    name: Release
+    runs-on: ubuntu-26.04-arm
+    needs:
+      - build
+      - test
+
+    permissions:
+      packages: write
+
+    steps:
+      - name: Login to Docker Hub
+        uses: docker/login-action@af1e73f918a031802d376d3c8bbc3fe56130a9b0  # v4.4.0
+        with:
+          registry: "docker.io"
+          username: "${{ secrets.DOCKER_USER }}"
+          password: "${{ secrets.DOCKER_TOKEN }}"
+
+      - name: Login to GHCR
+        uses: docker/login-action@af1e73f918a031802d376d3c8bbc3fe56130a9b0  # v4.4.0
+        with:
+          registry: "ghcr.io"
+          username: "${{ github.repository_owner }}"
+          password: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+        with:
+          ref: "${{ github.event.workflow_run.head_sha || github.sha }}"
+          persist-credentials: "false"
+
+      - name: Release
+        env:
+          GIT_URL: "${{ needs.build.outputs.git_url }}"
+          DOCKER_TAG: "${{ needs.build.outputs.docker_tag }}"
+        run: make container.push

.github/workflows/data-update.yml

@@ -1,14 +1,27 @@
-name: "Update searx.data"
-on:  # yamllint disable-line rule:truthy
+---
+name: Update searx.data
+
+# yamllint disable-line rule:truthy
+on:
+  workflow_dispatch:
   schedule:
     - cron: "59 23 28 * *"
-  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.14"
 
 jobs:
-  updateData:
-    name: Update data - ${{ matrix.fetch }}
-    runs-on: ubuntu-24.04
-    if: ${{ github.repository_owner == 'searxng'}}
+  data:
+    if: github.repository_owner == 'searxng'
+    name: ${{ matrix.fetch }}
+    runs-on: ubuntu-26.04-arm
     strategy:
       fail-fast: false
       matrix:
@@ -20,48 +33,48 @@ jobs:
           - update_engine_traits.py
           - update_wikidata_units.py
           - update_engine_descriptions.py
+
+    permissions:
+      contents: write
+      pull-requests: write
+
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install Ubuntu packages
-        run: |
-          sudo ./utils/searxng.sh install packages
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Setup Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6.3.0
         with:
-          python-version: '3.12'
-          architecture: 'x64'
+          python-version: "${{ env.PYTHON_VERSION }}"
 
-      - name: Install Python dependencies
-        run: |
-          make V=1 install
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+        with:
+          persist-credentials: "false"
+
+      - name: Setup cache Python
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        with:
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
+          path: "./local/"
+
+      - name: Setup venv
+        run: make V=1 install
 
       - name: Fetch data
-        env:
-          FETCH_SCRIPT: ./searxng_extra/update/${{ matrix.fetch }}
-        run: |
-          V=1 ./manage pyenv.cmd python "$FETCH_SCRIPT"
+        run: V=1 ./manage pyenv.cmd python "./searxng_extra/update/${{ matrix.fetch }}"
 
-      - name: Create Pull Request
-        id: cpr
-        uses: peter-evans/create-pull-request@v6
+      - name: Create PR
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8.1.1
         with:
-          commit-message: '[data] update searx.data - ${{ matrix.fetch }}'
-          committer: searxng-bot <noreply@github.com>
-          author: ${{ github.actor }} <${{ github.actor }}@users.noreply.github.com>
-          signoff: false
-          branch: update_data_${{ matrix.fetch }}
-          delete-branch: true
-          draft: false
-          title: '[data] update searx.data - ${{ matrix.fetch }}'
+          author: "searxng-bot <searxng-bot@users.noreply.github.com>"
+          committer: "searxng-bot <searxng-bot@users.noreply.github.com>"
+          title: "[mod] data: update searx.data - ${{ matrix.fetch }}"
+          commit-message: "[mod] data: update searx.data - ${{ matrix.fetch }}"
+          branch: "ci-data-${{ matrix.fetch }}"
+          delete-branch: "true"
+          draft: "false"
+          signoff: "false"
           body: |
-            update searx.data - ${{ matrix.fetch }}
+            Update searx.data - ${{ matrix.fetch }}
           labels: |
             data
-
-      - name: Check outputs
-        run: |
-          echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
-          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"

.github/workflows/documentation.yml

@@ -0,0 +1,71 @@
+---
+name: Documentation
+
+# yamllint disable-line rule:truthy
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.14"
+
+jobs:
+  release:
+    if: github.repository_owner == 'searxng' || github.event_name == 'workflow_dispatch'
+    name: Release
+    runs-on: ubuntu-26.04-arm
+    permissions:
+      # for JamesIves/github-pages-deploy-action to push
+      contents: write
+
+    steps:
+      - name: Setup Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6.3.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+        with:
+          persist-credentials: "false"
+          fetch-depth: "0"
+
+      - name: Setup cache Python
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        with:
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
+          path: "./local/"
+
+      - name: Setup dependencies
+        run: sudo ./utils/searxng.sh install buildhost
+
+      - name: Setup venv
+        run: make V=1 install
+
+      - name: Build documentation
+        run: make V=1 docs.html
+
+      - if: github.ref_name == 'master'
+        name: Release
+        uses: JamesIves/github-pages-deploy-action@d92aa235d04922e8f08b40ce78cc5442fcfbfa2f  # v4.8.0
+        with:
+          folder: "dist/docs"
+          branch: "gh-pages"
+          commit-message: "[mod] docs: build from commit ${{ github.sha }}"
+          # Automatically remove deleted files from the deploy branch
+          clean: "true"
+          single-commit: "true"

.github/workflows/integration.yml

@@ -1,205 +1,103 @@
+---
 name: Integration
 
-on:  # yamllint disable-line rule:truthy
+# yamllint disable-line rule:truthy
+on:
   push:
-    branches: ["master"]
+    branches:
+      - master
   pull_request:
-    branches: ["master"]
+    branches:
+      - master
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref_name }}
+  cancel-in-progress: false
 
 permissions:
   contents: read
 
+env:
+  PYTHON_VERSION: "3.14"
+
 jobs:
-  python:
+  test:
     name: Python ${{ matrix.python-version }}
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-26.04
     strategy:
       matrix:
-        os: [ubuntu-20.04]
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+
     steps:
+      - name: Setup Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6.3.0
+        with:
+          python-version: "${{ matrix.python-version }}"
+
       - name: Checkout
-        uses: actions/checkout@v4
-      - name: Install Ubuntu packages
-        run: |
-          sudo ./utils/searxng.sh install packages
-          sudo apt install firefox
-      - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
         with:
-          python-version: ${{ matrix.python-version }}
-          architecture: 'x64'
-      - name: Cache Python dependencies
-        id: cache-python
-        uses: actions/cache@v4
+          persist-credentials: "false"
+
+      - name: Setup cache Python
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
         with:
-          path: |
-            ./local
-            ./.nvm
-            ./node_modules
-          key: python-${{ matrix.os }}-${{ matrix.python-version }}-${{ hashFiles('requirements*.txt', 'setup.py') }}
-      - name: Install Python dependencies
-        if: steps.cache-python.outputs.cache-hit != 'true'
-        run: |
-          make V=1 install
-          make V=1 gecko.driver
+          key: "python-${{ matrix.python-version }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            python-${{ matrix.python-version }}-${{ runner.arch }}-
+          path: "./local/"
+
+      - name: Setup venv
+        run: make V=1 install
+
       - name: Run tests
         run: make V=1 ci.test
 
-  themes:
-    name: Themes
-    runs-on: ubuntu-20.04
+  theme:
+    name: Theme
+    runs-on: ubuntu-26.04-arm
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Install Ubuntu packages
-        run: sudo ./utils/searxng.sh install buildhost
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Setup Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6.3.0
         with:
-          python-version: '3.12'
-          architecture: 'x64'
-      - name: Cache Python dependencies
-        id: cache-python
-        uses: actions/cache@v4
-        with:
-          path: |
-            ./local
-            ./.nvm
-            ./node_modules
-          key: python-ubuntu-20.04-3.12-${{ hashFiles('requirements*.txt', 'setup.py','.nvmrc', 'package.json') }}
-      - name: Install node dependencies
-        run: make V=1 node.env
-      - name: Build themes
-        run: make V=1 themes.all
+          python-version: "${{ env.PYTHON_VERSION }}"
 
-  documentation:
-    name: Documentation
-    runs-on: ubuntu-20.04
-    permissions:
-      contents: write  # for JamesIves/github-pages-deploy-action to push changes in repo
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020  # v7.0.0
         with:
-          fetch-depth: '0'
-          persist-credentials: false
-      - name: Install Ubuntu packages
-        run: sudo ./utils/searxng.sh install buildhost
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-          architecture: 'x64'
-      - name: Cache Python dependencies
-        id: cache-python
-        uses: actions/cache@v4
-        with:
-          path: |
-            ./local
-            ./.nvm
-            ./node_modules
-          key: python-ubuntu-20.04-3.12-${{ hashFiles('requirements*.txt', 'setup.py','.nvmrc', 'package.json') }}
-      - name: Build documentation
-        run: |
-          make V=1 docs.clean docs.html
-      - name: Deploy
-        if: github.ref == 'refs/heads/master'
-        uses: JamesIves/github-pages-deploy-action@3.7.1
-        with:
-          GITHUB_TOKEN: ${{ github.token }}
-          BRANCH: gh-pages
-          FOLDER: dist/docs
-          CLEAN: true  # Automatically remove deleted files from the deploy branch
-          SINGLE_COMMIT: true
-          COMMIT_MESSAGE: '[doc] build from commit ${{ github.sha }}'
+          node-version: "26"
+          check-latest: "true"
 
-  babel:
-    name: Update translations branch
-    runs-on: ubuntu-20.04
-    if: ${{ github.repository_owner == 'searxng' && github.ref == 'refs/heads/master' }}
-    needs:
-      - python
-      - themes
-      - documentation
-    permissions:
-      contents: write  # for make V=1 weblate.push.translations
-    steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
         with:
-          fetch-depth: '0'
-          token: ${{ secrets.WEBLATE_GITHUB_TOKEN }}
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-          architecture: 'x64'
-      - name: Cache Python dependencies
-        id: cache-python
-        uses: actions/cache@v4
-        with:
-          path: |
-            ./local
-            ./.nvm
-            ./node_modules
-          key: python-ubuntu-20.04-3.12-${{ hashFiles('requirements*.txt', 'setup.py','.nvmrc', 'package.json') }}
-      - name: weblate & git setup
-        env:
-          WEBLATE_CONFIG: ${{ secrets.WEBLATE_CONFIG }}
-        run: |
-          mkdir -p ~/.config
-          echo "${WEBLATE_CONFIG}" > ~/.config/weblate
-          git config --global user.email "searxng-bot@users.noreply.github.com"
-          git config --global user.name "searxng-bot"
-      - name: Update transations
-        id: update
-        run: |
-          make V=1 weblate.push.translations
+          persist-credentials: "false"
 
-  dockers:
-    name: Docker
-    if: github.ref == 'refs/heads/master'
-    needs:
-      - python
-      - themes
-      - documentation
-    env:
-      DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
-    runs-on: ubuntu-20.04
-    steps:
-      - name: Checkout
-        if: env.DOCKERHUB_USERNAME != null
-        uses: actions/checkout@v4
+      - name: Setup cache Python
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
         with:
-          # make sure "make docker.push" can get the git history
-          fetch-depth: '0'
-      - name: Set up Python
-        uses: actions/setup-python@v5
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
+          path: "./local/"
+
+      - name: Setup cache Node.js
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
         with:
-          python-version: '3.12'
-          architecture: 'x64'
-      - name: Cache Python dependencies
-        id: cache-python
-        uses: actions/cache@v4
-        with:
-          path: |
-            ./local
-            ./.nvm
-            ./node_modules
-          key: python-ubuntu-20.04-3.12-${{ hashFiles('requirements*.txt', 'setup.py','.nvmrc', 'package.json') }}
-      - name: Set up QEMU
-        if: env.DOCKERHUB_USERNAME != null
-        uses: docker/setup-qemu-action@v1
-      - name: Set up Docker Buildx
-        if: env.DOCKERHUB_USERNAME != null
-        uses: docker/setup-buildx-action@v1
-      - name: Login to DockerHub
-        if: env.DOCKERHUB_USERNAME != null
-        uses: docker/login-action@v1
-        with:
-          username: ${{ secrets.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
-      - name: Build and push
-        if: env.DOCKERHUB_USERNAME != null
-        run: make -e GIT_URL=$(git remote get-url origin) docker.buildx
+          key: "nodejs-${{ runner.arch }}-${{ hashFiles('**/package-lock.json') }}"
+          restore-keys: |
+            nodejs-${{ runner.arch }}-
+          path: "./client/simple/node_modules/"
+
+      - name: Setup venv
+        run: make V=1 install
+
+      - name: Lint
+        run: make themes.lint
+
+      - name: Build
+        run: make themes.all

.github/workflows/l10n.yml

@@ -0,0 +1,134 @@
+---
+name: Translation
+
+# yamllint disable-line rule:truthy
+on:
+  workflow_dispatch:
+  workflow_run:
+    workflows:
+      - Integration
+    types:
+      - completed
+    branches:
+      - master
+  schedule:
+    - cron: "05 07 * * 5"
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.14"
+
+jobs:
+  update:
+    if: github.event.workflow_run.conclusion == 'success' && github.repository_owner == 'searxng'
+    name: Update
+    runs-on: ubuntu-26.04-arm
+    permissions:
+      # For "make V=1 weblate.push.translations"
+      contents: write
+
+    steps:
+      - name: Setup Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6.3.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+        with:
+          token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
+          fetch-depth: "0"
+
+      - name: Setup cache Python
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        with:
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
+          path: "./local/"
+
+      - name: Setup venv
+        run: make V=1 install
+
+      - name: Setup Weblate
+        run: |
+          mkdir -p ~/.config
+          echo "${{ secrets.WEBLATE_CONFIG }}" >~/.config/weblate
+
+      - name: Setup Git
+        run: |
+          git config --global user.email "searxng-bot@users.noreply.github.com"
+          git config --global user.name "searxng-bot"
+
+      - name: Update translations
+        run: make V=1 weblate.push.translations
+
+  pr:
+    if: |
+      github.repository_owner == 'searxng'
+      && (github.event_name == 'workflow_dispatch' || github.event_name == 'schedule')
+    name: Pull Request
+    runs-on: ubuntu-26.04-arm
+    permissions:
+      # For "make V=1 weblate.translations.commit"
+      contents: write
+      # For action "peter-evans/create-pull-request"
+      pull-requests: write
+
+    steps:
+      - name: Setup Python
+        uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1  # v6.3.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+        with:
+          token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
+          fetch-depth: "0"
+
+      - name: Setup cache Python
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        with:
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
+          path: "./local/"
+
+      - name: Setup venv
+        run: make V=1 install
+
+      - name: Setup Weblate
+        run: |
+          mkdir -p ~/.config
+          echo "${{ secrets.WEBLATE_CONFIG }}" >~/.config/weblate
+
+      - name: Setup Git
+        run: |
+          git config --global user.email "searxng-bot@users.noreply.github.com"
+          git config --global user.name "searxng-bot"
+
+      - name: Merge and push translation updates
+        run: make V=1 weblate.translations.commit
+
+      - name: Create PR
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8.1.1
+        with:
+          author: "searxng-bot <searxng-bot@users.noreply.github.com>"
+          committer: "searxng-bot <searxng-bot@users.noreply.github.com>"
+          title: "[mod] i18n: update translations from Weblate"
+          commit-message: "[mod] i18n: update translations from Weblate"
+          branch: "translations_update"
+          delete-branch: "true"
+          draft: "false"
+          signoff: "false"
+          body: |
+            Update translations from Weblate
+          labels: |
+            area:i18n

.github/workflows/security.yml

@@ -1,28 +0,0 @@
-name: "Security checks"
-on:  # yamllint disable-line rule:truthy
-  schedule:
-    - cron: "42 05 * * *"
-  workflow_dispatch:
-
-jobs:
-  dockers:
-    name: Trivy ${{ matrix.image }}
-    runs-on: ubuntu-20.04
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Run Trivy vulnerability scanner
-        uses: aquasecurity/trivy-action@master
-        with:
-          image-ref: 'searxng/searxng:latest'
-          ignore-unfixed: false
-          vuln-type: 'os,library'
-          severity: 'UNKNOWN,LOW,MEDIUM,HIGH,CRITICAL'
-          format: 'sarif'
-          output: 'trivy-results.sarif'
-
-      - name: Upload Trivy scan results to GitHub Security tab
-        uses: github/codeql-action/upload-sarif@v2
-        with:
-          sarif_file: 'trivy-results.sarif'

.github/workflows/translations-update.yml

@@ -1,59 +0,0 @@
-name: "Update translations"
-on:  # yamllint disable-line rule:truthy
-  schedule:
-    - cron: "05 07 * * 5"
-  workflow_dispatch:
-
-jobs:
-  babel:
-    name: "create PR for additions from weblate"
-    runs-on: ubuntu-20.04
-    if: ${{ github.repository_owner == 'searxng' && github.ref == 'refs/heads/master' }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: '0'
-          token: ${{ secrets.WEBLATE_GITHUB_TOKEN }}
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-          architecture: 'x64'
-      - name: Cache Python dependencies
-        id: cache-python
-        uses: actions/cache@v4
-        with:
-          path: |
-            ./local
-            ./.nvm
-            ./node_modules
-          key: python-ubuntu-20.04-3.12-${{ hashFiles('requirements*.txt', 'setup.py','.nvmrc', 'package.json') }}
-      - name: weblate & git setup
-        env:
-          WEBLATE_CONFIG: ${{ secrets.WEBLATE_CONFIG }}
-        run: |
-          mkdir -p ~/.config
-          echo "${WEBLATE_CONFIG}" > ~/.config/weblate
-          git config --global user.email "searxng-bot@users.noreply.github.com"
-          git config --global user.name "searxng-bot"
-      - name: Merge and push transation updates
-        run: |
-          make V=1 weblate.translations.commit
-      - name: Create Pull Request
-        id: cpr
-        uses: peter-evans/create-pull-request@v3
-        with:
-          token: ${{ secrets.WEBLATE_GITHUB_TOKEN }}
-          commit-message: '[l10n] update translations from Weblate'
-          committer: searxng-bot <searxng-bot@users.noreply.github.com>
-          author: ${{ github.actor }} <${{ github.actor }}@users.noreply.github.com>
-          signoff: false
-          branch: translations_update
-          delete-branch: true
-          draft: false
-          title: '[l10n] update translations from Weblate'
-          body: |
-            update translations from Weblate
-          labels: |
-            translation

.gitignore

@@ -9,6 +9,7 @@ geckodriver.log
 .coverage
 coverage/
 
+.govm/
 .nvm/
 cache/
 build/

.helix/languages.toml

@@ -0,0 +1,11 @@
+[[language]]
+name = "python"
+language-servers = ["basedpyright", "pylsp"]
+auto-format = true
+
+[language-server.pylsp.config.pylsp]
+plugins.pylint.enabled = true
+plugins.isort.enabled = true
+plugins.black.enabled = true
+plugins.black.skip_string_normalization = true
+plugins.black.line_length = 120

.nvmrc

@@ -1 +1 @@
-v20.10
+25

.pylintrc

@@ -162,7 +162,7 @@ no-docstring-rgx=^_
 property-classes=abc.abstractproperty
 
 # Regular expression matching correct variable names
-variable-rgx=(([a-z][a-zA-Z0-9_]{2,30})|(_[a-z0-9_]*)|([a-z]))$
+variable-rgx=([a-zA-Z0-9_]*)$
 
 
 [FORMAT]
@@ -311,7 +311,7 @@ dummy-variables-rgx=_+$|(_[a-zA-Z0-9_]*[a-zA-Z0-9]+?$)|dummy|^ignored_|^unused_
 ignored-argument-names=_.*|^ignored_|^unused_
 
 # Tells whether we should check for unused import in __init__ files.
-init-import=no
+init-import=yes
 
 # List of qualified module names which can have objects that can redefine
 # builtins.

.tool-versions

@@ -1,2 +0,0 @@
-python 3.12.0
-shellcheck 0.9.0

AI_POLICY.rst

@@ -0,0 +1,20 @@
+.. SPDX-License-Identifier: AGPL-3.0-or-later
+
+AI Policy
+=========
+
+Restrictions on Generative AI Usage
+-----------------------------------
+- **All AI usage in any form must be disclosed.** You must state the tool you used (e.g. Claude Code, Cursor, Amp) along with the extent that the work was AI-assisted.
+- **The human-in-the-loop must fully understand all code.** If you use generative AI tools as an aid in developing code or documentation changes, ensure that you fully understand the proposed changes and can explain why they are the correct approach.
+- **AI should never be the main author of the PR.** AI may be used as a tool to help with developing, but the human contribution to the code changes should always be reasonably larger than the part written by AI. For example, you should be the one that decides about the structure of the PR, not the LLM.
+- **Issues and PR descriptions must be fully human-written.** Do not post output from Large Language Models or similar generative AI as comments on any of our discussion forums (e.g. GitHub Issues, Matrix, ...), as such comments tend to be formulaic and low content. If you're a not a native English speaker, using AI for translating self-written issue texts to English is okay, but please keep the wording as close as possible to the original wording.
+- **Bad AI drivers will be denounced.** People who produce bad contributions that are clearly AI (slop) will be blocked for all future contributions.
+
+There are Humans Here
+---------------------
+Every discussion, issue, and pull request is read and reviewed by humans. It is a boundary point at which people interact with each other and the work done. It is rude and disrespectful to approach this boundary with low-effort, unqualified work, since it puts the burden of validation on the maintainer.
+
+It takes a lot of maintainer time and energy to review AI-generated contributions! Sending the output of an LLM to open source project maintainers extracts work from them in the form of design and code review, so we call this kind of contribution an "extractive contribution".
+
+The *golden rule* is that a contribution should be worth more to the project than the time it takes to review it, which is usually not the case if large parts of your PR were written by LLMs.

AUTHORS.rst

@@ -2,7 +2,7 @@ searxng is a fork from `searx <https://github.com/searx/searx>`_ and is
 maintained by Markus Heiser (`@return42 <https://github.com/return42>`_)
 
 People who have submitted patches/translations, reported bugs, consulted
-features or generally made searx better:
+features or generally made SearXNG better:
 
 - Adam Tauber `@asciimoo <https://github.com/asciimoo>`_
 - Matej Cotman `@matejc <https://github.com/matejc>`_
@@ -173,4 +173,9 @@ features or generally made searx better:
 - Austin Olacsi `<https://github.com/Austin-Olacsi>`
 - @micsthepick
 - Daniel Kukula `<https://github.com/dkuku>`
-- Patrick Evans `https://github.com/holysoles`
+- Patrick Evans `https://github.com/holysoles`
+- Daniel Mowitz `<https://daniel.mowitz.rocks>`
+- `Bearz314 <https://github.com/bearz314>`_
+- Tommaso Colella `<https://github.com/gioleppe>`
+- @AgentScrubbles
+- Filip Mikina `<https://github.com/fiffek>`

CONTRIBUTING.md

@@ -1,49 +0,0 @@
-# How to contribute
-
-## Resources in the documentation
-
-* [Development quickstart](https://docs.searxng.org/dev/quickstart.html)
-* [Contribution guide](https://docs.searxng.org/dev/contribution_guide.html)
-
-## Submitting PRs
-
-Please follow the provided PR template when writing a description for your changes.
-
-Do not take criticism personally. When you get feedback, it is about your work,
-not your character, personality, etc. Keep in mind we all want to make the project better.
-
-When something is not clear, please ask questions to clear things up.
-
-If you would like to introduce a big architectural changes or do a refactoring
-either in the codebase or the development tools, please open an issue with a proposal
-first. This way we can think together about the problem and probably come up
-with a better solution.
-
-## Coding conventions and guidelines
-
-### Commit messages
-
-* Always write descriptive commit messages ("fix bug" is not acceptable).
-* Use the present tense ("Add feature" not "Added feature").
-* Use the imperative mood ("Move cursor to..." not "Moves cursor to...").
-* Limit the first line to 72 characters or less.
-* Include the number of the issue you are fixing.
-
-### Coding guidelines
-
-As a Python project, we must follow [PEP 8](https://www.python.org/dev/peps/pep-0008/) and [PEP 20](https://www.python.org/dev/peps/pep-0020/) guidelines.
-
-Furthermore, follow the Clean code conventions. The most important
-in this project are the following rules:
-
-* Simpler is better. [KISS principle](https://en.wikipedia.org/wiki/KISS_principle)
-* Be consistent.
-* Every function must do one thing.
-* Use descriptive names for functions and variables.
-* Always look for the root cause.
-* Keep configurable data high level.
-* Avoid negative conditionals.
-* Prefer fewer arguments.
-* Do not add obvious comment to code.
-* Do not comment out code, just delete lines.
-

CONTRIBUTING.rst

@@ -0,0 +1,98 @@
+.. SPDX-License-Identifier: AGPL-3.0-or-later
+
+.. _Quickstart guide: https://docs.searxng.org/dev/quickstart.html
+.. _Commits guide: https://docs.searxng.org/dev/commits.html
+.. _AI Policy: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+.. _Weblate: https://translate.codeberg.org/projects/searxng/searxng/
+.. _GitHub Codespaces: https://docs.github.com/en/codespaces/overview
+.. _120 hours per month: https://github.com/settings/billing
+.. _list of existing Codespaces: https://github.com/codespaces
+
+Thank you for your interest in SearXNG.
+
+Have a look at our `Quickstart guide`_, it's very easy to contribute.
+
+Further information on *how-to* can be found
+`here <https://docs.searxng.org/dev/index.html>`_.
+
+Translations
+============
+
+Help translate SearXNG at `Weblate`_.
+
+.. image:: https://translate.codeberg.org/widget/searxng/searxng/horizontal-auto.svg
+   :target: https://translate.codeberg.org/engage/searxng/
+   :alt: Weblate
+   :width: 768px
+
+Cloud development
+=================
+
+You can contribute from your browser using `GitHub Codespaces`_:
+
+- Fork the repository.
+- Click on the ``<> Code`` green button.
+- Click on the ``Codespaces`` tab instead of ``Local``.
+- Click on ``Create codespace on master``.
+- VSCode is going to start in the browser.
+- Wait for ``git pull && make install`` to appear and then disappear.
+- You have `120 hours per month`_ (see also your `list of existing Codespaces`_).
+- You can start SearXNG using ``make run`` in the terminal or by pressing ``Ctrl+Shift+B``.
+
+How-to contribute
+=================
+
+Submitting pull requests
+------------------------
+
+Please follow the provided PR template when writing a description for your
+changes.
+
+Do not take criticism personally. When you get feedback, it is about your work,
+not your character or personality. Keep in mind we all want to make SearXNG
+better.
+
+When something is not clear, please ask questions to clear things up.
+
+If you would like to introduce a big architectural change or do a refactor,
+either in the codebase or the development tooling, please open an issue with a
+proposal first. This way we can think together about the problem and probably
+come up with a better solution.
+
+Coding conventions and guidelines
+---------------------------------
+
+Commit messages
+~~~~~~~~~~~~~~~
+
+- Always write descriptive commit messages *("fix bug" is not acceptable)*.
+- Use the present tense *("Add feature", not "Added feature")*.
+- Use the imperative mood *("Move cursor to...", not "Moves cursor to...")*.
+- Limit the first line (commit title) to 72 characters or less.
+
+See `Commits guide`_ for more details.
+
+Coding guidelines
+~~~~~~~~~~~~~~~~~
+
+As a Python project, we must follow `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_
+and `PEP 20 <https://www.python.org/dev/peps/pep-0020/>`_ guidelines.
+
+Furthermore, follow Clean Code conventions. The most important
+rules in this project are:
+
+- Simpler is better. `KISS principle <https://en.wikipedia.org/wiki/KISS_principle>`_
+- Be consistent.
+- Every function must do one thing.
+- Use descriptive names for functions and variables.
+- Always look for the root cause.
+- Keep configurable data high level.
+- Avoid negative conditionals.
+- Prefer fewer arguments.
+- Do not add obvious comments to code.
+- Do not comment out code, delete lines instead.
+
+AI Policy
+~~~~~~~~~
+
+For our policy on the use of AI tools, please read `AI Policy`_.

Dockerfile

@@ -1,89 +0,0 @@
-FROM alpine:3.20
-ENTRYPOINT ["/sbin/tini","--","/usr/local/searxng/dockerfiles/docker-entrypoint.sh"]
-EXPOSE 8080
-VOLUME /etc/searxng
-
-ARG SEARXNG_GID=977
-ARG SEARXNG_UID=977
-
-RUN addgroup -g ${SEARXNG_GID} searxng && \
-    adduser -u ${SEARXNG_UID} -D -h /usr/local/searxng -s /bin/sh -G searxng searxng
-
-ENV INSTANCE_NAME=searxng \
-    AUTOCOMPLETE= \
-    BASE_URL= \
-    MORTY_KEY= \
-    MORTY_URL= \
-    SEARXNG_SETTINGS_PATH=/etc/searxng/settings.yml \
-    UWSGI_SETTINGS_PATH=/etc/searxng/uwsgi.ini \
-    UWSGI_WORKERS=%k \
-    UWSGI_THREADS=4
-
-WORKDIR /usr/local/searxng
-
-COPY requirements.txt ./requirements.txt
-
-RUN apk add --no-cache -t build-dependencies \
-    build-base \
-    py3-setuptools \
-    python3-dev \
-    libffi-dev \
-    libxslt-dev \
-    libxml2-dev \
-    openssl-dev \
-    tar \
-    git \
- && apk add --no-cache \
-    ca-certificates \
-    python3 \
-    py3-pip \
-    libxml2 \
-    libxslt \
-    openssl \
-    tini \
-    uwsgi \
-    uwsgi-python3 \
-    brotli \
- && pip3 install --break-system-packages --no-cache -r requirements.txt \
- && apk del build-dependencies \
- && rm -rf /root/.cache
-
-COPY --chown=searxng:searxng dockerfiles ./dockerfiles
-COPY --chown=searxng:searxng searx ./searx
-
-ARG TIMESTAMP_SETTINGS=0
-ARG TIMESTAMP_UWSGI=0
-ARG VERSION_GITCOMMIT=unknown
-
-RUN su searxng -c "/usr/bin/python3 -m compileall -q searx" \
- && touch -c --date=@${TIMESTAMP_SETTINGS} searx/settings.yml \
- && touch -c --date=@${TIMESTAMP_UWSGI} dockerfiles/uwsgi.ini \
- && find /usr/local/searxng/searx/static -a \( -name '*.html' -o -name '*.css' -o -name '*.js' \
-    -o -name '*.svg' -o -name '*.ttf' -o -name '*.eot' \) \
-    -type f -exec gzip -9 -k {} \+ -exec brotli --best {} \+
-
-# Keep these arguments at the end to prevent redundant layer rebuilds
-ARG LABEL_DATE=
-ARG GIT_URL=unknown
-ARG SEARXNG_GIT_VERSION=unknown
-ARG SEARXNG_DOCKER_TAG=unknown
-ARG LABEL_VCS_REF=
-ARG LABEL_VCS_URL=
-LABEL maintainer="searxng <${GIT_URL}>" \
-      description="A privacy-respecting, hackable metasearch engine." \
-      version="${SEARXNG_GIT_VERSION}" \
-      org.label-schema.schema-version="1.0" \
-      org.label-schema.name="searxng" \
-      org.label-schema.version="${SEARXNG_GIT_VERSION}" \
-      org.label-schema.url="${LABEL_VCS_URL}" \
-      org.label-schema.vcs-ref=${LABEL_VCS_REF} \
-      org.label-schema.vcs-url=${LABEL_VCS_URL} \
-      org.label-schema.build-date="${LABEL_DATE}" \
-      org.label-schema.usage="https://github.com/searxng/searxng-docker" \
-      org.opencontainers.image.title="searxng" \
-      org.opencontainers.image.version="${SEARXNG_DOCKER_TAG}" \
-      org.opencontainers.image.url="${LABEL_VCS_URL}" \
-      org.opencontainers.image.revision=${LABEL_VCS_REF} \
-      org.opencontainers.image.source=${LABEL_VCS_URL} \
-      org.opencontainers.image.created="${LABEL_DATE}" \
-      org.opencontainers.image.documentation="https://github.com/searxng/searxng-docker"

Makefile

@@ -17,7 +17,6 @@ help:
 	@echo 'install        - developer install of SearxNG into virtualenv'
 	@echo 'uninstall      - uninstall developer installation'
 	@echo 'clean          - clean up working tree'
-	@echo 'search.checker - check search engines'
 	@echo 'test           - run shell & CI tests'
 	@echo 'test.shell     - test shell scripts'
 	@echo 'ci.test        - run CI tests'
@@ -32,61 +31,53 @@ install uninstall:
 	$(Q)./manage pyenv.$@
 
 PHONY += clean
-clean: py.clean docs.clean node.clean nvm.clean test.clean
+clean: py.clean docs.clean node.clean nvm.clean go.clean test.clean
 	$(Q)./manage build_msg CLEAN  "common files"
 	$(Q)find . -name '*.orig' -exec rm -f {} +
 	$(Q)find . -name '*.rej' -exec rm -f {} +
 	$(Q)find . -name '*~' -exec rm -f {} +
 	$(Q)find . -name '*.bak' -exec rm -f {} +
 
-lxc.clean:
-	$(Q)rm -rf lxc-env
-
-PHONY += search.checker search.checker.%
-search.checker: install
-	$(Q)./manage pyenv.cmd searxng-checker -v
-
-search.checker.%: install
-	$(Q)./manage pyenv.cmd searxng-checker -v "$(subst _, ,$(patsubst search.checker.%,%,$@))"
 
 PHONY += test ci.test test.shell
-ci.test: test.yamllint test.black test.pyright test.pylint test.unit test.robot test.rst test.pybabel
-test:    test.yamllint test.black test.pyright test.pylint test.unit test.robot test.rst test.shell
+test:    test.yamllint test.black test.pyright_modified test.pylint test.unit test.robot test.rst test.shell test.shfmt
+ci.test: test test.pybabel
 test.shell:
 	$(Q)shellcheck -x -s dash \
-		dockerfiles/docker-entrypoint.sh
+		container/entrypoint.sh
 	$(Q)shellcheck -x -s bash \
 		utils/brand.sh \
 		$(MTOOLS) \
 		utils/lib.sh \
 		utils/lib_sxng*.sh \
-		utils/lib_go.sh \
+		utils/lib_govm.sh \
 		utils/lib_nvm.sh \
 		utils/lib_redis.sh \
-		utils/searxng.sh \
-		utils/lxc.sh \
-		utils/lxc-searxng.env \
-		utils/searx.sh \
-		utils/filtron.sh \
-		utils/morty.sh
+		utils/lib_valkey.sh \
+		utils/searxng.sh
 	$(Q)$(MTOOLS) build_msg TEST "$@ OK"
 
+PHONY += format
+format: format.python format.shell
 
 # wrap ./manage script
 
 MANAGE += weblate.translations.commit weblate.push.translations
-MANAGE += data.all data.traits data.useragents data.locales
+MANAGE += data.all data.traits data.useragents data.locales data.currencies
 MANAGE += docs.html docs.live docs.gh-pages docs.prebuild docs.clean
-MANAGE += docker.build docker.push docker.buildx
+MANAGE += podman.build
+MANAGE += docker.build docker.buildx
+MANAGE += container.build container.test container.push
 MANAGE += gecko.driver
 MANAGE += node.env node.env.dev node.clean
 MANAGE += py.build py.clean
 MANAGE += pyenv pyenv.install pyenv.uninstall
-MANAGE += format.python
-MANAGE += test.yamllint test.pylint test.pyright test.black test.pybabel test.unit test.coverage test.robot test.rst test.clean
-MANAGE += themes.all themes.simple themes.simple.test pygments.less
+MANAGE += format.python format.shell
+MANAGE += test.yamllint test.pylint test.black test.pybabel test.unit test.coverage test.robot test.rst test.clean test.themes test.pyright test.pyright_modified test.shfmt
+MANAGE += themes.all themes.simple themes.simple.analyze themes.fix themes.lint themes.test
 MANAGE += static.build.commit static.build.drop static.build.restore
 MANAGE += nvm.install nvm.clean nvm.status nvm.nodejs
+MANAGE += go.env.dev go.clean
 
 PHONY += $(MANAGE)
 
@@ -95,8 +86,8 @@ $(MANAGE):
 
 # short hands of selected targets
 
-PHONY += docs docker themes
+PHONY += docs container themes
 
 docs: docs.html
-docker:  docker.build
+container:  container.build
 themes: themes.all

PULL_REQUEST_TEMPLATE.md

@@ -1,25 +1,34 @@
-## What does this PR do?
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
 
-<!-- MANDATORY -->
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+-->
 
-<!-- explain the changes in your PR, algorithms, design, architecture -->
+### What does this PR do?
 
-## Why is this change important?
+<!-- Explain the motivation and changes in your pull request.  -->
 
-<!-- MANDATORY -->
+### How to test this PR locally?
 
-<!-- explain the motivation behind your PR -->
+<!-- Commands to run the tests or instructions to test the changes.  Are there
+     any edge cases (environment, language, or other contexts) to take into
+     account?  -->
 
-## How to test this PR locally?
-
-<!-- commands to run the tests or instructions to test the changes -->
-
-## Author's checklist
-
-<!-- additional notes for reviewers -->
-
-## Related issues
+### Related issues
 
 <!--
-Closes #234
+Closes: #234
 -->
+
+### Code of Conduct
+
+<!-- ⚠️ Bad AI drivers will be denounced: People who produce bad contributions
+     that are clearly AI (slop) will be blocked for all future contributions.
+     -->
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] **I hereby confirm that this PR conforms with the [AI Policy].**
+
+  If I have used AI tools for working on the changes in this PR, I will
+  attach a list of all AI tools I used and how I used them. I hereby confirm
+  that I haven't used any other tools than the ones I mention below.

README.rst

@@ -1,130 +1,62 @@
 .. SPDX-License-Identifier: AGPL-3.0-or-later
 
-----
-
-.. figure:: https://raw.githubusercontent.com/searxng/searxng/master/src/brand/searxng.svg
-   :target: https://docs.searxng.org/
-   :alt: SearXNG
-   :width: 100%
-   :align: center
-
-----
-
-Privacy-respecting, hackable `metasearch engine`_
-
-Searx.space_ lists ready-to-use running instances.
-
-A user_, admin_ and developer_ handbook is available on the homepage_.
-
-|SearXNG install|
-|SearXNG homepage|
-|SearXNG wiki|
-|AGPL License|
-|Issues|
-|commits|
-|weblate|
-|SearXNG logo|
-
-----
-
-.. _searx.space: https://searx.space
-.. _user: https://docs.searxng.org/user
-.. _admin: https://docs.searxng.org/admin
-.. _developer: https://docs.searxng.org/dev
-.. _homepage: https://docs.searxng.org/
 .. _metasearch engine: https://en.wikipedia.org/wiki/Metasearch_engine
+.. _Installation guide: https://docs.searxng.org/admin/installation.html
+.. _Configuration guide: https://docs.searxng.org/admin/settings/index.html
+.. _CONTRIBUTING: https://github.com/searxng/searxng/blob/master/CONTRIBUTING.rst
+.. _LICENSE: https://github.com/searxng/searxng/blob/master/LICENSE
 
-.. |SearXNG logo| image:: https://raw.githubusercontent.com/searxng/searxng/master/src/brand/searxng-wordmark.svg
-   :target: https://docs.searxng.org/
-   :width: 5%
+.. figure:: https://raw.githubusercontent.com/searxng/searxng/master/client/simple/src/brand/searxng.svg
+   :target: https://searxng.org
+   :alt: SearXNG
+   :width: 512px
 
-.. |SearXNG install| image:: https://img.shields.io/badge/-install-blue
-   :target: https://docs.searxng.org/admin/installation.html
 
-.. |SearXNG homepage| image:: https://img.shields.io/badge/-homepage-blue
-   :target: https://docs.searxng.org/
+SearXNG is a `metasearch engine`_. Users are neither tracked nor profiled.
 
-.. |SearXNG wiki| image:: https://img.shields.io/badge/-wiki-blue
-   :target: https://github.com/searxng/searxng/wiki
+.. image:: https://img.shields.io/badge/organization-3050ff?style=flat-square&logo=searxng&logoColor=fff&cacheSeconds=86400
+   :target: https://github.com/searxng
+   :alt: Organization
 
-.. |AGPL License|  image:: https://img.shields.io/badge/license-AGPL-blue.svg
+.. image:: https://img.shields.io/badge/documentation-3050ff?style=flat-square&logo=readthedocs&logoColor=fff&cacheSeconds=86400
+   :target: https://docs.searxng.org
+   :alt: Documentation
+
+.. image:: https://img.shields.io/github/license/searxng/searxng?style=flat-square&label=license&color=3050ff&cacheSeconds=86400
    :target: https://github.com/searxng/searxng/blob/master/LICENSE
+   :alt: License
 
-.. |Issues| image:: https://img.shields.io/github/issues/searxng/searxng?color=yellow&label=issues
-   :target: https://github.com/searxng/searxng/issues
+.. image:: https://img.shields.io/github/commit-activity/y/searxng/searxng/master?style=flat-square&label=commits&color=3050ff&cacheSeconds=3600
+   :target: https://github.com/searxng/searxng/commits/master/
+   :alt: Commits
 
-.. |PR| image:: https://img.shields.io/github/issues-pr-raw/searxng/searxng?color=yellow&label=PR
-   :target: https://github.com/searxng/searxng/pulls
-
-.. |commits| image:: https://img.shields.io/github/commit-activity/y/searxng/searxng?color=yellow&label=commits
-   :target: https://github.com/searxng/searxng/commits/master
-
-.. |weblate| image:: https://translate.codeberg.org/widgets/searxng/-/searxng/svg-badge.svg
+.. image:: https://img.shields.io/weblate/progress/searxng?server=https%3A%2F%2Ftranslate.codeberg.org&style=flat-square&label=translated&color=3050ff&cacheSeconds=86400
    :target: https://translate.codeberg.org/projects/searxng/
-
-
-Contact
-=======
-
-Ask questions or chat with the SearXNG community (this not a chatbot) on
-
-IRC
-  `#searxng on libera.chat <https://web.libera.chat/?channel=#searxng>`_
-  which is bridged to Matrix.
-
-Matrix
-  `#searxng:matrix.org <https://matrix.to/#/#searxng:matrix.org>`_
-
+   :alt: Translated
 
 Setup
 =====
 
-- A well maintained `Docker image`_, also built for ARM64 and ARM/v7
-  architectures.
-- Alternatively there are *up to date* `installation scripts`_.
-- For individual setup consult our detailed `Step by step`_ instructions.
-- To fine-tune your instance, take a look at the `Administrator documentation`_.
+To install SearXNG, see `Installation guide`_.
 
-.. _Administrator documentation: https://docs.searxng.org/admin/index.html
-.. _Step by step: https://docs.searxng.org/admin/installation-searxng.html
-.. _installation scripts: https://docs.searxng.org/admin/installation-scripts.html
-.. _Docker image: https://github.com/searxng/searxng-docker
+To fine-tune SearXNG, see `Configuration guide`_.
 
-Translations
-============
+Further information on *how-to* can be found `here <https://docs.searxng.org/admin/index.html>`_.
 
-.. _Weblate: https://translate.codeberg.org/projects/searxng/searxng/
+Connect
+=======
 
-Help translate SearXNG at `Weblate`_
-
-.. figure:: https://translate.codeberg.org/widgets/searxng/-/multi-auto.svg
-   :target: https://translate.codeberg.org/projects/searxng/
+If you have questions or want to connect with others in the community:
 
+- `#searxng:matrix.org <https://matrix.to/#/#searxng:matrix.org>`_
 
 Contributing
 ============
 
-.. _development quickstart: https://docs.searxng.org/dev/quickstart.html
-.. _developer documentation: https://docs.searxng.org/dev/index.html
+See CONTRIBUTING_ for more details.
 
-Are you a developer?  Have a look at our `development quickstart`_ guide, it's
-very easy to contribute.  Additionally we have a `developer documentation`_.
+License
+=======
 
-
-Codespaces
-==========
-
-You can contribute from your browser using `GitHub Codespaces`_:
-
-- Fork the repository
-- Click on the ``<> Code`` green button
-- Click on the ``Codespaces`` tab instead of ``Local``
-- Click on ``Create codespace on master``
-- VSCode is going to start in the browser
-- Wait for ``git pull && make install`` to appear and then disappear
-- You have `120 hours per month`_ (see also your `list of existing Codespaces`_)
-- You can start SearXNG using ``make run`` in the terminal or by pressing ``Ctrl+Shift+B``
-
-.. _GitHub Codespaces: https://docs.github.com/en/codespaces/overview
-.. _120 hours per month: https://github.com/settings/billing
-.. _list of existing Codespaces: https://github.com/codespaces
+This project is licensed under the GNU Affero General Public License (AGPL-3.0).
+See LICENSE_ for more details.

client/simple/.gitignore

@@ -0,0 +1,2 @@
+dist
+node_modules

client/simple/.stylelintrc.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json.schemastore.org/stylelintrc.json",
+  "plugins": ["stylelint-prettier"],
+  "extends": ["stylelint-config-standard-less"],
+  "rules": {
+    "at-rule-no-vendor-prefix": null,
+    "at-rule-prelude-no-invalid": null,
+    "declaration-empty-line-before": null,
+    "declaration-property-value-no-unknown": null,
+    "no-invalid-position-at-import-rule": null,
+    "prettier/prettier": true,
+    "property-no-vendor-prefix": null,
+    "selector-attribute-quotes": null,
+    "selector-class-pattern": null,
+    "selector-id-pattern": null,
+    "selector-no-vendor-prefix": null,
+    "shorthand-property-no-redundant-values": null
+  }
+}

client/simple/README.rst

@@ -0,0 +1,24 @@
+=====================
+MEMO vite development
+=====================
+
+Local install::
+
+  # in folder ./client/simple/
+  $ npm install
+
+Start development server::
+
+  $ ./manage vite.simple.dev
+
+  # in folder ./client/simple/
+  $ npm exec -- vite
+
+Fix source code::
+
+  # in folder ./client/simple/
+  $ npm run fix
+
+Fix & Build::
+
+  $ ./manage vite.simple.build

client/simple/biome.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "files": {
+    "ignoreUnknown": true,
+    "includes": ["**", "!node_modules", "!src/brand", "!src/svg"]
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "preset": "recommended",
+      "source": {
+        "useSortedAttributes": "on",
+        "useSortedProperties": "on"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "bracketSameLine": false,
+    "bracketSpacing": true,
+    "formatWithErrors": false,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 120
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended",
+      "complexity": {
+        "noForEach": "error",
+        "noImplicitCoercions": "error",
+        "noRedundantDefaultExport": "error",
+        "noUselessCatchBinding": "error",
+        "noUselessUndefined": "error",
+        "useArrayFind": "error",
+        "useSimplifiedLogicExpression": "error"
+      },
+      "correctness": {
+        "noGlobalDirnameFilename": "error",
+        "useImportExtensions": "error",
+        "useJsonImportAttributes": "error",
+        "useSingleJsDocAsterisk": "error"
+      },
+      "nursery": {
+        "noFloatingPromises": "warn",
+        "noMisusedPromises": "warn",
+        "useAwaitThenable": "off",
+        "useExhaustiveSwitchCases": "warn",
+        "useExplicitType": "off",
+        "useRegexpExec": "warn"
+      },
+      "performance": {
+        "noAwaitInLoops": "error",
+        "noBarrelFile": "error",
+        "noDelete": "error",
+        "noNamespaceImport": "error",
+        "noReExportAll": "error",
+        "useTopLevelRegex": "error"
+      },
+      "style": {
+        "noCommonJs": "error",
+        "noEnum": "error",
+        "noImplicitBoolean": "error",
+        "noIncrementDecrement": "error",
+        "noInferrableTypes": "error",
+        "noMultiAssign": "error",
+        "noMultilineString": "error",
+        "noNamespace": "error",
+        "noNegationElse": "error",
+        "noNestedTernary": "error",
+        "noParameterAssign": "error",
+        "noParameterProperties": "error",
+        "noSubstr": "error",
+        "noUnusedTemplateLiteral": "error",
+        "noUselessElse": "error",
+        "noYodaExpression": "error",
+        "useAsConstAssertion": "error",
+        "useAtIndex": "error",
+        "useCollapsedElseIf": "error",
+        "useCollapsedIf": "error",
+        "useConsistentArrayType": {
+          "level": "error",
+          "options": {
+            "syntax": "shorthand"
+          }
+        },
+        "useConsistentBuiltinInstantiation": "error",
+        "useConsistentEnumValueType": "error",
+        "useConsistentMemberAccessibility": {
+          "level": "error",
+          "options": {
+            "accessibility": "explicit"
+          }
+        },
+        "useConsistentObjectDefinitions": {
+          "level": "error",
+          "options": {
+            "syntax": "explicit"
+          }
+        },
+        "useConsistentTypeDefinitions": {
+          "level": "error",
+          "options": {
+            "style": "type"
+          }
+        },
+        "useDefaultSwitchClause": "error",
+        "useDestructuring": "error",
+        "useExplicitLengthCheck": "error",
+        "useForOf": "error",
+        "useGroupedAccessorPairs": "error",
+        "useNumberNamespace": "error",
+        "useNumericSeparators": "error",
+        "useObjectSpread": "error",
+        "useReadonlyClassProperties": "error",
+        "useSelfClosingElements": "error",
+        "useShorthandAssign": "error",
+        "useSingleVarDeclarator": "error",
+        "useThrowNewError": "error",
+        "useThrowOnlyError": "error",
+        "useTrimStartEnd": "error",
+        "useUnifiedTypeSignatures": "error"
+      },
+      "suspicious": {
+        "noBitwiseOperators": "error",
+        "noConstantBinaryExpressions": "error",
+        "noDeprecatedImports": "error",
+        "noEmptyBlockStatements": "error",
+        "noEqualsToNull": "error",
+        "noEvolvingTypes": "error",
+        "noForIn": "error",
+        "noImportCycles": "error",
+        "noNestedPromises": "error",
+        "noParametersOnlyUsedInRecursion": "error",
+        "noReturnAssign": "error",
+        "noUnassignedVariables": "error",
+        "noVar": "error",
+        "useNumberToFixedDigitsArgument": "error",
+        "useStaticResponseMethods": "error"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "arrowParentheses": "always",
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "none"
+    }
+  }
+}

client/simple/generated/pygments.less

@@ -0,0 +1,177 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/*
+   this file is generated automatically by searxng_extra/update/update_pygments.py
+   using pygments version 2.20.0:
+
+       ./manage templates.simple.pygments
+*/
+
+
+.code-highlight {
+
+  pre { line-height: 125%; }
+  td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
+  span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
+  td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
+  span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
+  .hll { background-color: #ffffcc }
+  .c { color: #3D7B7B; font-style: italic } /* Comment */
+  .err { border: 1px solid #F00 } /* Error */
+  .k { color: #008000; font-weight: bold } /* Keyword */
+  .o { color: #666 } /* Operator */
+  .ch { color: #3D7B7B; font-style: italic } /* Comment.Hashbang */
+  .cm { color: #3D7B7B; font-style: italic } /* Comment.Multiline */
+  .cp { color: #9C6500 } /* Comment.Preproc */
+  .cpf { color: #3D7B7B; font-style: italic } /* Comment.PreprocFile */
+  .c1 { color: #3D7B7B; font-style: italic } /* Comment.Single */
+  .cs { color: #3D7B7B; font-style: italic } /* Comment.Special */
+  .gd { color: #A00000 } /* Generic.Deleted */
+  .ge { font-style: italic } /* Generic.Emph */
+  .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */
+  .gr { color: #E40000 } /* Generic.Error */
+  .gh { color: #000080; font-weight: bold } /* Generic.Heading */
+  .gi { color: #008400 } /* Generic.Inserted */
+  .go { color: #717171 } /* Generic.Output */
+  .gp { color: #000080; font-weight: bold } /* Generic.Prompt */
+  .gs { font-weight: bold } /* Generic.Strong */
+  .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
+  .gt { color: #04D } /* Generic.Traceback */
+  .kc { color: #008000; font-weight: bold } /* Keyword.Constant */
+  .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */
+  .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */
+  .kp { color: #008000 } /* Keyword.Pseudo */
+  .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */
+  .kt { color: #B00040 } /* Keyword.Type */
+  .m { color: #666 } /* Literal.Number */
+  .s { color: #BA2121 } /* Literal.String */
+  .na { color: #687822 } /* Name.Attribute */
+  .nb { color: #008000 } /* Name.Builtin */
+  .nc { color: #00F; font-weight: bold } /* Name.Class */
+  .no { color: #800 } /* Name.Constant */
+  .nd { color: #A2F } /* Name.Decorator */
+  .ni { color: #717171; font-weight: bold } /* Name.Entity */
+  .ne { color: #CB3F38; font-weight: bold } /* Name.Exception */
+  .nf { color: #00F } /* Name.Function */
+  .nl { color: #767600 } /* Name.Label */
+  .nn { color: #00F; font-weight: bold } /* Name.Namespace */
+  .nt { color: #008000; font-weight: bold } /* Name.Tag */
+  .nv { color: #19177C } /* Name.Variable */
+  .ow { color: #A2F; font-weight: bold } /* Operator.Word */
+  .w { color: #BBB } /* Text.Whitespace */
+  .mb { color: #666 } /* Literal.Number.Bin */
+  .mf { color: #666 } /* Literal.Number.Float */
+  .mh { color: #666 } /* Literal.Number.Hex */
+  .mi { color: #666 } /* Literal.Number.Integer */
+  .mo { color: #666 } /* Literal.Number.Oct */
+  .sa { color: #BA2121 } /* Literal.String.Affix */
+  .sb { color: #BA2121 } /* Literal.String.Backtick */
+  .sc { color: #BA2121 } /* Literal.String.Char */
+  .dl { color: #BA2121 } /* Literal.String.Delimiter */
+  .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
+  .s2 { color: #BA2121 } /* Literal.String.Double */
+  .se { color: #AA5D1F; font-weight: bold } /* Literal.String.Escape */
+  .sh { color: #BA2121 } /* Literal.String.Heredoc */
+  .si { color: #A45A77; font-weight: bold } /* Literal.String.Interpol */
+  .sx { color: #008000 } /* Literal.String.Other */
+  .sr { color: #A45A77 } /* Literal.String.Regex */
+  .s1 { color: #BA2121 } /* Literal.String.Single */
+  .ss { color: #19177C } /* Literal.String.Symbol */
+  .bp { color: #008000 } /* Name.Builtin.Pseudo */
+  .fm { color: #00F } /* Name.Function.Magic */
+  .vc { color: #19177C } /* Name.Variable.Class */
+  .vg { color: #19177C } /* Name.Variable.Global */
+  .vi { color: #19177C } /* Name.Variable.Instance */
+  .vm { color: #19177C } /* Name.Variable.Magic */
+  .il { color: #666 } /* Literal.Number.Integer.Long */
+}
+
+.code-highlight-dark(){
+  .code-highlight {
+
+    pre { line-height: 125%; }
+    td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
+    span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
+    td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
+    span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
+    .hll { background-color: #49483e }
+    .c { color: #959077 } /* Comment */
+    .err { color: #ED007E; background-color: #1E0010 } /* Error */
+    .esc { color: #F8F8F2 } /* Escape */
+    .g { color: #F8F8F2 } /* Generic */
+    .k { color: #66D9EF } /* Keyword */
+    .l { color: #AE81FF } /* Literal */
+    .n { color: #F8F8F2 } /* Name */
+    .o { color: #FF4689 } /* Operator */
+    .x { color: #F8F8F2 } /* Other */
+    .p { color: #F8F8F2 } /* Punctuation */
+    .ch { color: #959077 } /* Comment.Hashbang */
+    .cm { color: #959077 } /* Comment.Multiline */
+    .cp { color: #959077 } /* Comment.Preproc */
+    .cpf { color: #959077 } /* Comment.PreprocFile */
+    .c1 { color: #959077 } /* Comment.Single */
+    .cs { color: #959077 } /* Comment.Special */
+    .gd { color: #FF4689 } /* Generic.Deleted */
+    .ge { color: #F8F8F2; font-style: italic } /* Generic.Emph */
+    .ges { color: #F8F8F2; font-weight: bold; font-style: italic } /* Generic.EmphStrong */
+    .gr { color: #F8F8F2 } /* Generic.Error */
+    .gh { color: #F8F8F2 } /* Generic.Heading */
+    .gi { color: #A6E22E } /* Generic.Inserted */
+    .go { color: #66D9EF } /* Generic.Output */
+    .gp { color: #FF4689; font-weight: bold } /* Generic.Prompt */
+    .gs { color: #F8F8F2; font-weight: bold } /* Generic.Strong */
+    .gu { color: #959077 } /* Generic.Subheading */
+    .gt { color: #F8F8F2 } /* Generic.Traceback */
+    .kc { color: #66D9EF } /* Keyword.Constant */
+    .kd { color: #66D9EF } /* Keyword.Declaration */
+    .kn { color: #FF4689 } /* Keyword.Namespace */
+    .kp { color: #66D9EF } /* Keyword.Pseudo */
+    .kr { color: #66D9EF } /* Keyword.Reserved */
+    .kt { color: #66D9EF } /* Keyword.Type */
+    .ld { color: #E6DB74 } /* Literal.Date */
+    .m { color: #AE81FF } /* Literal.Number */
+    .s { color: #E6DB74 } /* Literal.String */
+    .na { color: #A6E22E } /* Name.Attribute */
+    .nb { color: #F8F8F2 } /* Name.Builtin */
+    .nc { color: #A6E22E } /* Name.Class */
+    .no { color: #66D9EF } /* Name.Constant */
+    .nd { color: #A6E22E } /* Name.Decorator */
+    .ni { color: #F8F8F2 } /* Name.Entity */
+    .ne { color: #A6E22E } /* Name.Exception */
+    .nf { color: #A6E22E } /* Name.Function */
+    .nl { color: #F8F8F2 } /* Name.Label */
+    .nn { color: #F8F8F2 } /* Name.Namespace */
+    .nx { color: #A6E22E } /* Name.Other */
+    .py { color: #F8F8F2 } /* Name.Property */
+    .nt { color: #FF4689 } /* Name.Tag */
+    .nv { color: #F8F8F2 } /* Name.Variable */
+    .ow { color: #FF4689 } /* Operator.Word */
+    .pm { color: #F8F8F2 } /* Punctuation.Marker */
+    .w { color: #F8F8F2 } /* Text.Whitespace */
+    .mb { color: #AE81FF } /* Literal.Number.Bin */
+    .mf { color: #AE81FF } /* Literal.Number.Float */
+    .mh { color: #AE81FF } /* Literal.Number.Hex */
+    .mi { color: #AE81FF } /* Literal.Number.Integer */
+    .mo { color: #AE81FF } /* Literal.Number.Oct */
+    .sa { color: #E6DB74 } /* Literal.String.Affix */
+    .sb { color: #E6DB74 } /* Literal.String.Backtick */
+    .sc { color: #E6DB74 } /* Literal.String.Char */
+    .dl { color: #E6DB74 } /* Literal.String.Delimiter */
+    .sd { color: #E6DB74 } /* Literal.String.Doc */
+    .s2 { color: #E6DB74 } /* Literal.String.Double */
+    .se { color: #AE81FF } /* Literal.String.Escape */
+    .sh { color: #E6DB74 } /* Literal.String.Heredoc */
+    .si { color: #E6DB74 } /* Literal.String.Interpol */
+    .sx { color: #E6DB74 } /* Literal.String.Other */
+    .sr { color: #E6DB74 } /* Literal.String.Regex */
+    .s1 { color: #E6DB74 } /* Literal.String.Single */
+    .ss { color: #E6DB74 } /* Literal.String.Symbol */
+    .bp { color: #F8F8F2 } /* Name.Builtin.Pseudo */
+    .fm { color: #A6E22E } /* Name.Function.Magic */
+    .vc { color: #F8F8F2 } /* Name.Variable.Class */
+    .vg { color: #F8F8F2 } /* Name.Variable.Global */
+    .vi { color: #F8F8F2 } /* Name.Variable.Instance */
+    .vm { color: #F8F8F2 } /* Name.Variable.Magic */
+    .il { color: #AE81FF } /* Literal.Number.Integer.Long */
+  }
+}

client/simple/package.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@searxng/theme-simple",
+  "version": "0.0.0",
+  "private": true,
+  "license": "AGPL-3.0",
+  "type": "module",
+  "scripts": {
+    "build": "npm run build:icons && npm run build:vite",
+    "build:icons": "node theme_icons.ts",
+    "build:vite": "vite build",
+    "clean": "rm -Rf node_modules",
+    "fix": "npm run fix:stylelint && npm run fix:biome && npm run fix:package",
+    "fix:biome": "biome check --write",
+    "fix:package": "sort-package-json --quiet",
+    "fix:stylelint": "stylelint --fix strict 'src/**/*.{scss,sass,less,styl}'",
+    "lint": "npm run lint:biome && npm run lint:tsc",
+    "lint:biome": "biome lint",
+    "lint:tsc": "tsc --noEmit"
+  },
+  "browserslist": [
+    "baseline 2022",
+    "not dead"
+  ],
+  "dependencies": {
+    "ionicons": "^8.0.13",
+    "normalize.css": "8.0.1",
+    "ol": "^10.9.0",
+    "swiped-events": "1.2.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.3",
+    "@types/node": "^26.1.1",
+    "browserslist": "^4.28.6",
+    "browserslist-to-esbuild": "^2.1.1",
+    "edge.js": "^6.5.1",
+    "less": "^4.6.7",
+    "mathjs": "^15.2.0",
+    "sharp": "~0.35.3",
+    "sort-package-json": "^4.0.0",
+    "stylelint": "^17.14.0",
+    "stylelint-config-standard-less": "^4.1.0",
+    "stylelint-prettier": "^5.0.3",
+    "svgo": "^4.0.2",
+    "typescript": "~7.0.2",
+    "vite": "^8.1.4",
+    "vite-bundle-analyzer": "^1.3.8"
+  }
+}

client/simple/src/brand/img_load_error.svg

@@ -50,17 +50,17 @@
   </metadata>
   <path
      d="M 39.581382,41.421315 H 30.62689 v -1.21543 q 0,-2.033984 0.818554,-3.59668 0.818555,-1.5875 3.447852,-4.018359 l 1.5875,-1.438672 q 1.413867,-1.289844 2.058789,-2.43086 0.669727,-1.141015 0.669727,-2.282031 0,-1.736328 -1.190625,-2.703711 -1.190625,-0.992188 -3.323828,-0.992188 -2.00918,0 -4.340821,0.84336 -2.331641,0.818554 -4.861719,2.455664 v -7.788673 q 3.001367,-1.041796 5.481836,-1.53789 2.480469,-0.496094 4.787305,-0.496094 6.052344,0 9.227344,2.480469 3.175001,2.455664 3.175001,7.19336 0,2.430859 -0.967383,4.365625 -0.967383,1.909961 -3.299024,4.117578 l -1.5875,1.413868 q -1.686719,1.53789 -2.207617,2.480469 -0.520899,0.917773 -0.520899,2.033984 z m -8.954492,3.671094 h 8.954492 v 8.830469 H 30.62689 Z"
-     style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.80000305px;line-height:1;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans Bold';display:inline;fill:#db3434;fill-opacity:1;stroke-width:0.26458335"
+     style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:50.80000305px;line-height:1;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans Bold';display:inline;fill:#808080;fill-opacity:1;stroke-width:0.26458335"
      id="path827"
      inkscape:connector-curvature="0" />
   <circle
-     style="fill:none;fill-opacity:1;stroke:#db3434;stroke-width:10;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     style="fill:none;fill-opacity:1;stroke:#808080;stroke-width:10;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
      id="path834"
      cx="35"
      cy="36.486031"
      r="30" />
   <rect
-     style="opacity:1;fill:#db3434;fill-opacity:1;stroke:none;stroke-width:8;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     style="opacity:1;fill:#808080;fill-opacity:1;stroke:none;stroke-width:8;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
      id="rect912"
      width="18.846331"
      height="39.963303"

client/simple/src/js/Plugin.ts

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**
+ * Base class for client-side plugins.
+ *
+ * @remarks
+ * Handle conditional loading of the plugin in:
+ *
+ *   - client/simple/src/js/router.ts
+ *
+ * @abstract
+ */
+export abstract class Plugin {
+  /**
+   * Plugin name.
+   */
+  protected readonly id: string;
+
+  /**
+   * @remarks
+   * Don't hold references of this instance outside the class.
+   */
+  protected constructor(id: string) {
+    this.id = id;
+
+    queueMicrotask(() => this.invoke());
+  }
+
+  private async invoke(): Promise<void> {
+    try {
+      console.debug(`[PLUGIN] ${this.id}: Running...`);
+      const result = await this.run();
+      if (!result) return;
+
+      console.debug(`[PLUGIN] ${this.id}: Running post-exec...`);
+      // @ts-expect-error
+      void (await this.post(result as NonNullable<Awaited<ReturnType<this["run"]>>>));
+    } catch (error) {
+      console.error(`[PLUGIN] ${this.id}:`, error);
+    } finally {
+      console.debug(`[PLUGIN] ${this.id}: Done.`);
+    }
+  }
+
+  /**
+   * Plugin goes here.
+   *
+   * @remarks
+   * The plugin is already loaded at this point. If you wish to execute
+   * conditions to exit early, consider moving the logic to:
+   *
+   *   - client/simple/src/js/router.ts
+   *
+   * ...to avoid unnecessarily loading this plugin on the client.
+   */
+  protected abstract run(): Promise<unknown>;
+
+  /**
+   * Post-execution hook.
+   *
+   * @remarks
+   * The hook is only executed if `#run()` returns a truthy value.
+   */
+  // @ts-expect-error
+  protected abstract post(result: NonNullable<Awaited<ReturnType<this["run"]>>>): Promise<void>;
+}

client/simple/src/js/index.ts

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+// core
+void import.meta.glob(["./*.ts", "./util/**/.ts"], { eager: true });

client/simple/src/js/loader.ts

@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import type { Plugin } from "./Plugin.ts";
+import { type EndpointsKeys, endpoint } from "./toolkit.ts";
+
+type Options =
+  | {
+      on: "global";
+    }
+  | {
+      on: "endpoint";
+      where: EndpointsKeys[];
+    };
+
+export const load = <T extends Plugin>(instance: () => Promise<T>, options: Options): void => {
+  if (!check(options)) return;
+
+  void instance();
+};
+
+const check = (options: Options): boolean => {
+  // biome-ignore lint/style/useDefaultSwitchClause: options is typed
+  switch (options.on) {
+    case "global": {
+      return true;
+    }
+    case "endpoint": {
+      if (!options.where.includes(endpoint)) {
+        // not on the expected endpoint
+        return false;
+      }
+
+      return true;
+    }
+  }
+};

client/simple/src/js/main/autocomplete.ts

@@ -0,0 +1,142 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { http, listen, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
+
+const fetchResults = async (qInput: HTMLInputElement, query: string): Promise<void> => {
+  try {
+    let res: Response;
+
+    if (settings.method === "GET") {
+      res = await http("GET", `./autocompleter?q=${query}`);
+    } else {
+      res = await http("POST", "./autocompleter", { body: new URLSearchParams({ q: query }) });
+    }
+
+    const results = await res.json();
+
+    const autocomplete = document.querySelector<HTMLElement>(".autocomplete");
+    assertElement(autocomplete);
+
+    const autocompleteList = document.querySelector<HTMLUListElement>(".autocomplete ul");
+    assertElement(autocompleteList);
+
+    autocomplete.classList.add("open");
+    autocompleteList.replaceChildren();
+
+    // show an error message that no result was found
+    if (results?.[1]?.length === 0) {
+      const noItemFoundMessage = Object.assign(document.createElement("li"), {
+        className: "no-item-found",
+        textContent: settings.translations?.no_item_found ?? "No results found"
+      });
+      autocompleteList.append(noItemFoundMessage);
+      return;
+    }
+
+    const fragment = new DocumentFragment();
+
+    for (const result of results[1]) {
+      const li = Object.assign(document.createElement("li"), { textContent: result });
+
+      listen("mousedown", li, () => {
+        qInput.value = result;
+
+        const form = document.querySelector<HTMLFormElement>("#search");
+        form?.submit();
+      });
+
+      fragment.append(li);
+    }
+
+    autocompleteList.append(fragment);
+  } catch (error) {
+    console.error("Error fetching autocomplete results:", error);
+  }
+};
+
+const qInput = document.getElementById("q") as HTMLInputElement | null;
+assertElement(qInput);
+
+let timeoutId: number;
+
+listen("input", qInput, () => {
+  clearTimeout(timeoutId);
+
+  const query = qInput.value;
+  const minLength = settings.autocomplete_min ?? 2;
+
+  if (query.length < minLength) return;
+
+  timeoutId = window.setTimeout(async () => {
+    if (query === qInput.value) {
+      await fetchResults(qInput, query);
+    }
+  }, 300);
+});
+
+const autocomplete: HTMLElement | null = document.querySelector<HTMLElement>(".autocomplete");
+const autocompleteList: HTMLUListElement | null = document.querySelector<HTMLUListElement>(".autocomplete ul");
+if (autocompleteList) {
+  listen("keydown", qInput, (event: KeyboardEvent) => {
+    if (event.key === "Escape") {
+      autocomplete?.classList.remove("open");
+    }
+  });
+  listen("keyup", qInput, (event: KeyboardEvent) => {
+    const listItems = [...autocompleteList.children] as HTMLElement[];
+
+    const currentIndex = listItems.findIndex((item) => item.classList.contains("active"));
+    let newCurrentIndex = -1;
+
+    switch (event.key) {
+      case "ArrowUp": {
+        const currentItem = listItems[currentIndex];
+        if (currentItem && currentIndex >= 0) {
+          currentItem.classList.remove("active");
+        }
+        // we need to add listItems.length to the index calculation here because the JavaScript modulos
+        // operator doesn't work with negative numbers
+        newCurrentIndex = (currentIndex - 1 + listItems.length) % listItems.length;
+        break;
+      }
+      case "ArrowDown": {
+        const currentItem = listItems[currentIndex];
+        if (currentItem && currentIndex >= 0) {
+          currentItem.classList.remove("active");
+        }
+        newCurrentIndex = (currentIndex + 1) % listItems.length;
+        break;
+      }
+      case "Enter":
+        if (autocomplete) {
+          autocomplete.classList.remove("open");
+        }
+        break;
+      default:
+        break;
+    }
+
+    if (newCurrentIndex !== -1) {
+      const selectedItem = listItems[newCurrentIndex];
+      if (selectedItem) {
+        selectedItem.classList.add("active");
+
+        if (!selectedItem.classList.contains("no-item-found")) {
+          const qInput = document.getElementById("q") as HTMLInputElement | null;
+          if (qInput) {
+            qInput.value = selectedItem.textContent ?? "";
+          }
+        }
+      }
+    }
+  });
+
+  listen("blur", qInput, () => {
+    autocomplete?.classList.remove("open");
+  });
+
+  listen("focus", qInput, () => {
+    autocomplete?.classList.add("open");
+  });
+}

client/simple/src/js/main/keyboard.ts

@@ -0,0 +1,488 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { listen, mutable, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
+
+export type KeyBindingLayout = "default" | "vim";
+
+type KeyBinding = {
+  key: string;
+  fun: (event: KeyboardEvent) => void;
+  des: string;
+  cat: string;
+};
+
+type HighlightResultElement = "down" | "up" | "visible" | "bottom" | "top";
+
+/* common base for layouts */
+const baseKeyBinding: Record<string, KeyBinding> = {
+  Escape: {
+    key: "ESC",
+    fun: (event: KeyboardEvent) => removeFocus(event),
+    des: "remove focus from the focused input",
+    cat: "Control"
+  },
+  c: {
+    key: "c",
+    fun: () => copyURLToClipboard(),
+    des: "copy url of the selected result to the clipboard",
+    cat: "Results"
+  },
+  h: {
+    key: "h",
+    fun: () => toggleHelp(keyBindings),
+    des: "toggle help window",
+    cat: "Other"
+  },
+  i: {
+    key: "i",
+    fun: () => searchInputFocus(),
+    des: "focus on the search input",
+    cat: "Control"
+  },
+  n: {
+    key: "n",
+    fun: () => GoToNextPage(),
+    des: "go to next page",
+    cat: "Results"
+  },
+  o: {
+    key: "o",
+    fun: () => openResult(false),
+    des: "open search result",
+    cat: "Results"
+  },
+  p: {
+    key: "p",
+    fun: () => GoToPreviousPage(),
+    des: "go to previous page",
+    cat: "Results"
+  },
+  r: {
+    key: "r",
+    fun: () => reloadPage(),
+    des: "reload page from the server",
+    cat: "Control"
+  },
+  t: {
+    key: "t",
+    fun: () => openResult(true),
+    des: "open the result in a new tab",
+    cat: "Results"
+  }
+};
+
+const keyBindingLayouts: Record<KeyBindingLayout, Record<string, KeyBinding>> = {
+  // SearXNG layout
+  default: {
+    ArrowLeft: {
+      key: "←",
+      fun: () => highlightResult("up")(),
+      des: "select previous search result",
+      cat: "Results"
+    },
+    ArrowRight: {
+      key: "→",
+      fun: () => highlightResult("down")(),
+      des: "select next search result",
+      cat: "Results"
+    },
+    ...baseKeyBinding
+  },
+
+  // Vim-like keyboard layout
+  vim: {
+    b: {
+      key: "b",
+      fun: () => scrollPage(-window.innerHeight),
+      des: "scroll one page up",
+      cat: "Navigation"
+    },
+    d: {
+      key: "d",
+      fun: () => scrollPage(window.innerHeight / 2),
+      des: "scroll half a page down",
+      cat: "Navigation"
+    },
+    f: {
+      key: "f",
+      fun: () => scrollPage(window.innerHeight),
+      des: "scroll one page down",
+      cat: "Navigation"
+    },
+    g: {
+      key: "g",
+      fun: () => scrollPageTo(-document.body.scrollHeight, "top"),
+      des: "scroll to the top of the page",
+      cat: "Navigation"
+    },
+    j: {
+      key: "j",
+      fun: () => highlightResult("down")(),
+      des: "select next search result",
+      cat: "Results"
+    },
+    k: {
+      key: "k",
+      fun: () => highlightResult("up")(),
+      des: "select previous search result",
+      cat: "Results"
+    },
+    u: {
+      key: "u",
+      fun: () => scrollPage(-window.innerHeight / 2),
+      des: "scroll half a page up",
+      cat: "Navigation"
+    },
+    v: {
+      key: "v",
+      fun: () => scrollPageTo(document.body.scrollHeight, "bottom"),
+      des: "scroll to the bottom of the page",
+      cat: "Navigation"
+    },
+    y: {
+      key: "y",
+      fun: () => copyURLToClipboard(),
+      des: "copy url of the selected result to the clipboard",
+      cat: "Results"
+    },
+    ...baseKeyBinding
+  }
+};
+
+const keyBindings: Record<string, KeyBinding> =
+  settings.hotkeys && settings.hotkeys in keyBindingLayouts
+    ? keyBindingLayouts[settings.hotkeys]
+    : keyBindingLayouts.default;
+
+const isElementInDetail = (element?: HTMLElement): boolean => {
+  const ancestor = element?.closest(".detail, .result");
+  return ancestor?.classList.contains("detail") ?? false;
+};
+
+const getResultElement = (element?: HTMLElement): HTMLElement | undefined => {
+  return element?.closest(".result") ?? undefined;
+};
+
+const isImageResult = (resultElement?: HTMLElement): boolean => {
+  return resultElement?.classList.contains("result-images") ?? false;
+};
+
+const highlightResult =
+  (which: HighlightResultElement | HTMLElement) =>
+  (noScroll?: boolean, keepFocus?: boolean): void => {
+    let effectiveWhich = which;
+    let current = document.querySelector<HTMLElement>(".result[data-vim-selected]");
+    if (!current) {
+      // no selection : choose the first one
+      current = document.querySelector<HTMLElement>(".result");
+      if (!current) {
+        // no first one : there are no results
+        return;
+      }
+      // replace up/down actions by selecting first one
+      if (which === "down" || which === "up") {
+        effectiveWhich = current;
+      }
+    }
+
+    const results = Array.from(document.querySelectorAll<HTMLElement>(".result"));
+
+    let next: HTMLElement | undefined;
+
+    if (typeof effectiveWhich === "string") {
+      switch (effectiveWhich) {
+        case "visible": {
+          const top = document.documentElement.scrollTop || document.body.scrollTop;
+          const bot = top + document.documentElement.clientHeight;
+
+          for (const element of results) {
+            const etop = element.offsetTop;
+            const ebot = etop + element.clientHeight;
+            if (ebot <= bot && etop > top) {
+              next = element;
+              break;
+            }
+          }
+          break;
+        }
+        case "down":
+          next = results[results.indexOf(current) + 1] || current;
+          break;
+        case "up":
+          next = results[results.indexOf(current) - 1] || current;
+          break;
+        case "bottom":
+          next = results.at(-1);
+          break;
+        // biome-ignore lint/complexity/noUselessSwitchCase: fallthrough is intended
+        case "top":
+        default:
+          [next] = results;
+      }
+    } else {
+      next = effectiveWhich;
+    }
+
+    if (next) {
+      current.removeAttribute("data-vim-selected");
+      next.setAttribute("data-vim-selected", "true");
+
+      if (!keepFocus) {
+        const link = next.querySelector<HTMLAnchorElement>("h3 a") || next.querySelector<HTMLAnchorElement>("a");
+        link?.focus();
+      }
+
+      if (!noScroll) {
+        mutable.scrollPageToSelected?.();
+      }
+    }
+  };
+
+const reloadPage = (): void => {
+  document.location.reload();
+};
+
+const removeFocus = (event: KeyboardEvent): void => {
+  const target = event.target as HTMLElement;
+  const tagName = target?.tagName?.toLowerCase();
+
+  if (document.activeElement && (tagName === "input" || tagName === "select" || tagName === "textarea")) {
+    (document.activeElement as HTMLElement).blur();
+  } else {
+    mutable.closeDetail?.();
+  }
+};
+
+const pageButtonClick = (css_selector: string): void => {
+  const button = document.querySelector<HTMLButtonElement>(css_selector);
+  if (button) {
+    button.click();
+  }
+};
+
+const GoToNextPage = (): void => {
+  pageButtonClick('nav#pagination .next_page button[type="submit"]');
+};
+
+const GoToPreviousPage = (): void => {
+  pageButtonClick('nav#pagination .previous_page button[type="submit"]');
+};
+
+mutable.scrollPageToSelected = (): void => {
+  const sel = document.querySelector<HTMLElement>(".result[data-vim-selected]");
+  if (!sel) return;
+
+  const wtop = document.documentElement.scrollTop || document.body.scrollTop;
+  const height = document.documentElement.clientHeight;
+  const etop = sel.offsetTop;
+  const ebot = etop + sel.clientHeight;
+  const offset = 120;
+
+  // first element ?
+  if (!sel.previousElementSibling && ebot < height) {
+    // set to the top of page if the first element
+    // is fully included in the viewport
+    window.scroll(window.scrollX, 0);
+    return;
+  }
+
+  if (wtop > etop - offset) {
+    window.scroll(window.scrollX, etop - offset);
+  } else {
+    const wbot = wtop + height;
+    if (wbot < ebot + offset) {
+      window.scroll(window.scrollX, ebot - height + offset);
+    }
+  }
+};
+
+const scrollPage = (amount: number): void => {
+  window.scrollBy(0, amount);
+  highlightResult("visible")();
+};
+
+const scrollPageTo = (position: number, nav: HighlightResultElement): void => {
+  window.scrollTo(0, position);
+  highlightResult(nav)();
+};
+
+const searchInputFocus = (): void => {
+  window.scrollTo(0, 0);
+
+  const q = document.querySelector<HTMLInputElement>("#q");
+  if (q) {
+    q.focus();
+
+    if (q.setSelectionRange) {
+      const len = q.value.length;
+
+      q.setSelectionRange(len, len);
+    }
+  }
+};
+
+const openResult = (newTab: boolean): void => {
+  let link = document.querySelector<HTMLAnchorElement>(".result[data-vim-selected] h3 a");
+  if (!link) {
+    link = document.querySelector<HTMLAnchorElement>(".result[data-vim-selected] > a");
+  }
+  if (!link) return;
+
+  const url = link.getAttribute("href");
+  if (url) {
+    if (newTab) {
+      window.open(url);
+    } else {
+      window.location.href = url;
+    }
+  }
+};
+
+const initHelpContent = (divElement: HTMLElement, keyBindings: typeof baseKeyBinding): void => {
+  const categories: Record<string, KeyBinding[]> = {};
+
+  for (const binding of Object.values(keyBindings)) {
+    const { cat } = binding;
+    categories[cat] ??= [];
+    categories[cat].push(binding);
+  }
+
+  const sortedCategoryKeys = Object.keys(categories).sort(
+    (a, b) => (categories[b]?.length ?? 0) - (categories[a]?.length ?? 0)
+  );
+
+  let html = '<a href="#" class="close" aria-label="close" title="close">×</a>';
+  html += "<h3>How to navigate SearXNG with hotkeys</h3>";
+  html += "<table>";
+
+  for (const [i, categoryKey] of sortedCategoryKeys.entries()) {
+    const bindings = categories[categoryKey];
+    if (!bindings || bindings.length === 0) continue;
+
+    const isFirst = i % 2 === 0;
+    const isLast = i === sortedCategoryKeys.length - 1;
+
+    if (isFirst) {
+      html += "<tr>";
+    }
+
+    html += "<td>";
+    html += `<h4>${categoryKey}</h4>`;
+    html += '<ul class="list-unstyled">';
+
+    for (const binding of bindings) {
+      html += `<li><kbd>${binding.key}</kbd> ${binding.des}</li>`;
+    }
+
+    html += "</ul>";
+    html += "</td>";
+
+    if (!isFirst || isLast) {
+      html += "</tr>";
+    }
+  }
+
+  html += "</table>";
+
+  divElement.innerHTML = html;
+};
+
+const toggleHelp = (keyBindings: typeof baseKeyBinding): void => {
+  let helpPanel = document.querySelector<HTMLElement>("#vim-hotkeys-help");
+  if (helpPanel) {
+    // toggle hidden
+    helpPanel.classList.toggle("invisible");
+  } else {
+    // first call
+    helpPanel = Object.assign(document.createElement("div"), {
+      id: "vim-hotkeys-help",
+      className: "dialog-modal"
+    });
+    initHelpContent(helpPanel, keyBindings);
+    const [body] = document.getElementsByTagName("body");
+    if (body) {
+      body.appendChild(helpPanel);
+    }
+  }
+};
+
+const copyURLToClipboard = async (): Promise<void> => {
+  const selectedResult = document.querySelector<HTMLElement>(".result[data-vim-selected]");
+  if (!selectedResult) return;
+
+  const resultAnchor = selectedResult.querySelector<HTMLAnchorElement>("a");
+  assertElement(resultAnchor);
+
+  const url = resultAnchor.getAttribute("href");
+  if (url) {
+    if (window.isSecureContext) {
+      await navigator.clipboard.writeText(url);
+    } else {
+      const selection = window.getSelection();
+      if (selection) {
+        const node = document.createElement("span");
+        node.textContent = url;
+        resultAnchor.appendChild(node);
+
+        const range = document.createRange();
+        range.selectNodeContents(node);
+        selection.removeAllRanges();
+        selection.addRange(range);
+        document.execCommand("copy");
+        node.remove();
+      }
+    }
+  }
+};
+
+listen("click", ".result", function (this: HTMLElement, event: PointerEvent) {
+  if (!isElementInDetail(event.target as HTMLElement)) {
+    highlightResult(this)(true, true);
+
+    const resultElement = getResultElement(event.target as HTMLElement);
+
+    if (resultElement && isImageResult(resultElement)) {
+      event.preventDefault();
+      mutable.selectImage?.(resultElement);
+    }
+  }
+});
+
+// FIXME: Focus might also trigger Pointer event ^^^
+listen(
+  "focus",
+  ".result a",
+  (event: FocusEvent) => {
+    if (!isElementInDetail(event.target as HTMLElement)) {
+      const resultElement = getResultElement(event.target as HTMLElement);
+
+      if (resultElement && !resultElement.hasAttribute("data-vim-selected")) {
+        highlightResult(resultElement)(true);
+      }
+
+      if (resultElement && isImageResult(resultElement)) {
+        event.preventDefault();
+        mutable.selectImage?.(resultElement);
+      }
+    }
+  },
+  { capture: true }
+);
+
+listen("keydown", document, (event: KeyboardEvent) => {
+  // check for modifiers so we don't break browser's hotkeys
+  if (Object.hasOwn(keyBindings, event.key) && !event.ctrlKey && !event.altKey && !event.shiftKey && !event.metaKey) {
+    const tagName = (event.target as HTMLElement)?.tagName?.toLowerCase();
+
+    if (event.key === "Escape") {
+      keyBindings[event.key]?.fun(event);
+    } else if (event.target === document.body || tagName === "a" || tagName === "button") {
+      event.preventDefault();
+      keyBindings[event.key]?.fun(event);
+    }
+  }
+});
+
+mutable.selectNext = highlightResult("down");
+mutable.selectPrevious = highlightResult("up");

client/simple/src/js/main/preferences.ts

@@ -0,0 +1,76 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { http, listen, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
+
+let engineDescriptions: Record<string, [string, string]> | undefined;
+
+const loadEngineDescriptions = async (): Promise<void> => {
+  if (engineDescriptions) return;
+  try {
+    const res = await http("GET", "engine_descriptions.json");
+    engineDescriptions = await res.json();
+  } catch (error) {
+    console.error("Error fetching engineDescriptions:", error);
+  }
+  if (!engineDescriptions) return;
+
+  for (const [engine_name, [description, source]] of Object.entries(engineDescriptions)) {
+    const elements = document.querySelectorAll<HTMLElement>(`[data-engine-name="${engine_name}"] .engine-description`);
+    const sourceText = ` (<i>${settings.translations?.Source}:&nbsp;${source}</i>)`;
+
+    for (const element of elements) {
+      element.innerHTML = description + sourceText;
+    }
+  }
+};
+
+const toggleEngines = (enable: boolean, engineToggles: NodeListOf<HTMLInputElement>): void => {
+  for (const engineToggle of engineToggles) {
+    // check if element visible, so that only engines of the current category are modified
+    if (engineToggle.offsetParent) {
+      engineToggle.checked = !enable;
+    }
+  }
+};
+
+const engineElements: NodeListOf<HTMLElement> = document.querySelectorAll<HTMLElement>("[data-engine-name]");
+for (const engineElement of engineElements) {
+  listen("mouseenter", engineElement, loadEngineDescriptions);
+}
+
+const engineToggles: NodeListOf<HTMLInputElement> = document.querySelectorAll<HTMLInputElement>(
+  "tbody input[type=checkbox][class~=checkbox-onoff]"
+);
+
+const enableAllEngines: NodeListOf<HTMLElement> = document.querySelectorAll<HTMLElement>(".enable-all-engines");
+for (const engine of enableAllEngines) {
+  listen("click", engine, () => toggleEngines(true, engineToggles));
+}
+
+const disableAllEngines: NodeListOf<HTMLElement> = document.querySelectorAll<HTMLElement>(".disable-all-engines");
+for (const engine of disableAllEngines) {
+  listen("click", engine, () => toggleEngines(false, engineToggles));
+}
+
+listen("click", "#copy-hash", async function (this: HTMLElement) {
+  const target = this.parentElement?.querySelector<HTMLPreElement>("pre");
+  assertElement(target);
+
+  if (window.isSecureContext) {
+    await navigator.clipboard.writeText(target.innerText);
+  } else {
+    const selection = window.getSelection();
+    if (selection) {
+      const range = document.createRange();
+      range.selectNodeContents(target);
+      selection.removeAllRanges();
+      selection.addRange(range);
+      document.execCommand("copy");
+    }
+  }
+
+  if (this.dataset.copiedText) {
+    this.innerText = this.dataset.copiedText;
+  }
+});

client/simple/src/js/main/results.ts

@@ -0,0 +1,190 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import "../../../node_modules/swiped-events/src/swiped-events.js";
+import { listen, mutable, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
+
+let imgTimeoutID: number;
+
+const imageLoader = (resultElement: HTMLElement): void => {
+  if (imgTimeoutID) clearTimeout(imgTimeoutID);
+
+  const imgElement = resultElement.querySelector<HTMLImageElement>(".result-images-source img");
+  if (!imgElement) return;
+
+  // use thumbnail until full image loads
+  const thumbnail = resultElement.querySelector<HTMLImageElement>(".image_thumbnail");
+  if (thumbnail) {
+    if (thumbnail.src === `${settings.theme_static_path}/img/img_load_error.svg`) return;
+
+    imgElement.onerror = (): void => {
+      imgElement.src = thumbnail.src;
+    };
+
+    imgElement.src = thumbnail.src;
+  }
+
+  const imgSource = imgElement.getAttribute("data-src");
+  if (!imgSource) return;
+
+  // unsafe nodejs specific, cast to https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#return_value
+  // https://github.com/searxng/searxng/pull/5073#discussion_r2265767231
+  imgTimeoutID = setTimeout(() => {
+    imgElement.src = imgSource;
+    imgElement.removeAttribute("data-src");
+  }, 1000) as unknown as number;
+};
+
+const imageThumbnails: NodeListOf<HTMLImageElement> = document.querySelectorAll<HTMLImageElement>(
+  "#urls img.image_thumbnail, img.thumbnail"
+);
+for (const thumbnail of imageThumbnails) {
+  if (thumbnail.complete && thumbnail.naturalWidth === 0) {
+    thumbnail.src = `${settings.theme_static_path}/img/img_load_error.svg`;
+  }
+
+  thumbnail.onerror = (): void => {
+    thumbnail.src = `${settings.theme_static_path}/img/img_load_error.svg`;
+  };
+}
+
+const copyUrlButton: HTMLButtonElement | null =
+  document.querySelector<HTMLButtonElement>("#search_url button#copy_url");
+copyUrlButton?.style.setProperty("display", "block");
+
+mutable.selectImage = (resultElement: HTMLElement): void => {
+  // add a class that can be evaluated in the CSS and indicates that the
+  // detail view is open
+  const resultsElement = document.getElementById("results");
+  resultsElement?.classList.add("image-detail-open");
+
+  // add a hash to the browser history so that pressing back doesn't return
+  // to the previous page this allows us to dismiss the image details on
+  // pressing the back button on mobile devices
+  window.location.hash = "#image-viewer";
+
+  mutable.scrollPageToSelected?.();
+
+  // if there is no element given by the caller, stop here
+  if (!resultElement) return;
+
+  imageLoader(resultElement);
+};
+
+mutable.closeDetail = (): void => {
+  const resultsElement = document.getElementById("results");
+  resultsElement?.classList.remove("image-detail-open");
+
+  // remove #image-viewer hash from url by navigating back
+  if (window.location.hash === "#image-viewer") {
+    window.history.back();
+  }
+
+  mutable.scrollPageToSelected?.();
+};
+
+listen("click", ".btn-collapse", function (this: HTMLElement) {
+  const btnLabelCollapsed = this.getAttribute("data-btn-text-collapsed");
+  const btnLabelNotCollapsed = this.getAttribute("data-btn-text-not-collapsed");
+  const target = this.getAttribute("data-target");
+
+  if (!(target && btnLabelCollapsed && btnLabelNotCollapsed)) return;
+
+  const targetElement = document.querySelector<HTMLElement>(target);
+  assertElement(targetElement);
+
+  const isCollapsed = this.classList.contains("collapsed");
+  const newLabel = isCollapsed ? btnLabelNotCollapsed : btnLabelCollapsed;
+  const oldLabel = isCollapsed ? btnLabelCollapsed : btnLabelNotCollapsed;
+
+  this.innerHTML = this.innerHTML.replace(oldLabel, newLabel);
+  this.classList.toggle("collapsed");
+
+  targetElement.classList.toggle("invisible");
+});
+
+listen("click", ".media-loader", function (this: HTMLElement) {
+  const target = this.getAttribute("data-target");
+  if (!target) return;
+
+  const iframeLoad = document.querySelector<HTMLIFrameElement>(`${target} > iframe`);
+  assertElement(iframeLoad);
+
+  const srctest = iframeLoad.getAttribute("src");
+  if (!srctest) {
+    const dataSrc = iframeLoad.getAttribute("data-src");
+    if (dataSrc) {
+      iframeLoad.setAttribute("src", dataSrc);
+    }
+  }
+});
+
+listen("click", "#copy_url", async function (this: HTMLElement) {
+  const target = this.parentElement?.querySelector<HTMLPreElement>("pre");
+  assertElement(target);
+
+  if (window.isSecureContext) {
+    await navigator.clipboard.writeText(target.innerText);
+  } else {
+    const selection = window.getSelection();
+    if (selection) {
+      const range = document.createRange();
+      range.selectNodeContents(target);
+      selection.removeAllRanges();
+      selection.addRange(range);
+      document.execCommand("copy");
+    }
+  }
+
+  if (this.dataset.copiedText) {
+    this.innerText = this.dataset.copiedText;
+  }
+});
+
+listen("click", ".result-detail-close", (event: Event) => {
+  event.preventDefault();
+  mutable.closeDetail?.();
+});
+
+listen("click", ".result-detail-previous", (event: Event) => {
+  event.preventDefault();
+  mutable.selectPrevious?.(false);
+});
+
+listen("click", ".result-detail-next", (event: Event) => {
+  event.preventDefault();
+  mutable.selectNext?.(false);
+});
+
+// listen for the back button to be pressed and dismiss the image details when called
+window.addEventListener("hashchange", () => {
+  if (window.location.hash !== "#image-viewer") {
+    mutable.closeDetail?.();
+  }
+});
+
+const swipeHorizontal: NodeListOf<HTMLElement> = document.querySelectorAll<HTMLElement>(".swipe-horizontal");
+for (const element of swipeHorizontal) {
+  listen("swiped-left", element, () => {
+    mutable.selectNext?.(false);
+  });
+
+  listen("swiped-right", element, () => {
+    mutable.selectPrevious?.(false);
+  });
+}
+
+window.addEventListener(
+  "scroll",
+  () => {
+    const backToTopElement = document.getElementById("backToTop");
+    const resultsElement = document.getElementById("results");
+
+    if (backToTopElement && resultsElement) {
+      const scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
+      const isScrolling = scrollTop >= 100;
+      resultsElement.classList.toggle("scrolling", isScrolling);
+    }
+  },
+  true
+);

client/simple/src/js/main/search.ts

@@ -0,0 +1,94 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { listen } from "../toolkit.ts";
+import { getElement } from "../util/getElement.ts";
+
+const searchForm: HTMLFormElement = getElement<HTMLFormElement>("search");
+const searchInput: HTMLInputElement = getElement<HTMLInputElement>("q");
+const searchReset: HTMLButtonElement = getElement<HTMLButtonElement>("clear_search");
+
+const isMobile: boolean = window.matchMedia("(max-width: 50em)").matches;
+const isResultsPage: boolean = document.querySelector("main")?.id === "main_results";
+
+const categoryButtons: HTMLButtonElement[] = Array.from(
+  document.querySelectorAll<HTMLButtonElement>("#categories_container button.category")
+);
+
+if (searchInput.value.length === 0) {
+  searchReset.classList.add("empty");
+}
+
+// focus search input on large screens
+if (!(isMobile || isResultsPage)) {
+  searchInput.focus();
+}
+
+// On mobile, move cursor to the end of the input on focus
+if (isMobile) {
+  listen("focus", searchInput, () => {
+    // Defer cursor move until the next frame to prevent a visual jump
+    requestAnimationFrame(() => {
+      const end = searchInput.value.length;
+      searchInput.setSelectionRange(end, end);
+      searchInput.scrollLeft = searchInput.scrollWidth;
+    });
+  });
+}
+
+listen("input", searchInput, () => {
+  searchReset.classList.toggle("empty", searchInput.value.length === 0);
+});
+
+listen("click", searchReset, (event: MouseEvent) => {
+  event.preventDefault();
+  searchInput.value = "";
+  searchInput.focus();
+  searchReset.classList.add("empty");
+});
+
+for (const button of categoryButtons) {
+  listen("click", button, (event: MouseEvent) => {
+    if (event.shiftKey) {
+      event.preventDefault();
+      button.classList.toggle("selected");
+      return;
+    }
+
+    // deselect all other categories
+    for (const categoryButton of categoryButtons) {
+      categoryButton.classList.toggle("selected", categoryButton === button);
+    }
+  });
+}
+
+if (document.querySelector("div.search_filters")) {
+  const safesearchElement = document.getElementById("safesearch");
+  if (safesearchElement) {
+    listen("change", safesearchElement, () => searchForm.submit());
+  }
+
+  const timeRangeElement = document.getElementById("time_range");
+  if (timeRangeElement) {
+    listen("change", timeRangeElement, () => searchForm.submit());
+  }
+
+  const languageElement = document.getElementById("language");
+  if (languageElement) {
+    listen("change", languageElement, () => searchForm.submit());
+  }
+}
+
+// override searchForm submit event
+listen("submit", searchForm, (event: Event) => {
+  event.preventDefault();
+
+  if (categoryButtons.length > 0) {
+    const searchCategories = getElement<HTMLInputElement>("selected-categories");
+    searchCategories.value = categoryButtons
+      .filter((button) => button.classList.contains("selected"))
+      .map((button) => button.name.replace("category_", ""))
+      .join(",");
+  }
+
+  searchForm.submit();
+});

client/simple/src/js/plugin/Calculator.ts

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import {
+  absDependencies,
+  addDependencies,
+  create,
+  divideDependencies,
+  eDependencies,
+  evaluateDependencies,
+  expDependencies,
+  factorialDependencies,
+  gcdDependencies,
+  lcmDependencies,
+  log1pDependencies,
+  log2Dependencies,
+  log10Dependencies,
+  logDependencies,
+  modDependencies,
+  multiplyDependencies,
+  nthRootDependencies,
+  piDependencies,
+  powDependencies,
+  roundDependencies,
+  signDependencies,
+  sqrtDependencies,
+  subtractDependencies
+} from "mathjs/number";
+import { Plugin } from "../Plugin.ts";
+import { appendAnswerElement } from "../util/appendAnswerElement.ts";
+import { getElement } from "../util/getElement.ts";
+
+/**
+ * Parses and solves mathematical expressions. Can do basic arithmetic and
+ * evaluate some functions.
+ *
+ * @example
+ * "(3 + 5) / 2" = "4"
+ * "e ^ 2 + pi" = "10.530648752520442"
+ * "gcd(48, 18) + lcm(4, 5)" = "26"
+ *
+ * @remarks
+ * Depends on `mathjs` library.
+ */
+export default class Calculator extends Plugin {
+  public constructor() {
+    super("calculator");
+  }
+
+  /**
+   * @remarks
+   * Compare bundle size after adding or removing features.
+   */
+  private static readonly math = create({
+    ...absDependencies,
+    ...addDependencies,
+    ...divideDependencies,
+    ...eDependencies,
+    ...evaluateDependencies,
+    ...expDependencies,
+    ...factorialDependencies,
+    ...gcdDependencies,
+    ...lcmDependencies,
+    ...log10Dependencies,
+    ...log1pDependencies,
+    ...log2Dependencies,
+    ...logDependencies,
+    ...modDependencies,
+    ...multiplyDependencies,
+    ...nthRootDependencies,
+    ...piDependencies,
+    ...powDependencies,
+    ...roundDependencies,
+    ...signDependencies,
+    ...sqrtDependencies,
+    ...subtractDependencies
+  });
+
+  protected async run(): Promise<string | undefined> {
+    const searchInput = getElement<HTMLInputElement>("q");
+
+    try {
+      const node = Calculator.math.parse(searchInput.value);
+      return `${node.toString()} = ${node.evaluate()}`;
+    } catch {
+      // not a compatible math expression
+      return;
+    }
+  }
+
+  protected async post(result: string): Promise<void> {
+    appendAnswerElement(result);
+  }
+}

client/simple/src/js/plugin/InfiniteScroll.ts

@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { Plugin } from "../Plugin.ts";
+import { http, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
+import { getElement } from "../util/getElement.ts";
+
+/**
+ * Automatically loads the next page when scrolling to bottom of the current page.
+ */
+export default class InfiniteScroll extends Plugin {
+  public constructor() {
+    super("infiniteScroll");
+  }
+
+  protected async run(): Promise<void> {
+    const resultsElement = getElement<HTMLElement>("results");
+
+    const onlyImages: boolean = resultsElement.classList.contains("only_template_images");
+    const observedSelector = "article.result:last-child";
+
+    const spinnerElement = document.createElement("div");
+    spinnerElement.className = "loader";
+
+    const loadNextPage = async (callback: () => void): Promise<void> => {
+      const searchForm = document.querySelector<HTMLFormElement>("#search");
+      assertElement(searchForm);
+
+      const form = document.querySelector<HTMLFormElement>("#pagination form.next_page");
+      assertElement(form);
+
+      const action = searchForm.getAttribute("action");
+      if (!action) {
+        throw new Error("Form action not defined");
+      }
+
+      const paginationElement = document.querySelector<HTMLElement>("#pagination");
+      assertElement(paginationElement);
+
+      paginationElement.replaceChildren(spinnerElement);
+
+      try {
+        const res = await http("POST", action, { body: new FormData(form) });
+        const nextPage = await res.text();
+        if (!nextPage) return;
+
+        const nextPageDoc = new DOMParser().parseFromString(nextPage, "text/html");
+        const articleList = nextPageDoc.querySelectorAll<HTMLElement>("#urls article");
+        const nextPaginationElement = nextPageDoc.querySelector<HTMLElement>("#pagination");
+
+        document.querySelector("#pagination")?.remove();
+
+        const urlsElement = document.querySelector<HTMLElement>("#urls");
+        if (!urlsElement) {
+          throw new Error("URLs element not found");
+        }
+
+        if (articleList.length > 0 && !onlyImages) {
+          // do not add <hr> element when there are only images
+          urlsElement.appendChild(document.createElement("hr"));
+        }
+
+        urlsElement.append(...articleList);
+
+        if (nextPaginationElement) {
+          const results = document.querySelector<HTMLElement>("#results");
+          results?.appendChild(nextPaginationElement);
+          callback();
+        }
+      } catch (error) {
+        console.error("Error loading next page:", error);
+
+        const errorElement = Object.assign(document.createElement("div"), {
+          textContent: settings.translations?.error_loading_next_page ?? "Error loading next page",
+          className: "dialog-error"
+        });
+        errorElement.setAttribute("role", "alert");
+        document.querySelector("#pagination")?.replaceChildren(errorElement);
+      }
+    };
+
+    const intersectionObserveOptions: IntersectionObserverInit = {
+      rootMargin: "320px"
+    };
+
+    const observer: IntersectionObserver = new IntersectionObserver(async (entries: IntersectionObserverEntry[]) => {
+      const [paginationEntry] = entries;
+
+      if (paginationEntry?.isIntersecting) {
+        observer.unobserve(paginationEntry.target);
+
+        await loadNextPage(() => {
+          const nextObservedElement = document.querySelector<HTMLElement>(observedSelector);
+          if (nextObservedElement) {
+            observer.observe(nextObservedElement);
+          }
+        });
+      }
+    }, intersectionObserveOptions);
+
+    const initialObservedElement: HTMLElement | null = document.querySelector<HTMLElement>(observedSelector);
+    if (initialObservedElement) {
+      observer.observe(initialObservedElement);
+    }
+  }
+
+  protected async post(): Promise<void> {
+    // noop
+  }
+}

client/simple/src/js/plugin/MapView.ts

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import "ol/ol.css";
+import { Feature, Map as OlMap, View } from "ol";
+import { GeoJSON } from "ol/format";
+import { Point } from "ol/geom";
+import { Tile as TileLayer, Vector as VectorLayer } from "ol/layer";
+import { fromLonLat } from "ol/proj";
+import { OSM, Vector as VectorSource } from "ol/source";
+import { Circle, Fill, Stroke, Style } from "ol/style";
+import { Plugin } from "../Plugin.ts";
+
+/**
+ * MapView
+ */
+export default class MapView extends Plugin {
+  private readonly map: HTMLElement;
+
+  public constructor(map: HTMLElement) {
+    super("mapView");
+
+    this.map = map;
+  }
+
+  protected async run(): Promise<void> {
+    const { leafletTarget: target, mapLon = "0", mapLat = "0", mapGeojson } = this.map.dataset;
+
+    const lon = Number.parseFloat(mapLon);
+    const lat = Number.parseFloat(mapLat);
+    const view = new View({ maxZoom: 16, enableRotation: false });
+    const map = new OlMap({
+      target: target,
+      layers: [new TileLayer({ source: new OSM({ maxZoom: 16 }) })],
+      view: view
+    });
+
+    try {
+      const markerSource = new VectorSource({
+        features: [
+          new Feature({
+            geometry: new Point(fromLonLat([lon, lat]))
+          })
+        ]
+      });
+
+      const markerLayer = new VectorLayer({
+        source: markerSource,
+        style: new Style({
+          image: new Circle({
+            radius: 6,
+            fill: new Fill({ color: "#3050ff" })
+          })
+        })
+      });
+
+      map.addLayer(markerLayer);
+    } catch (error) {
+      console.error("Failed to create marker layer:", error);
+    }
+
+    if (mapGeojson) {
+      try {
+        const geoSource = new VectorSource({
+          features: new GeoJSON().readFeatures(JSON.parse(mapGeojson), {
+            dataProjection: "EPSG:4326",
+            featureProjection: "EPSG:3857"
+          })
+        });
+
+        const geoLayer = new VectorLayer({
+          source: geoSource,
+          style: new Style({
+            stroke: new Stroke({ color: "#3050ff", width: 2 }),
+            fill: new Fill({ color: "#3050ff33" })
+          })
+        });
+
+        map.addLayer(geoLayer);
+
+        const geoSourceExtent = geoSource.getExtent();
+        if (geoSourceExtent) {
+          view.fit(geoSourceExtent, { padding: [20, 20, 20, 20] });
+        }
+      } catch (error) {
+        console.error("Failed to create GeoJSON layer:", error);
+      }
+    }
+  }
+
+  protected async post(): Promise<void> {
+    // noop
+  }
+}

client/simple/src/js/router.ts

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { load } from "./loader.ts";
+import { Endpoints, endpoint, listen, ready, settings } from "./toolkit.ts";
+
+ready(() => {
+  document.documentElement.classList.remove("no-js");
+  document.documentElement.classList.add("js");
+
+  listen("click", ".close", function (this: HTMLElement) {
+    (this.parentNode as HTMLElement)?.classList.add("invisible");
+  });
+
+  listen("click", ".searxng_init_map", async function (this: HTMLElement, event: Event) {
+    event.preventDefault();
+    this.classList.remove("searxng_init_map");
+
+    load(() => import("./plugin/MapView.ts").then(({ default: Plugin }) => new Plugin(this)), {
+      on: "endpoint",
+      where: [Endpoints.results]
+    });
+  });
+
+  if (settings.plugins?.includes("infiniteScroll")) {
+    load(() => import("./plugin/InfiniteScroll.ts").then(({ default: Plugin }) => new Plugin()), {
+      on: "endpoint",
+      where: [Endpoints.results]
+    });
+  }
+
+  if (settings.plugins?.includes("calculator")) {
+    load(() => import("./plugin/Calculator.ts").then(({ default: Plugin }) => new Plugin()), {
+      on: "endpoint",
+      where: [Endpoints.results]
+    });
+  }
+});
+
+ready(
+  () => {
+    void import("./main/keyboard.ts");
+    void import("./main/search.ts");
+
+    if (settings.autocomplete) {
+      void import("./main/autocomplete.ts");
+    }
+  },
+  { on: [endpoint === Endpoints.index] }
+);
+
+ready(
+  () => {
+    void import("./main/keyboard.ts");
+    void import("./main/results.ts");
+    void import("./main/search.ts");
+
+    if (settings.autocomplete) {
+      void import("./main/autocomplete.ts");
+    }
+  },
+  { on: [endpoint === Endpoints.results] }
+);
+
+ready(
+  () => {
+    void import("./main/preferences.ts");
+  },
+  { on: [endpoint === Endpoints.preferences] }
+);

client/simple/src/js/toolkit.ts

@@ -0,0 +1,133 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import type { KeyBindingLayout } from "./main/keyboard.ts";
+
+// synced with searx/webapp.py get_client_settings
+type Settings = {
+  plugins?: string[];
+  autocomplete?: string;
+  autocomplete_min?: number;
+  doi_resolver?: string;
+  favicon_resolver?: string;
+  hotkeys?: KeyBindingLayout;
+  method?: "GET" | "POST";
+  query_in_title?: boolean;
+  results_on_new_tab?: boolean;
+  safesearch?: 0 | 1 | 2;
+  search_on_category_select?: boolean;
+  theme?: string;
+  theme_static_path?: string;
+  translations?: Record<string, string>;
+  url_formatting?: "pretty" | "full" | "host";
+};
+
+type HTTPOptions = {
+  body?: BodyInit;
+  timeout?: number;
+};
+
+type ReadyOptions = {
+  // all values must be truthy for the callback to be executed
+  on?: (boolean | undefined)[];
+};
+
+export type EndpointsKeys = keyof typeof Endpoints;
+
+export const Endpoints = {
+  index: "index",
+  results: "results",
+  preferences: "preferences",
+  unknown: "unknown"
+} as const;
+
+export const mutable = {
+  closeDetail: undefined as (() => void) | undefined,
+  scrollPageToSelected: undefined as (() => void) | undefined,
+  selectImage: undefined as ((resultElement: HTMLElement) => void) | undefined,
+  selectNext: undefined as ((openDetailView?: boolean) => void) | undefined,
+  selectPrevious: undefined as ((openDetailView?: boolean) => void) | undefined
+};
+
+const getEndpoint = (): EndpointsKeys => {
+  const metaEndpoint = document.querySelector('meta[name="endpoint"]')?.getAttribute("content");
+
+  if (metaEndpoint && metaEndpoint in Endpoints) {
+    return metaEndpoint as EndpointsKeys;
+  }
+
+  return Endpoints.unknown;
+};
+
+const getSettings = (): Settings => {
+  const settings = document.querySelector("script[client_settings]")?.getAttribute("client_settings");
+  if (!settings) return {};
+
+  try {
+    return JSON.parse(atob(settings));
+  } catch (error) {
+    console.error("Failed to load client_settings:", error);
+    return {};
+  }
+};
+
+export const http = async (method: string, url: string | URL, options?: HTTPOptions): Promise<Response> => {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), options?.timeout ?? 30_000);
+
+  const res = await fetch(url, {
+    body: options?.body,
+    method: method,
+    signal: controller.signal
+  }).finally(() => clearTimeout(timeoutId));
+  if (!res.ok) {
+    throw new Error(res.statusText);
+  }
+
+  return res;
+};
+
+export const listen = <K extends keyof DocumentEventMap, E extends HTMLElement>(
+  type: string | K,
+  target: string | Document | E,
+  listener: (this: E, event: DocumentEventMap[K]) => void | Promise<void>,
+  options?: AddEventListenerOptions
+): void => {
+  if (typeof target !== "string") {
+    target.addEventListener(type, listener as EventListener, options);
+    return;
+  }
+
+  document.addEventListener(
+    type,
+    (event: Event) => {
+      for (const node of event.composedPath()) {
+        if (node instanceof HTMLElement && node.matches(target)) {
+          try {
+            listener.call(node as E, event as DocumentEventMap[K]);
+          } catch (error) {
+            console.error(error);
+          }
+          break;
+        }
+      }
+    },
+    options
+  );
+};
+
+export const ready = (callback: () => void, options?: ReadyOptions): void => {
+  for (const condition of options?.on ?? []) {
+    if (!condition) {
+      return;
+    }
+  }
+
+  if (document.readyState === "loading") {
+    listen("DOMContentLoaded", document, callback, { once: true });
+  } else {
+    callback();
+  }
+};
+
+export const endpoint: EndpointsKeys = getEndpoint();
+export const settings: Settings = getSettings();

client/simple/src/js/util/appendAnswerElement.ts

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { getElement } from "./getElement.ts";
+
+export const appendAnswerElement = (element: HTMLElement | string | number): void => {
+  const results = getElement<HTMLDivElement>("results");
+
+  // ./searx/templates/elements/answers.html
+  let answers = getElement<HTMLDivElement>("answers", { assert: false });
+  if (!answers) {
+    // what is this?
+    const answersTitle = document.createElement("h4");
+    answersTitle.setAttribute("class", "title");
+    answersTitle.setAttribute("id", "answers-title");
+    answersTitle.textContent = "Answers : ";
+
+    answers = document.createElement("div");
+    answers.setAttribute("id", "answers");
+    answers.setAttribute("role", "complementary");
+    answers.setAttribute("aria-labelledby", "answers-title");
+    answers.appendChild(answersTitle);
+  }
+
+  if (!(element instanceof HTMLElement)) {
+    const span = document.createElement("span");
+    span.innerHTML = element.toString();
+    // biome-ignore lint/style/noParameterAssign: TODO
+    element = span;
+  }
+
+  answers.appendChild(element);
+
+  results.insertAdjacentElement("afterbegin", answers);
+};

client/simple/src/js/util/assertElement.ts

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+type AssertElement = <T>(element?: T | null) => asserts element is T;
+export const assertElement: AssertElement = <T>(element?: T | null): asserts element is T => {
+  if (!element) {
+    throw new Error("DOM element not found");
+  }
+};

client/simple/src/js/util/getElement.ts

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { assertElement } from "./assertElement.ts";
+
+type Options = {
+  assert?: boolean;
+};
+
+export function getElement<T>(id: string, options?: { assert: true }): T;
+export function getElement<T>(id: string, options?: { assert: false }): T | null;
+export function getElement<T>(id: string, options: Options = {}): T | null {
+  options.assert ??= true;
+
+  const element = document.getElementById(id) as T | null;
+
+  if (options.assert) {
+    assertElement(element);
+  }
+
+  return element;
+}

client/simple/src/less/animations.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 .dialog-modal {
   animation-name: dialogmodal;
   animation-duration: 0.13s;

client/simple/src/less/autocomplete.less

@@ -1,8 +1,9 @@
-/*! Autocomplete.js v2.6.3 | license MIT | (c) 2017, Baptiste Donaux | http://autocomplete-js.com */
+// SPDX-License-Identifier: AGPL-3.0-or-later
 
 .autocomplete {
   position: absolute;
   width: @search-width;
+  max-width: calc(100% - 2 * @search-padding-horizontal);
   max-height: 0;
   overflow-y: hidden;
   .ltr-text-align-left();
@@ -53,7 +54,7 @@
     color: var(--color-autocomplete-font);
     max-height: 32rem;
     overflow-y: auto;
-    z-index: 100;
+    z-index: 5000;
     margin-top: 3.5rem;
     border-radius: 0.8rem;
 
@@ -65,8 +66,6 @@
 
 @media screen and (max-width: @phone) {
   .autocomplete {
-    width: 100%;
-
     > ul > li {
       padding: 1rem;
     }

client/simple/src/less/definitions.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 /*
  * SearXNG, A privacy-respecting, hackable metasearch engine
  *
@@ -55,8 +57,12 @@
   --color-autocomplete-background: #fff;
   --color-autocomplete-background-hover: #e3e3e3;
   /// Answer Colors
-  --color-answer-font: #444;  // same as --color-base-font
+  --color-answer-font: #444; // same as --color-base-font
   --color-answer-background: #fff;
+  // colors of the KeyValue result class
+  --color-result-keyvalue-col-table: #fdfbff;
+  --color-result-keyvalue-odd: #fdfbff;
+  --color-result-keyvalue-even: #fff;
   /// Results Colors
   --color-result-background: #fff;
   --color-result-border: #ddd;
@@ -85,8 +91,8 @@
   --color-result-detail-background: #242424;
   --color-result-detail-hr: #555;
   --color-result-detail-link: #8af;
-  --color-result-detail-loader-border: rgba(255, 255, 255, 0.2);
-  --color-result-detail-loader-borderleft: rgba(0, 0, 0, 0);
+  --color-result-detail-loader-border: rgb(255 255 255 / 20%);
+  --color-result-detail-loader-borderleft: rgb(0 0 0 / 0%);
   /// Toolkit Colors
   --color-toolkit-badge-font: #fff;
   --color-toolkit-badge-background: #545454;
@@ -111,16 +117,16 @@
   --color-toolkit-checkbox-input-border: #3050ff;
   --color-toolkit-engine-tooltip-border: #ddd;
   --color-toolkit-engine-tooltip-background: #fff;
-  --color-toolkit-loader-border: rgba(0, 0, 0, 0.2);
-  --color-toolkit-loader-borderleft: rgba(255, 255, 255, 0);
+  --color-toolkit-loader-border: rgb(0 0 0 / 20%);
+  --color-toolkit-loader-borderleft: rgb(255 255 255 / 0%);
   --color-doc-code: #003;
   --color-doc-code-background: #ddeaff;
   /// Other misc colors
   --color-bar-chart-primary: #5bc0de;
   --color-bar-chart-secondary: #deb15b;
-  --color-image-resolution-background: rgba(0, 0, 0, 50%);
+  --color-image-resolution-background: rgb(0 0 0 / 50%);
   --color-image-resolution-font: #fff;
-  --color-loading-indicator: rgba(255, 255, 255, 0.2);
+  --color-loading-indicator: rgb(255 255 255 / 20%);
   --color-loading-indicator-gap: #fff;
   --color-line-number: #64708d;
   // Favicons Colors
@@ -180,6 +186,10 @@
   /// Answer Colors
   --color-answer-font: #bbb; // same as --color-base-font
   --color-answer-background: #26292f;
+  // colors of the KeyValue result class
+  --color-result-keyvalue-col-table: #1e1e22;
+  --color-result-keyvalue-odd: #1e1e22;
+  --color-result-keyvalue-even: #26292f;
   /// Results Colors
   --color-result-background: #26292f;
   --color-result-border: #333;
@@ -200,8 +210,8 @@
   --color-result-detail-background: #1a1a1c;
   --color-result-detail-hr: #555;
   --color-result-detail-link: #8af;
-  --color-result-detail-loader-border: rgba(255, 255, 255, 0.2);
-  --color-result-detail-loader-borderleft: rgba(0, 0, 0, 0);
+  --color-result-detail-loader-border: rgb(255 255 255 / 20%);
+  --color-result-detail-loader-borderleft: rgb(0 0 0 / 0%);
   // Images Colors
   --color-result-image-span-font: #bbb;
   --color-result-image-span-font-selected: #222;
@@ -234,8 +244,8 @@
   --color-toolkit-checkbox-input-border: #58f;
   --color-toolkit-engine-tooltip-border: #333;
   --color-toolkit-engine-tooltip-background: #222;
-  --color-toolkit-loader-border: rgba(255, 255, 255, 0.2);
-  --color-toolkit-loader-borderleft: rgba(0, 0, 0, 0);
+  --color-toolkit-loader-border: rgb(255 255 255 / 20%);
+  --color-toolkit-loader-borderleft: rgb(0 0 0 / 0%);
   --color-doc-code: #ddd;
   --color-doc-code-background: #4d5a6f;
   // Favicons Colors
@@ -279,12 +289,13 @@
 @results-image-row-height: 12rem;
 @results-image-row-height-phone: 10rem;
 @search-width: 44rem;
-// heigh of #search, see detail.less
-@search-height: 7.6rem;
+// height of #search, see detail.less
+@search-height: 13rem;
+@search-padding-horizontal: 0.5rem;
 
 /// Device Size
 /// @desktop > @tablet
-@tablet: 79.75em;  // see https://github.com/searxng/searxng/issues/874
+@tablet: 79.75em; // see https://github.com/searxng/searxng/issues/874
 @phone: 50em;
 @small-phone: 35em;
 @ultra-small-phone: 20rem;
@@ -293,12 +304,12 @@
 @stacked-bar-chart: rgb(0, 0, 0);
 
 /// Load fonts from this directory.
-@icon-font-path:          "../../../fonts/";
+@icon-font-path: "../../../fonts/";
 //** File name for all font files.
-@icon-font-name:          "glyphicons-halflings-regular";
+@icon-font-name: "glyphicons-halflings-regular";
 //** Element ID within SVG icon file.
-@icon-font-svg-id:        "glyphicons_halflingsregular";
+@icon-font-svg-id: "glyphicons_halflingsregular";
 
 // decoration of the select HTML elements
-@select-light-svg-path:   "../svg/select-light.svg";
-@select-dark-svg-path:    "../svg/select-dark.svg";
+@select-light-svg-path: "../svg/select-light.svg";
+@select-dark-svg-path: "../svg/select-dark.svg";

client/simple/src/less/embedded.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 iframe[src^="https://w.soundcloud.com"] {
   height: 120px;
 }

client/simple/src/less/index.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 #main_index {
   margin-top: 26vh;
 }
@@ -6,7 +8,7 @@
   text-align: center;
 
   .title {
-    background: url('../img/searxng.png') no-repeat;
+    background: url("./img/searxng.png") no-repeat;
     min-height: 4rem;
     margin: 4rem auto;
     background-position: center;

client/simple/src/less/info.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 .info-page {
   code {
     font-family: monospace;

client/simple/src/less/mixins.less

@@ -2,9 +2,6 @@
 
 // Mixins
 .text-size-adjust (@property: 100%) {
-  -webkit-text-size-adjust: @property;
-  -ms-text-size-adjust: @property;
-  -moz-text-size-adjust: @property;
   text-size-adjust: @property;
 }
 
@@ -22,7 +19,6 @@
 
 // disable user selection
 .disable-user-select () {
-  -webkit-touch-callout: none;
   user-select: none;
 }
 

client/simple/src/less/preferences.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 table {
   border-collapse: collapse;
 
@@ -48,6 +50,14 @@ table {
     }
   }
 
+  div.pref-group {
+    width: 100%;
+    font-weight: normal;
+    padding: 1rem 0.5rem;
+    .ltr-text-align-left();
+    background: var(--color-settings-table-group-background);
+  }
+
   .value {
     margin: 0;
     padding: 0;

client/simple/src/less/result_types/code.less

@@ -1,4 +1,6 @@
-@import "../generated/pygments.less";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+@import "../../../generated/pygments.less";
 
 .codelines {
   margin: @results-margin 0 0 0;
@@ -18,12 +20,9 @@
       cursor: default;
 
       &::selection {
-        background: transparent; /* WebKit/Blink Browsers */
+        background: transparent;
       }
 
-      &::-moz-selection {
-        background: transparent; /* Gecko Browsers */
-      }
       margin-right: 8px;
       text-align: right;
     }
@@ -31,6 +30,12 @@
     span.linenos {
       color: var(--color-line-number);
     }
+
+    .err {
+      // The code view in the result list should not act as a code-checker.
+      border: none;
+      color: inherit;
+    }
   }
 }
 

client/simple/src/less/result_types/file.less

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/*
+  Layout of the Files result class
+*/
+
+#main_results .result-file {
+  border: 1px solid var(--color-result-border);
+  margin: 0 @results-tablet-offset 1rem @results-tablet-offset !important;
+  .rounded-corners;
+
+  video {
+    width: 100%;
+    aspect-ratio: 16 / 9;
+    padding: 10px 0 0 0;
+  }
+
+  audio {
+    width: 100%;
+    padding: 10px 0 0 0;
+  }
+}

client/simple/src/less/result_types/image.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 #main_results #results.image-detail-open.only_template_images {
   width: min(98%, 59.25rem) !important;
 }
@@ -22,8 +24,9 @@ article.result-images .detail {
   bottom: 0;
   background: var(--color-result-detail-background);
   border: 1px solid var(--color-result-detail-background);
-  z-index: 10000;
+  z-index: 1000;
   padding: 4rem 3rem 3rem 3rem;
+  overflow-y: scroll;
 
   a.result-images-source {
     display: block;
@@ -42,7 +45,7 @@ article.result-images .detail {
       height: inherit;
       max-width: 100%;
       min-height: inherit;
-      max-height: calc(100vh - 25rem - 7rem);
+      max-height: calc(100vh - 25rem - 17rem);
       background: inherit;
     }
   }
@@ -93,8 +96,7 @@ article.result-images .detail {
 
     p.result-url {
       white-space: nowrap;
-      overflow-x: hidden;
-      overflow-y: hidden;
+      overflow: hidden hidden;
       text-overflow: ellipsis;
     }
 
@@ -149,7 +151,7 @@ article.result-images .detail {
     height: 1.5rem;
     position: absolute;
     filter: opacity(40%);
-    z-index: 2000002;
+    z-index: 1200;
 
     span {
       display: block;
@@ -204,7 +206,9 @@ article.result-images .detail {
   }
 }
 
-#results.image-detail-open.scrolling article.result-images[data-vim-selected] .detail {
+#results.image-detail-open.scrolling
+  article.result-images[data-vim-selected]
+  .detail {
   top: 0;
 
   a.result-images-source img {
@@ -242,7 +246,7 @@ article.result-images .detail {
 
     a.result-images-source img {
       width: 100%;
-      max-height: calc(100vh - 20rem);
+      max-height: calc(100vh - 2rem);
       margin: 0;
     }
 

client/simple/src/less/result_types/keyvalue.less

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/*
+  Layout of the KeyValue result class
+*/
+
+#main_results .result-keyvalue {
+  caption {
+    padding: 0.8rem 0.5rem;
+    font-style: italic;
+    caption-side: bottom;
+    background-color: var(--color-result-keyvalue-table);
+  }
+
+  .col-key {
+    width: 25%;
+  }
+
+  table {
+    word-break: break-all;
+    table-layout: fixed;
+    width: 100%;
+    background-color: var(--color-result-keyvalue-table);
+  }
+
+  tr.odd {
+    background-color: var(--color-result-keyvalue-odd);
+  }
+
+  tr.even {
+    background-color: var(--color-result-keyvalue-even);
+  }
+
+  th,
+  td {
+    padding: 0.3rem 0.5rem;
+  }
+}

client/simple/src/less/result_types/paper.less

@@ -0,0 +1,72 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/*
+  Layout of the Paper result class
+*/
+
+.result-paper {
+  .attributes {
+    display: table;
+    border-spacing: 0.125rem;
+
+    div {
+      display: table-row;
+
+      span {
+        font-size: 0.9rem;
+        margin-top: 0.25rem;
+        display: table-cell;
+
+        time {
+          font-size: 0.9rem;
+        }
+      }
+
+      span:first-child {
+        color: var(--color-base-font);
+        min-width: 10rem;
+      }
+
+      span:nth-child(2) {
+        color: var(--color-result-publishdate-font);
+      }
+    }
+  }
+
+  .content {
+    margin-top: 0.25rem;
+  }
+
+  .comments {
+    font-size: 0.9rem;
+    margin: 0.25rem 0 0 0;
+    padding: 0;
+    overflow-wrap: break-word;
+    line-height: 1.24;
+    font-style: italic;
+  }
+}
+
+@media screen and (max-width: @phone) {
+  .result-paper {
+    .attributes {
+      display: block;
+
+      div {
+        display: block;
+
+        span {
+          display: inline;
+        }
+
+        span:first-child {
+          font-weight: bold;
+        }
+
+        span:nth-child(2) {
+          .ltr-margin-left(0.5rem);
+        }
+      }
+    }
+  }
+}

client/simple/src/less/rss.less

@@ -1,12 +1,8 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 @import (inline) "../../node_modules/normalize.css/normalize.css";
 @import "definitions.less";
-
-.text-size-adjust (@property: 100%) {
-  -webkit-text-size-adjust: @property;
-  -ms-text-size-adjust: @property;
-  -moz-text-size-adjust: @property;
-  text-size-adjust: @property;
-}
+@import "mixins.less";
 
 // Reset padding and margin
 html,

client/simple/src/less/search.less

@@ -1,6 +1,4 @@
-/*
-* SearXNG, A privacy-respecting, hackable metasearch engine
-*/
+// SPDX-License-Identifier: AGPL-3.0-or-later
 
 #search {
   padding: 0;
@@ -15,8 +13,7 @@
   background: var(--color-header-background);
   border-bottom: 1px solid var(--color-header-border);
   display: grid;
-  column-gap: 1.2rem;
-  row-gap: 1rem;
+  gap: 1rem 1.2rem;
   grid-template-columns: 3rem 1fr;
   grid-template-areas:
     "logo search"
@@ -84,7 +81,9 @@ button.category_button {
 }
 
 // only used when JavaScript is disabled
-.no-js #categories_container:has(button.category_button:focus-within) button.category_button {
+.no-js
+  #categories_container:has(button.category_button:focus-within)
+  button.category_button {
   &.selected {
     color: var(--color-base-font);
     border-bottom: none;
@@ -130,7 +129,7 @@ button.category_button {
 }
 
 #search_view {
-  padding: 0.5rem 0.3rem 0 0.5rem;
+  padding: 0.5rem @search-padding-horizontal 0 @search-padding-horizontal;
   grid-area: search;
 
   body.results_endpoint & {
@@ -140,7 +139,8 @@ button.category_button {
 
 .search_box {
   border-radius: 0.8rem;
-  width: @search-width;
+  width: 100%;
+  max-width: @search-width;
   display: inline-flex;
   flex-direction: row;
   white-space: nowrap;
@@ -159,7 +159,7 @@ button.category_button {
   outline: none;
   color: var(--color-search-font);
   font-size: 1.1rem;
-  z-index: 10000;
+  z-index: 1000;
 
   &:hover {
     color: var(--color-search-background-hover);
@@ -178,13 +178,12 @@ html.no-js #clear_search.hide_if_nojs {
 #send_search {
   display: block;
   margin: 0;
-  padding: 0.8rem;
   background: none repeat scroll 0 0 var(--color-search-background);
   border: none;
   outline: none;
   color: var(--color-search-font);
   font-size: 1.1rem;
-  z-index: 2;
+  z-index: 100;
 }
 
 #q {
@@ -194,13 +193,9 @@ html.no-js #clear_search.hide_if_nojs {
   .ltr-rounded-left-corners(0.8rem);
 }
 
-#q::-ms-clear,
-#q::-webkit-search-cancel-button {
-  display: none;
-}
-
 #send_search {
   .ltr-rounded-right-corners(0.8rem);
+  padding: 0.8rem;
 
   &:hover {
     cursor: pointer;
@@ -268,9 +263,7 @@ html.no-js #clear_search.hide_if_nojs {
     #categories {
       width: 100%;
       .ltr-text-align-left();
-      overflow-x: scroll;
-      overflow-y: hidden;
-      -webkit-overflow-scrolling: touch;
+      overflow: scroll hidden;
     }
   }
 }
@@ -280,8 +273,7 @@ html.no-js #clear_search.hide_if_nojs {
     width: 100%;
     margin: 0;
     padding: 0.1rem 0 0 0;
-    column-gap: 0;
-    row-gap: 0;
+    gap: 0 0;
     grid-template-areas:
       "logo search"
       "categories categories";
@@ -292,8 +284,7 @@ html.no-js #clear_search.hide_if_nojs {
   }
 
   .search_box {
-    width: 98%;
-    display: flex;
+    width: 100%;
   }
 
   #q {
@@ -335,7 +326,7 @@ html.no-js #clear_search.hide_if_nojs {
     top: 0;
     height: 100%;
     width: 100%;
-    z-index: 10000;
+    z-index: 2000;
 
     .search_box {
       border-bottom: 1px solid var(--color-search-border);
@@ -375,11 +366,6 @@ html.no-js #clear_search.hide_if_nojs {
 
 #categories {
   .disable-user-select;
-
-  &::-webkit-scrollbar {
-    width: 0;
-    height: 0;
-  }
 }
 
 #categories_container {

client/simple/src/less/style-center.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 /*
 --center-page-width overrides the less variable @results-width when the results are centered
 see the CSS rules for #results in style.less ( grid-template-columns and gap).
@@ -14,7 +16,7 @@ on the /search URL and when the "center alignment" preference is enabled.
   }
 }
 
-@media screen and (min-width: 62rem) {
+@media screen and (width >= 62rem) {
   .center-alignment-yes #main_results {
     --center-page-width: 60rem;
   }
@@ -63,9 +65,11 @@ on the /search URL and when the "center alignment" preference is enabled.
     }
 
     #search_header {
-      grid-template-columns: calc(50% - 4.5rem - var(--center-page-width) / 2) 3rem var(--center-page-width);
+      grid-template-columns:
+        calc(50% - 4.5rem - var(--center-page-width) / 2)
+        3rem var(--center-page-width);
       grid-template-areas: "na logo search" "na spacer categories";
-      column-gap: 1.2rem;  // from search.less
+      column-gap: 1.2rem; // from search.less
       width: 100%;
       padding-left: 0;
       padding-right: 0;
@@ -91,10 +95,12 @@ on the /search URL and when the "center alignment" preference is enabled.
         align-self: flex-start;
       }
 
-      &:not(.only_template_images):not(.image-detail-open) {
+      &:not(.only_template_images, .image-detail-open) {
         // the gap is set in style.less
         .ltr-margin-left(1.5rem);
-        grid-template-columns: calc(var(--center-page-width) - @results-gap - @results-sidebar-width) @results-sidebar-width;
+        grid-template-columns:
+          calc(var(--center-page-width) - @results-gap - @results-sidebar-width)
+          @results-sidebar-width;
 
         #backToTop {
           .ltr-left(calc(50% - @results-sidebar-width - @results-gap + 1rem + var(--center-page-width) / 2));

client/simple/src/less/style-ltr.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 .ltr-left(@offset) {
   left: @offset;
 }

client/simple/src/less/style-rtl.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 .ltr-left(@offset) {
   right: @offset;
 }
@@ -109,7 +111,11 @@
 }
 
 // Image detail
-#results.image-detail-open article.result-images[data-vim-selected] .detail .result-images-labels p {
+#results.image-detail-open
+  article.result-images[data-vim-selected]
+  .detail
+  .result-images-labels
+  p {
   direction: rtl;
 
   &.result-url {
@@ -125,7 +131,7 @@
 }
 
 // select HTML element
-@supports ((background-position-x: 100%) and ((appearance: none) or (-webkit-appearance: none) or (-moz-appearance: none))) {
+@supports ((background-position-x: 100%) and ((appearance: none))) {
   select {
     border-width: 0 0 0 2rem;
     background-position-x: -2rem;

client/simple/src/less/style.less

@@ -1,24 +1,18 @@
-/*
-* SearXNG, A privacy-respecting, hackable metasearch engine
-*
-* To convert "style.less" to "style.css" run: $make styles
-*/
+// SPDX-License-Identifier: AGPL-3.0-or-later
 
 // stylelint-disable no-descending-specificity
 
 @import (inline) "../../node_modules/normalize.css/normalize.css";
 @import "definitions.less";
 @import "mixins.less";
-@import "code.less";
 @import "toolkit.less";
 @import "autocomplete.less";
-@import "detail.less";
 @import "animations.less";
 @import "embedded.less";
 @import "info.less";
-@import "new_issue.less";
 @import "stats.less";
 @import "result_templates.less";
+@import "weather.less";
 
 // for index.html template
 @import "index.less";
@@ -32,8 +26,8 @@
 // to center the results
 @import "style-center.less";
 
-// ion-icon
-.ion-icon {
+// sxng-icon-set
+.sxng-icon-set {
   display: inline-block;
   vertical-align: bottom;
   line-height: 1;
@@ -41,16 +35,16 @@
   .ltr-transform();
 }
 
-.ion-icon-small {
+.sxng-icon-set-small {
   width: 1rem;
   height: 1rem;
-  .ion-icon;
+  .sxng-icon-set;
 }
 
-.ion-icon-big {
+.sxng-icon-set-big {
   width: 1.5rem;
   height: 1.5rem;
-  .ion-icon;
+  .sxng-icon-set;
 }
 
 // Main LESS-Code
@@ -80,6 +74,12 @@ body {
   margin: 0;
 }
 
+@supports (height: 100dvh) {
+  body {
+    height: 100dvh;
+  }
+}
+
 main {
   width: 100%;
   margin-bottom: 2rem;
@@ -161,12 +161,22 @@ article[data-vim-selected].category-videos,
 article[data-vim-selected].category-news,
 article[data-vim-selected].category-map,
 article[data-vim-selected].category-music,
-article[data-vim-selected].category-files,
 article[data-vim-selected].category-social {
   border: 1px solid var(--color-result-vim-arrow);
   .rounded-corners;
 }
 
+.image-label-bottom-right() {
+  position: absolute;
+  right: 0;
+  bottom: 0;
+  background: var(--color-image-resolution-background);
+  padding: 0.3rem 0.5rem;
+  font-size: 0.9rem;
+  color: var(--color-image-resolution-font);
+  border-top-left-radius: 0.3rem;
+}
+
 .result {
   margin: @results-margin 0;
   padding: @result-padding;
@@ -176,7 +186,7 @@ article[data-vim-selected].category-social {
 
   h3 {
     font-size: 1.2rem;
-    word-wrap: break-word;
+    overflow-wrap: break-word;
     margin: 0.4rem 0 0.4rem 0;
     padding: 0;
 
@@ -210,7 +220,7 @@ article[data-vim-selected].category-social {
     margin: 0;
     padding: 0;
     max-width: 54em;
-    word-wrap: break-word;
+    overflow-wrap: break-word;
     line-height: 1.24;
 
     .highlight {
@@ -244,9 +254,8 @@ article[data-vim-selected].category-social {
     align-items: center;
     font-size: 1rem;
     color: var(--color-result-url-font);
-    flex-wrap: nowrap;
+    flex-flow: row nowrap;
     overflow: hidden;
-    flex-direction: row;
     margin: 0;
     padding: 0;
 
@@ -269,9 +278,7 @@ article[data-vim-selected].category-social {
     .url_o2 {
       overflow: hidden;
       white-space: nowrap;
-      flex-basis: content;
-      flex-grow: 0;
-      flex-shrink: 1;
+      flex: 0 1 content;
       text-align: right;
       padding-bottom: 1px;
 
@@ -296,12 +303,22 @@ article[data-vim-selected].category-social {
     color: var(--color-result-description-highlight-font);
   }
 
-  img.thumbnail {
+  a.thumbnail_link {
+    position: relative;
+    margin-top: 0.6rem;
+    .ltr-margin-right(1rem);
     .ltr-float-left();
-    padding-top: 0.6rem;
-    .ltr-padding-right(1rem);
-    width: 7rem;
-    height: unset; // remove height value that was needed for lazy loading
+
+    img.thumbnail {
+      width: 7rem;
+      height: unset; // remove height value that was needed for lazy loading
+      display: block;
+    }
+
+    .thumbnail_length {
+      .image-label-bottom-right();
+      right: 6px;
+    }
   }
 
   .break {
@@ -309,11 +326,11 @@ article[data-vim-selected].category-social {
   }
 }
 
-.result-paper,
 .result-packages {
   .attributes {
     display: table;
     border-spacing: 0.125rem;
+    margin-top: 0.3rem;
 
     div {
       display: table-row;
@@ -347,18 +364,12 @@ article[data-vim-selected].category-social {
     font-size: 0.9rem;
     margin: 0.25rem 0 0 0;
     padding: 0;
-    word-wrap: break-word;
+    overflow-wrap: break-word;
     line-height: 1.24;
     font-style: italic;
   }
 }
 
-.result-packages {
-  .attributes {
-    margin-top: 0.3rem;
-  }
-}
-
 .template_group_images {
   display: flex;
   flex-wrap: wrap;
@@ -373,7 +384,6 @@ article[data-vim-selected].category-social {
 .category-news,
 .category-map,
 .category-music,
-.category-files,
 .category-social {
   border: 1px solid var(--color-result-border);
   margin: 0 @results-tablet-offset 1rem @results-tablet-offset !important;
@@ -398,23 +408,19 @@ article[data-vim-selected].category-social {
 }
 
 .result-videos {
-  img.thumbnail {
-    .ltr-float-left();
-    padding-top: 0.6rem;
-    .ltr-padding-right(1rem);
+  a.thumbnail_link img.thumbnail {
     width: 20rem;
-    height: unset; // remove height value that was needed for lazy loading
   }
-}
 
-.result-videos .content {
-  overflow: hidden;
-}
+  .content {
+    overflow: hidden;
+  }
 
-.result-videos .embedded-video iframe {
-  width: 100%;
-  aspect-ratio: 16 / 9;
-  padding: 10px 0 0 0;
+  .embedded-video iframe {
+    width: 100%;
+    aspect-ratio: 16 / 9;
+    padding: 10px 0 0 0;
+  }
 }
 
 @supports not (aspect-ratio: 1 / 1) {
@@ -472,21 +478,14 @@ article[data-vim-selected].category-social {
     padding: 0;
     border: none;
     height: 100%;
-    width: 100%;
+    width: auto;
     object-fit: cover;
     vertical-align: bottom;
     background: var(--color-result-image-background);
   }
 
   .image_resolution {
-    position: absolute;
-    right: 0;
-    bottom: 0;
-    background: var(--color-image-resolution-background);
-    padding: 0.3rem 0.5rem;
-    font-size: 0.9rem;
-    color: var(--color-image-resolution-font);
-    border-top-left-radius: 0.3rem;
+    .image-label-bottom-right();
   }
 
   span.title,
@@ -546,14 +545,13 @@ article[data-vim-selected].category-social {
   margin-bottom: 0;
   .ltr-margin-left(@results-offset);
   display: grid;
-  grid-template-columns: @results-width @results-sidebar-width;
-  grid-template-rows: min-content min-content 1fr min-content;
+  grid-template:
+    "corrections sidebar" min-content
+    "answers sidebar" min-content
+    "urls sidebar" 1fr
+    "pagination sidebar" min-content
+    / @results-width @results-sidebar-width;
   gap: 0 @results-gap;
-  grid-template-areas:
-    "corrections sidebar"
-    "answers sidebar"
-    "urls sidebar"
-    "pagination sidebar";
 }
 
 #results #sidebar *:first-child {
@@ -571,13 +569,16 @@ article[data-vim-selected].category-social {
 
 #suggestions {
   .wrapper {
-    display: flex;
-    flex-flow: column;
-    justify-content: flex-end;
+    padding-left: 0;
+    margin: 0;
+    list-style-position: inside;
+
+    li::marker {
+      color: var(--color-result-link-font);
+    }
 
     form {
       display: inline-block;
-      flex: 1 1 50%;
     }
   }
 }
@@ -585,8 +586,8 @@ article[data-vim-selected].category-social {
 #suggestions,
 #infoboxes {
   input {
-    padding: 0;
-    margin: 3px;
+    padding: 3px;
+    margin: 0;
     font-size: 0.9em;
     display: inline-block;
     background: transparent;
@@ -676,10 +677,7 @@ summary.title {
   }
 
   .answer-url {
-    margin-left: auto;
-    margin-top: 5px;
-    margin-right: 10px;
-    margin-bottom: 10px;
+    margin: 5px 10px 10px auto;
   }
 }
 
@@ -691,7 +689,7 @@ summary.title {
 
 #sidebar {
   grid-area: sidebar;
-  word-wrap: break-word;
+  overflow-wrap: break-word;
   color: var(--color-sidebar-font);
 
   .infobox {
@@ -788,7 +786,7 @@ summary.title {
     padding: 0.4rem;
     margin-left: 0.5rem;
     border-radius: 0.3rem;
-    display: none;    // will be shown by JS.
+    display: none; // will be shown by JS.
   }
 }
 
@@ -979,19 +977,18 @@ summary.title {
     margin: 0 auto;
     justify-content: center;
     display: grid;
-    grid-template-columns: @results-width;
-    grid-template-rows: min-content min-content min-content 1fr min-content min-content;
+    grid-template:
+      "corrections" min-content
+      "answers" min-content
+      "sidebar" min-content
+      "urls" 1fr
+      "pagination" min-content
+      / @results-width;
     gap: 0;
-    grid-template-areas:
-      "corrections"
-      "answers"
-      "sidebar"
-      "urls"
-      "pagination";
   }
 }
 
-@media screen and (max-width: calc(@tablet - 0.5px)) {
+@media screen and (width <= calc(@tablet - 0.5px)) {
   #links_on_top {
     span {
       display: none;
@@ -999,7 +996,7 @@ summary.title {
   }
 }
 
-@media screen and (max-width: 52rem) {
+@media screen and (width <= 52rem) {
   body.results_endpoint {
     #links_on_top {
       .link_on_top_about,
@@ -1024,19 +1021,14 @@ summary.title {
 #main_results div#results.only_template_images {
   margin: 1rem @results-tablet-offset 0 @results-tablet-offset;
   display: grid;
-  grid-template-columns: 100%;
-  grid-template-rows: min-content min-content min-content 1fr min-content;
+  grid-template:
+    "corrections" min-content
+    "answers" min-content
+    "sidebar" min-content
+    "urls" 1fr
+    "pagination" min-content
+    / 100%;
   gap: 0;
-  grid-template-areas:
-    "corrections"
-    "answers"
-    "sidebar"
-    "urls"
-    "pagination";
-
-  #sidebar {
-    display: none;
-  }
 
   #urls {
     margin: 0;
@@ -1124,7 +1116,6 @@ summary.title {
     display: none;
   }
 
-  .result-paper,
   .result-packages {
     .attributes {
       display: block;
@@ -1167,3 +1158,10 @@ summary.title {
 pre code {
   white-space: pre-wrap;
 }
+
+// import layouts of the Result types
+@import "result_types/keyvalue.less";
+@import "result_types/code.less";
+@import "result_types/paper.less";
+@import "result_types/file.less";
+@import "result_types/image.less";

client/simple/src/less/toolkit.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 // other solution :  http://stackoverflow.com/questions/1577598/how-to-hide-parts-of-html-when-javascript-is-disabled/13857783#13857783
 
 // stylelint-disable no-descending-specificity
@@ -156,9 +158,7 @@ div.selectable_url {
 
   td {
     padding: 0 1em 0 0;
-    padding-top: 0;
     .ltr-padding-right(1rem);
-    padding-bottom: 0;
     .ltr-padding-left(0);
   }
 
@@ -193,6 +193,15 @@ div.selectable_url {
   border-color: var(--color-warning);
 }
 
+.dialog-warning-block {
+  .dialog();
+
+  display: block;
+  color: var(--color-warning);
+  background: var(--color-warning-background);
+  border-color: var(--color-warning);
+}
+
 .dialog-modal {
   .dialog();
 
@@ -203,7 +212,7 @@ div.selectable_url {
   left: 50%;
   margin: 0 auto;
   transform: translate(-50%, -50%);
-  z-index: 10000000;
+  z-index: 5000;
 
   h3 {
     margin-top: 0;
@@ -217,8 +226,7 @@ div.selectable_url {
 
 //
 .scrollx {
-  overflow-x: auto;
-  overflow-y: hidden;
+  overflow: auto hidden;
   display: block;
   padding: 0;
   margin: 0;
@@ -250,7 +258,7 @@ ul.tabs {
     order: 2;
   }
 
-  & > input[type=radio] {
+  & > input[type="radio"] {
     display: none;
   }
 
@@ -308,7 +316,7 @@ html body .tabs > input:checked {
   }
 
   ~ label {
-    position: inherited;
+    position: inherit;
     background: inherit;
     border-bottom: 2px solid transparent;
     font-weight: normal;
@@ -340,7 +348,7 @@ select {
   padding: 0.2rem !important;
   color: var(--color-search-font);
   font-size: 0.9rem;
-  z-index: 2;
+  z-index: 100;
 
   &:hover,
   &:focus {
@@ -348,14 +356,13 @@ select {
   }
 }
 
-@supports ((background-position-x: 100%) and ((appearance: none) or (-webkit-appearance: none) or (-moz-appearance: none))) {
+@supports ((background-position-x: 100%) and ((appearance: none))) {
   select {
     appearance: none;
-    -webkit-appearance: none;
-    -moz-appearance: none;
     border-width: 0 2rem 0 0;
     border-color: transparent;
-    background: data-uri('image/svg+xml;charset=UTF-8', @select-light-svg-path) no-repeat;
+    background: data-uri("image/svg+xml;charset=UTF-8", @select-light-svg-path)
+      no-repeat;
     background-position-x: calc(100% + 2rem);
     background-size: 2rem;
     background-origin: content-box;
@@ -377,19 +384,23 @@ select {
   @media (prefers-color-scheme: dark) {
     html.theme-auto select,
     html.theme-dark select {
-      background-image: data-uri('image/svg+xml;charset=UTF-8', @select-dark-svg-path);
+      background-image: data-uri(
+        "image/svg+xml;charset=UTF-8",
+        @select-dark-svg-path
+      );
     }
   }
 
   html.theme-dark select {
-    background-image: data-uri('image/svg+xml;charset=UTF-8', @select-dark-svg-path);
+    background-image: data-uri(
+      "image/svg+xml;charset=UTF-8",
+      @select-dark-svg-path
+    );
   }
 }
 
 /* -- checkbox-onoff -- */
 input.checkbox-onoff[type="checkbox"] {
-  -webkit-appearance: none;
-  -moz-appearance: none;
   appearance: none;
   cursor: pointer;
   display: inline-block;
@@ -414,7 +425,7 @@ input.checkbox-onoff[type="checkbox"] {
     border: 1px solid var(--color-btn-background);
     border-radius: 12px;
     box-shadow: var(--color-btn-background) 0 0 3px;
-    z-index: 10000;
+    z-index: 1200;
     top: -0.55em;
     left: -0.6em;
   }
@@ -462,9 +473,7 @@ input.checkbox-onoff.reversed-checkbox[type="checkbox"] {
 
 /* -- checkbox -- */
 @supports (transform: rotate(-45deg)) {
-  input[type=checkbox]:not(.checkbox-onoff) {
-    -webkit-appearance: none;
-    -moz-appearance: none;
+  input[type="checkbox"]:not(.checkbox-onoff) {
     appearance: none;
 
     width: 20px;
@@ -477,7 +486,7 @@ input.checkbox-onoff.reversed-checkbox[type="checkbox"] {
     .rounded-corners(0.3em);
 
     &::after {
-      content: '';
+      content: "";
       width: 9px;
       height: 5px;
       position: absolute;
@@ -498,14 +507,18 @@ input.checkbox-onoff.reversed-checkbox[type="checkbox"] {
   }
 
   // disabled : can't be focused, show only the check mark
-  input[type=checkbox][disabled]:not(.checkbox-onoff) {
+  input[type="checkbox"][disabled]:not(.checkbox-onoff) {
     border: inherit;
     background-color: transparent !important;
     cursor: inherit;
   }
 
   // if not checked and possible to checked then display a "light" check mark on hover
-  input.checkbox[type=checkbox]:not(:checked):not([disabled]):not(.checkbox-onoff):hover::after {
+  input.checkbox[type="checkbox"]:not(
+      :checked,
+      [disabled],
+      .checkbox-onoff
+    ):hover::after {
     opacity: 0.5;
   }
 }
@@ -533,33 +546,16 @@ input.checkbox-onoff.reversed-checkbox[type="checkbox"] {
   border-right: 0.5em solid var(--color-toolkit-loader-border);
   border-bottom: 0.5em solid var(--color-toolkit-loader-border);
   border-left: 0.5em solid var(--color-toolkit-loader-borderleft);
-  -webkit-transform: translateZ(0);
-  -ms-transform: translateZ(0);
   transform: translateZ(0);
-  -webkit-animation: load8 1.2s infinite linear;
   animation: load8 1.2s infinite linear;
 }
 
-@-webkit-keyframes load8 {
-  0% {
-    -webkit-transform: rotate(0deg);
-    transform: rotate(0deg);
-  }
-
-  100% {
-    -webkit-transform: rotate(360deg);
-    transform: rotate(360deg);
-  }
-}
-
 @keyframes load8 {
   0% {
-    -webkit-transform: rotate(0deg);
     transform: rotate(0deg);
   }
 
   100% {
-    -webkit-transform: rotate(360deg);
     transform: rotate(360deg);
   }
 }
@@ -574,7 +570,7 @@ input.checkbox-onoff.reversed-checkbox[type="checkbox"] {
   background: var(--color-toolkit-engine-tooltip-background);
   font-size: 14px;
   font-weight: normal;
-  z-index: 1000000;
+  z-index: 5000;
   text-align: left;
   .rounded-corners;
 }
@@ -590,11 +586,7 @@ td:hover .engine-tooltip,
   margin: 0;
   padding: 0 0.125rem 0 4rem;
   width: 100%;
-  width: -moz-available;
-  width: -webkit-fill-available;
-  width: fill;
-  flex-direction: row;
-  flex-wrap: nowrap;
+  flex-flow: row nowrap;
   align-items: center;
   display: inline-flex;
 }
@@ -618,7 +610,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: var(--color-base-font);
-  border: 1px solid rgba(var(--color-base-font-rgb), 0.9);
+  border: 1px solid rgb(var(--color-base-font-rgb), 0.9);
   padding: 0.3rem 0;
 }
 
@@ -626,7 +618,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border: 1px solid rgba(var(--color-base-font-rgb), 0.3);
+  border: 1px solid rgb(var(--color-base-font-rgb), 0.3);
   padding: 0.3rem 0;
 }
 
@@ -634,7 +626,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border-bottom: 1px dotted rgba(var(--color-base-font-rgb), 0.5);
+  border-bottom: 1px dotted rgb(var(--color-base-font-rgb), 0.5);
   padding: 0;
 }
 
@@ -642,7 +634,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border-left: 1px solid rgba(var(--color-base-font-rgb), 0.9);
+  border-left: 1px solid rgb(var(--color-base-font-rgb), 0.9);
   padding: 0.4rem 0;
   width: 1px;
 }

client/simple/src/less/toolkit_loader.less

@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
 .loader,
 .loader::after {
   border-radius: 50%;
@@ -14,33 +16,16 @@
   border-right: 1.1em solid var(--color-loading-indicator);
   border-bottom: 1.1em solid var(--color-loading-indicator);
   border-left: 1.1em solid var(--color-loading-indicator-gap);
-  -webkit-transform: translateZ(0);
-  -ms-transform: translateZ(0);
   transform: translateZ(0);
-  -webkit-animation: load8 1.1s infinite linear;
   animation: load8 1.1s infinite linear;
 }
 
-@-webkit-keyframes load8 {
-  0% {
-    -webkit-transform: rotate(0deg);
-    transform: rotate(0deg);
-  }
-
-  100% {
-    -webkit-transform: rotate(360deg);
-    transform: rotate(360deg);
-  }
-}
-
 @keyframes load8 {
   0% {
-    -webkit-transform: rotate(0deg);
     transform: rotate(0deg);
   }
 
   100% {
-    -webkit-transform: rotate(360deg);
     transform: rotate(360deg);
   }
 }

client/simple/src/less/weather.less

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+#answers .weather {
+  summary {
+    display: block;
+    list-style: none;
+  }
+
+  div.summary {
+    margin: 0;
+    padding: 0.5rem 1rem;
+    background-color: var(--color-header-background);
+    .rounded-corners-tiny;
+  }
+
+  table {
+    font-size: 0.9rem;
+    table-layout: fixed;
+    margin-top: 0.5rem;
+    margin-bottom: 0.5rem;
+    border-collapse: separate;
+    border-spacing: 0.1em 0;
+  }
+
+  td {
+    padding: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  img.symbol {
+    width: 5rem;
+    margin: auto;
+    display: block;
+  }
+
+  .title {
+    // background-color: var(--color-result-keyvalue-even);
+  }
+
+  .measured {
+    // background-color: var(--color-result-keyvalue-odd);
+  }
+}

client/simple/src/svg/empty_favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
+  <path fill="#58f" d="M11 20.85a.92.92 0 0 1-1.1.93A10 10 0 0 1 2.06 13c-.06-.55.4-1 .95-1h3a1 1 0 0 1 1 1 3 3 0 0 0 3 3 1 1 0 0 1 1 1v3.85Zm6-1.92c0 .77.83 1.23 1.42.74a10 10 0 0 0 2.03-2.32c.39-.61-.09-1.35-.81-1.35H18a1 1 0 0 0-1 1v1.93ZM12 2a10 10 0 0 1 6.65 2.53c.61.55.17 1.47-.65 1.47h-.15A2.85 2.85 0 0 0 15 8.85c0 .33-.18.62-.47.77l-.08.04a1 1 0 0 1-.9 0l-.08-.04a.85.85 0 0 1-.47-.77A2.85 2.85 0 0 0 10.15 6H10a1 1 0 0 1-1-1V3.2c0-.44.28-.84.7-.94C10.45 2.1 11.22 2 12 2Z"/>
+  <path fill="#58f" d="M3.42 10c-.63 0-1.1-.58-.9-1.18.6-1.8 1.7-3.36 3.12-4.53C6.2 3.82 7 4.26 7 5a3 3 0 0 0 3 3h.15c.47 0 .85.38.85.85 0 1.09.61 2.07 1.58 2.56l.08.04a3 3 0 0 0 2.68 0l.08-.04A2.85 2.85 0 0 0 17 8.85c0-.47.38-.85.85-.85h2.66c.4 0 .77.23.9.6a9.98 9.98 0 0 1 .52 4.6.94.94 0 0 1-.95.8H18a3 3 0 0 0-3 3v3.8c0 .44-.28.84-.7.94l-.2.04a.92.92 0 0 1-1.1-.93V17a3 3 0 0 0-3-3 1 1 0 0 1-1-1 3 3 0 0 0-3-3H3.42Z"/>
+</svg>

client/simple/src/svg/ionicons/information-circle-outline.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+    <path d="M248 64C146.39 64 64 146.39 64 248s82.39 184 184 184 184-82.39 184-184S349.61 64 248 64z" fill="none" stroke="currentColor" stroke-miterlimit="10" stroke-width="32"/>
+    <path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="32" d="M220 220h32v116"/>
+    <path fill="none" stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="32" d="M208 340h88"/>
+    <path d="M248 130a26 26 0 1026 26 26 26 0 00-26-26z" fill="currentColor" stroke="currentColor" stroke-miterlimit="10" stroke-width="1"/>
+</svg>

client/simple/src/svg/ionicons/newspaper-outline.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+    <path d="M368 415.86V72a24.07 24.07 0 00-24-24H72a24.07 24.07 0 00-24 24v352a40.12 40.12 0 0040 40h328" fill="none" stroke="currentColor" stroke-linejoin="round" stroke-width="32"/>
+    <path d="M416 464h0a48 48 0 01-48-48V128h72a24 24 0 0124 24v264a48 48 0 01-48 48z" fill="none" stroke="currentColor" stroke-linejoin="round" stroke-width="32"/>
+    <path d="M240 128h64M240 192h64M112 256h192M112 320h192M112 384h192" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="32"/>
+    <path d="M176 208h-64a16 16 0 01-16-16v-64a16 16 0 0116-16h64a16 16 0 0116 16v64a16 16 0 01-16 16z" fill="currentColor" stroke="currentColor" stroke-linejoin="round" stroke-width="1"   />
+</svg>

client/simple/theme_icons.ts

@@ -0,0 +1,84 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**
+ * Generate icons.html for the jinja templates of the simple theme.
+ */
+
+import { dirname, resolve } from "node:path";
+import { argv } from "node:process";
+import type { Config as SvgoConfig } from "svgo";
+import { type IconSet, type JinjaMacro, jinja_svg_sets } from "./tools/jinja_svg_catalog.ts";
+
+const HERE = `${dirname(argv[1] || "")}/`;
+const dest: string = resolve(HERE, "../../searx/templates/simple/icons.html");
+
+const searxng_jinja_macros: JinjaMacro[] = [
+  { name: "icon", class: "sxng-icon-set" },
+  { name: "icon_small", class: "sxng-icon-set-small" },
+  { name: "icon_big", class: "sxng-icon-set-big" }
+];
+
+const sxng_icon_opts: SvgoConfig = {
+  multipass: true,
+  plugins: [
+    "removeTitle",
+    "removeXMLNS",
+    {
+      name: "addAttributesToSVGElement",
+      params: {
+        attributes: [{ "aria-hidden": "true" }]
+      }
+    }
+  ]
+};
+
+const simple_icons: IconSet[] = [
+  {
+    base: resolve(HERE, "node_modules/ionicons/dist/svg"),
+    set: {
+      alert: "alert-outline.svg",
+      appstore: "apps-outline.svg",
+      book: "book-outline.svg",
+      close: "close-outline.svg",
+      download: "download-outline.svg",
+      "ellipsis-vertical": "ellipsis-vertical-outline.svg",
+      "file-tray-full": "file-tray-full-outline.svg",
+      film: "film-outline.svg",
+      globe: "globe-outline.svg",
+      heart: "heart-outline.svg",
+      image: "image-outline.svg",
+      layers: "layers-outline.svg",
+      leecher: "arrow-down.svg",
+      location: "location-outline.svg",
+      magnet: "magnet-outline.svg",
+      "musical-notes": "musical-notes-outline.svg",
+      "navigate-down": "chevron-down-outline.svg",
+      "navigate-left": "chevron-back-outline.svg",
+      "navigate-right": "chevron-forward-outline.svg",
+      "navigate-up": "chevron-up-outline.svg",
+      people: "people-outline.svg",
+      play: "play-outline.svg",
+      radio: "radio-outline.svg",
+      save: "save-outline.svg",
+      school: "school-outline.svg",
+      search: "search-outline.svg",
+      seeder: "swap-vertical.svg",
+      settings: "settings-outline.svg",
+      tv: "tv-outline.svg"
+    },
+    svgo_opts: sxng_icon_opts
+  },
+  // some of the ionicons are not suitable for a dark theme, we fixed the svg
+  // manually in src/svg/ionicons
+  // - https://github.com/searxng/searxng/pull/4284#issuecomment-2680550342
+  {
+    base: resolve(HERE, "src/svg/ionicons"),
+    set: {
+      "information-circle": "information-circle-outline.svg",
+      newspaper: "newspaper-outline.svg"
+    },
+    svgo_opts: sxng_icon_opts
+  }
+];
+
+jinja_svg_sets(dest, searxng_jinja_macros, simple_icons);

client/simple/tools/img.ts

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import fs from "node:fs";
+import path from "node:path";
+import sharp from "sharp";
+import type { Config } from "svgo";
+import { optimize as svgo } from "svgo";
+
+// Mapping of src to dest
+export type Src2Dest = {
+  // Name of the source file.
+  src: string;
+  // Name of the destination file.
+  dest: string;
+};
+
+/**
+ * Convert a list of SVG files to PNG.
+ *
+ * @param items - Array of SVG files (src: SVG, dest:PNG) to convert.
+ * @param width - (optional) width of the PNG pictures
+ * @param height - (optional) height of the PNG pictures.
+ */
+export const svg2png = (items: Src2Dest[], width?: number, height?: number): void => {
+  for (const item of items) {
+    fs.mkdirSync(path.dirname(item.dest), { recursive: true });
+
+    sharp(item.src)
+      .png({
+        force: true,
+        compressionLevel: 9,
+        palette: true
+      })
+      .resize(width, height, {
+        fit: "contain"
+      })
+      .toFile(item.dest)
+      .then((info) => {
+        console.log(`[svg2png] created ${item.dest} -- bytes: ${info.size}, w:${info.width}px,  h:${info.height}px`);
+      })
+      .catch((error) => {
+        console.error(`ERROR: ${item.dest} -- ${error}`);
+        throw error;
+      });
+  }
+};
+
+/**
+ * Optimize SVG images for WEB.
+ *
+ * @param items - Array of SVG files (src:SVG, dest:SVG) to optimize.
+ * @param svgo_opts - Options passed to svgo.
+ */
+export const svg2svg = (items: Src2Dest[], svgo_opts: Config): void => {
+  for (const item of items) {
+    try {
+      fs.mkdirSync(path.dirname(item.dest), { recursive: true });
+
+      const raw = fs.readFileSync(item.src, "utf8");
+      const opt = svgo(raw, svgo_opts);
+
+      fs.writeFileSync(item.dest, opt.data);
+      console.log(`[svg2svg] optimized: ${item.dest} -- src: ${item.src}`);
+    } catch (error) {
+      console.error(`ERROR: optimize src: ${item.src} -- ${error}`);
+      throw error;
+    }
+  }
+};

client/simple/tools/jinja_svg_catalog.html.edge

@@ -0,0 +1,28 @@
+{{--
+SPDX-License-Identifier: AGPL-3.0-or-later
+
+This is a EDGE https://edgejs.dev/ template to generate a HTML Jinja template
+for the backend.  Example output of this EDGE template:
+- https://github.com/searxng/searxng/blob/master/searx/templates/simple/icons.html
+--}}
+{#
+Catalog of SVG symbols that can be inserted into the HTML output of a Jinja
+template. This file from:
+
+  client/simple/tools/icon_catalog.edge.html
+#}
+
+{%-
+set catalog = {
+@each((svg, name) in svg_catalog)
+    '{{{name}}}' : '{{{svg}}}',
+@end
+}
+-%}
+
+@each(macro in macros)
+
+{% macro {{ macro.name }}(action, alt) -%}
+  {{ open_curly_brace }} catalog[action] | replace("{{__jinja_class_placeholder__}}", "{{ macro.class }}") | safe {{ close_curly_brace }}
+{%- endmacro %}
+@end

client/simple/tools/jinja_svg_catalog.ts

@@ -0,0 +1,118 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import fs from "node:fs";
+import { dirname, resolve } from "node:path";
+import { Edge } from "edge.js";
+import { type Config as SvgoConfig, optimize as svgo } from "svgo";
+
+const __jinja_class_placeholder__ = "__jinja_class_placeholder__";
+
+// A set of icons
+export type IconSet = {
+  // Object of SVG icons, where property name is the name of the icon and value is the src of the SVG (relative to base)
+  set: Record<string, string>;
+  // Folder in which the SVG src files are located
+  base: string;
+  // svgo options for this set
+  svgo_opts: SvgoConfig;
+};
+
+// Mapping of icon name to SVG source file
+type IconSVG = {
+  // Name of the icon isource file
+  name: string;
+  // Name of the destination file
+  src: string;
+  // Options passed to svgo
+  svgo_opts: SvgoConfig;
+};
+
+// Arguments to create a jinja macro
+export type JinjaMacro = {
+  // Name of the jinja macro
+  name: string;
+  // SVG's class name (value of XML class attribute)
+  class: string;
+};
+
+/**
+ * Generate a jinja template with a catalog of SVG icons that can be
+ * used in other HTML jinja templates.
+ *
+ * @param dest - filename of the generate jinja template.
+ * @param macros - Jinja macros to create.
+ * @param items - Array of SVG items.
+ */
+export const jinja_svg_catalog = (dest: string, macros: JinjaMacro[], items: IconSVG[]): void => {
+  const svg_catalog: Record<string, string> = {};
+  const edge_template = resolve(import.meta.dirname, "jinja_svg_catalog.html.edge");
+
+  for (const item of items) {
+    // JSON.stringify & JSON.parse are used to create a deep copy of the item.svgo_opts object
+    const svgo_opts: SvgoConfig = JSON.parse(JSON.stringify(item.svgo_opts));
+
+    svgo_opts.plugins?.push({
+      name: "addClassesToSVGElement",
+      params: {
+        classNames: [__jinja_class_placeholder__]
+      }
+    });
+
+    try {
+      const raw = fs.readFileSync(item.src, "utf8");
+      const opt = svgo(raw, svgo_opts);
+
+      svg_catalog[item.name] = opt.data;
+    } catch (error) {
+      console.error(`ERROR: jinja_svg_catalog processing ${item.name} src: ${item.src} -- ${error}`);
+      throw error;
+    }
+  }
+
+  fs.mkdirSync(dirname(dest), { recursive: true });
+
+  const ctx = {
+    svg_catalog: svg_catalog,
+    macros: macros,
+    edge_template: edge_template,
+    __jinja_class_placeholder__: __jinja_class_placeholder__,
+    // see https://github.com/edge-js/edge/issues/162
+    open_curly_brace: "{{",
+    close_curly_brace: "}}"
+  };
+
+  const jinjatmpl = Edge.create().renderRawSync(fs.readFileSync(edge_template, "utf-8"), ctx);
+
+  fs.writeFileSync(dest, jinjatmpl);
+  console.log(`[jinja_svg_catalog] created: ${dest}`);
+};
+
+/**
+ * Calls jinja_svg_catalog for a collection of icon sets where each set has its
+ * own parameters.
+ *
+ * @param dest - filename of the generate jinja template.
+ * @param macros - Jinja macros to create.
+ * @param sets - Array of SVG sets.
+ */
+export const jinja_svg_sets = (dest: string, macros: JinjaMacro[], sets: IconSet[]): void => {
+  const items: IconSVG[] = [];
+  const all: string[] = [];
+
+  for (const obj of sets) {
+    for (const [name, file] of Object.entries(obj.set)) {
+      if (all.includes(name)) {
+        throw new Error(`ERROR: ${name} has already been defined`);
+      }
+
+      all.push(name);
+      items.push({
+        name: name,
+        src: resolve(obj.base, file),
+        svgo_opts: obj.svgo_opts
+      });
+    }
+  }
+
+  jinja_svg_catalog(dest, macros, items);
+};

client/simple/tools/plg.ts

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**
+ * Custom vite plugins to build the web-client components of the simple theme.
+ *
+ * HINT:
+ *   This is an initial implementation for the migration of the build process
+ *   from grunt to vite.  For fully support (vite: build & serve) more work is
+ *   needed.
+ */
+
+import type { Config } from "svgo";
+import type { Plugin } from "vite";
+import { type Src2Dest, svg2png, svg2svg } from "./img.ts";
+
+/**
+ * Vite plugin to convert a list of SVG files to PNG.
+ *
+ * @param items - Array of SVG files (src: SVG, dest:PNG) to convert.
+ * @param width - (optional) width of the PNG picture
+ * @param height - (optional) height of the PNG picture
+ */
+export const plg_svg2png = (items: Src2Dest[], width?: number, height?: number): Plugin => {
+  return {
+    name: "searxng-simple-svg2png",
+    apply: "build",
+    writeBundle: () => {
+      svg2png(items, width, height);
+    }
+  };
+};
+
+/**
+ * Vite plugin to optimize SVG images for WEB.
+ *
+ * @param items - Array of SVG files (src:SVG, dest:SVG) to optimize.
+ * @param svgo_opts - Options passed to svgo.
+ */
+export const plg_svg2svg = (items: Src2Dest[], svgo_opts: Config): Plugin => {
+  return {
+    name: "searxng-simple-svg2svg",
+    apply: "build",
+    writeBundle: () => {
+      svg2svg(items, svgo_opts);
+    }
+  };
+};

client/simple/tsconfig.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig.json",
+  "compilerOptions": {
+    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "target": "ES2022",
+
+    "allowImportingTsExtensions": true,
+    "allowJs": true,
+    "checkJs": true,
+    "esModuleInterop": true,
+    "incremental": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+
+    "strict": true,
+    "allowUnreachableCode": false,
+    "allowUnusedLabels": false,
+    "exactOptionalPropertyTypes": false,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noPropertyAccessFromIndexSignature": false,
+    "noUncheckedIndexedAccess": true,
+    "noUncheckedSideEffectImports": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "verbatimModuleSyntax": true,
+
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
+    "types": ["vite/client"]
+  },
+  "include": ["./"],
+  "exclude": ["./node_modules/"]
+}

client/simple/vite.config.ts

@@ -0,0 +1,210 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**
+ * CONFIG: https://vite.dev/config/
+ */
+
+import { resolve } from "node:path";
+import { constants as zlibConstants } from "node:zlib";
+import browserslistToEsbuild from "browserslist-to-esbuild";
+import { browserslistToTargets } from "lightningcss";
+import type { PreRenderedAsset } from "rolldown";
+import type { Config } from "svgo";
+import type { UserConfig } from "vite";
+import analyzer from "vite-bundle-analyzer";
+import manifest from "./package.json" with { type: "json" };
+import { plg_svg2png, plg_svg2svg } from "./tools/plg.ts";
+
+const ROOT = "../../"; // root of the git repository
+
+const PATH = {
+  brand: "src/brand/",
+  dist: resolve(ROOT, "searx/static/themes/simple/"),
+  modules: "node_modules/",
+  src: "src/",
+  templates: resolve(ROOT, "searx/templates/simple/")
+} as const;
+
+const svg2svg_opts: Config = {
+  plugins: [{ name: "preset-default" }, "sortAttrs", "convertStyleToAttrs"]
+};
+
+const svg2svg_favicon_opts: Config = {
+  plugins: [{ name: "preset-default" }, "sortAttrs"]
+};
+
+export default {
+  base: "./",
+  publicDir: "static/",
+
+  build: {
+    target: browserslistToEsbuild(manifest.browserslist),
+    assetsDir: "",
+    outDir: PATH.dist,
+    manifest: "manifest.json",
+    emptyOutDir: true,
+    sourcemap: true,
+    rolldownOptions: {
+      input: {
+        // entrypoint
+        core: `${PATH.src}/js/index.ts`,
+
+        // stylesheets
+        ltr: `${PATH.src}/less/style-ltr.less`,
+        rtl: `${PATH.src}/less/style-rtl.less`,
+        rss: `${PATH.src}/less/rss.less`
+      },
+
+      // file naming conventions / pathnames are relative to outDir (PATH.dist)
+      output: {
+        entryFileNames: "sxng-[name].min.js",
+        chunkFileNames: "chunk/[hash].min.js",
+        assetFileNames: ({ names }: PreRenderedAsset): string => {
+          const [name] = names;
+
+          switch (name?.split(".").pop()) {
+            case "css":
+              return "sxng-[name].min[extname]";
+            default:
+              return "sxng-[name][extname]";
+          }
+        },
+        sanitizeFileName: (name: string): string => {
+          return name
+            .normalize("NFD")
+            .replace(/[^a-zA-Z0-9.-]/g, "_")
+            .toLowerCase();
+        },
+        comments: {
+          legal: true
+        }
+      }
+    }
+  }, // end: build
+
+  plugins: [
+    // -- bundle analyzer
+    analyzer({
+      enabled: process.env.VITE_BUNDLE_ANALYZE === "true",
+      analyzerPort: "auto",
+      summary: true,
+      reportTitle: manifest.name,
+
+      // sidecars with max compression
+      gzipOptions: {
+        level: zlibConstants.Z_BEST_COMPRESSION
+      },
+      brotliOptions: {
+        params: {
+          [zlibConstants.BROTLI_PARAM_QUALITY]: zlibConstants.BROTLI_MAX_QUALITY
+        }
+      }
+    }),
+
+    // -- svg images
+    plg_svg2svg(
+      [
+        {
+          src: `${PATH.src}/svg/empty_favicon.svg`,
+          dest: `${PATH.dist}/img/empty_favicon.svg`
+        },
+        {
+          src: `${PATH.src}/svg/select-dark.svg`,
+          dest: `${PATH.dist}/img/select-dark.svg`
+        },
+        {
+          src: `${PATH.src}/svg/select-light.svg`,
+          dest: `${PATH.dist}/img/select-light.svg`
+        }
+      ],
+      svg2svg_opts
+    ),
+
+    // SearXNG brand (static)
+    plg_svg2png([
+      {
+        src: `${PATH.brand}/searxng-wordmark.svg`,
+        dest: `${PATH.dist}/img/favicon.png`
+      },
+      {
+        src: `${PATH.brand}/searxng.svg`,
+        dest: `${PATH.dist}/img/searxng.png`
+      }
+    ]),
+
+    // SearXNG PWA Icons (static)
+    plg_svg2png(
+      [
+        {
+          src: `${PATH.brand}/searxng-wordmark.svg`,
+          dest: `${PATH.dist}/img/512.png`
+        }
+      ],
+      512,
+      512
+    ),
+    plg_svg2png(
+      [
+        {
+          src: `${PATH.brand}/searxng-wordmark.svg`,
+          dest: `${PATH.dist}/img/192.png`
+        }
+      ],
+      192,
+      192
+    ),
+
+    // -- svg
+    plg_svg2svg(
+      [
+        {
+          src: `${PATH.brand}/searxng.svg`,
+          dest: `${PATH.dist}/img/searxng.svg`
+        },
+        {
+          src: `${PATH.brand}/img_load_error.svg`,
+          dest: `${PATH.dist}/img/img_load_error.svg`
+        }
+      ],
+      svg2svg_opts
+    ),
+
+    // -- favicon
+    plg_svg2svg(
+      [
+        {
+          src: `${PATH.brand}/searxng-wordmark.svg`,
+          dest: `${PATH.dist}/img/favicon.svg`
+        }
+      ],
+      svg2svg_favicon_opts
+    ),
+
+    // -- simple templates
+    plg_svg2svg(
+      [
+        {
+          src: `${PATH.brand}/searxng-wordmark.svg`,
+          dest: `${PATH.templates}/searxng-wordmark.min.svg`
+        }
+      ],
+      svg2svg_opts
+    )
+  ], // end: plugins
+
+  // FIXME: missing CCS sourcemaps!!
+  // see: https://github.com/vitejs/vite/discussions/13845#discussioncomment-11992084
+  //
+  // what I have tried so far (see config below):
+  //
+  // - build.sourcemap
+  // - esbuild.sourcemap
+  // - css.preprocessorOptions.less.sourceMap
+  css: {
+    transformer: "lightningcss",
+    lightningcss: {
+      targets: browserslistToTargets(manifest.browserslist)
+    },
+    devSourcemap: true
+  } // end: css
+} satisfies UserConfig;

container/.env.example

@@ -0,0 +1,15 @@
+# Read the documentation before using the `docker-compose.yml` file:
+# https://docs.searxng.org/admin/installation-docker.html
+#
+# Additional ENVs:
+# https://docs.searxng.org/admin/settings/settings_general.html#settings-general
+# https://docs.searxng.org/admin/settings/settings_server.html#settings-server
+
+# Use a specific version tag. E.g. "latest" or "2026.3.25-541c6c3cb".
+#SEARXNG_VERSION=latest
+
+# Listen to a specific address.
+#SEARXNG_HOST=[::]
+
+# Listen to a specific port.
+#SEARXNG_PORT=8080

container/builder.dockerfile

@@ -0,0 +1,31 @@
+FROM docker.io/searxng/base:searxng-builder AS builder
+
+COPY ./requirements.txt ./requirements-server.txt ./
+
+ENV UV_NO_MANAGED_PYTHON="true"
+ENV UV_NATIVE_TLS="true"
+
+ARG TIMESTAMP_VENV="0"
+
+RUN --mount=type=cache,id=uv,target=/root/.cache/uv set -eux -o pipefail; \
+    export SOURCE_DATE_EPOCH="$TIMESTAMP_VENV"; \
+    uv venv; \
+    uv pip install --requirements ./requirements.txt --requirements ./requirements-server.txt; \
+    uv cache prune --ci; \
+    find ./.venv/lib/ -type f -exec strip --strip-unneeded {} + || true; \
+    find ./.venv/lib/ -type d -name "__pycache__" -exec rm -rf {} +; \
+    find ./.venv/lib/ -type f -name "*.pyc" -delete; \
+    python -m compileall -q -f -j 0 --invalidation-mode=unchecked-hash ./.venv/lib/; \
+    find ./.venv/lib/python*/site-packages/*.dist-info/ -type f -name "RECORD" -exec sort -t, -k1,1 -o {} {} \;; \
+    find ./.venv/ -exec touch -h --date="@$TIMESTAMP_VENV" {} +
+
+COPY --exclude=./searx/version_frozen.py ./searx/ ./searx/
+
+RUN set -eux -o pipefail; \
+    python -m compileall -q -f -j 0 --invalidation-mode=unchecked-hash ./searx/; \
+    find ./searx/static/ -type f \
+    \( -name "*.html" -o -name "*.css" -o -name "*.js" -o -name "*.svg" \) \
+    -exec gzip -9 -k {} + \
+    -exec brotli -9 -k {} + \
+    -exec gzip --test {}.gz + \
+    -exec brotli --test {}.br +

container/dist.dockerfile

@@ -0,0 +1,44 @@
+ARG CONTAINER_IMAGE_ORGANIZATION="searxng"
+ARG CONTAINER_IMAGE_NAME="searxng"
+
+FROM localhost/$CONTAINER_IMAGE_ORGANIZATION/$CONTAINER_IMAGE_NAME:builder AS builder
+FROM docker.io/searxng/base:searxng AS dist
+
+COPY --chown=977:977 --from=builder /usr/local/searxng/.venv/ ./.venv/
+COPY --chown=977:977 --from=builder /usr/local/searxng/searx/ ./searx/
+COPY --chown=977:977 ./container/ ./
+COPY --chown=977:977 ./searx/version_frozen.py ./searx/
+
+ARG CREATED="0001-01-01T00:00:00Z"
+ARG VERSION="unknown"
+ARG VCS_URL="unknown"
+ARG VCS_REVISION="unknown"
+
+LABEL org.opencontainers.image.created="$CREATED" \
+    org.opencontainers.image.description="SearXNG is a metasearch engine. Users are neither tracked nor profiled." \
+    org.opencontainers.image.documentation="https://docs.searxng.org/admin/installation-docker" \
+    org.opencontainers.image.licenses="AGPL-3.0-or-later" \
+    org.opencontainers.image.revision="$VCS_REVISION" \
+    org.opencontainers.image.source="$VCS_URL" \
+    org.opencontainers.image.title="SearXNG" \
+    org.opencontainers.image.url="https://searxng.org" \
+    org.opencontainers.image.version="$VERSION"
+
+ENV __SEARXNG_VERSION="$VERSION" \
+    __SEARXNG_SETTINGS_PATH="$__SEARXNG_CONFIG_PATH/settings.yml" \
+    GRANIAN_PROCESS_NAME="searxng" \
+    GRANIAN_INTERFACE="wsgi" \
+    GRANIAN_HOST="::" \
+    GRANIAN_PORT="8080" \
+    GRANIAN_WEBSOCKETS="false" \
+    GRANIAN_BLOCKING_THREADS="4" \
+    GRANIAN_WORKERS_KILL_TIMEOUT="30s" \
+    GRANIAN_BLOCKING_THREADS_IDLE_TIMEOUT="5m"
+
+# "*_PATH" ENVs are defined in base images
+VOLUME $__SEARXNG_CONFIG_PATH
+VOLUME $__SEARXNG_DATA_PATH
+
+EXPOSE 8080
+
+ENTRYPOINT ["/usr/local/searxng/entrypoint.sh"]

container/docker-compose.yml

@@ -0,0 +1,28 @@
+# Read the documentation before using the `docker-compose.yml` file:
+# https://docs.searxng.org/admin/installation-docker.html
+
+name: searxng
+
+services:
+  core:
+    container_name: searxng-core
+    image: docker.io/searxng/searxng:${SEARXNG_VERSION:-latest}
+    restart: always
+    ports:
+      - ${SEARXNG_HOST:+${SEARXNG_HOST}:}${SEARXNG_PORT:-8080}:${SEARXNG_PORT:-8080}
+    env_file: ./.env
+    volumes:
+      - ./core-config/:/etc/searxng/:Z
+      - core-data:/var/cache/searxng/
+
+  valkey:
+    container_name: searxng-valkey
+    image: docker.io/valkey/valkey:9-alpine
+    command: valkey-server --save 30 1 --loglevel warning
+    restart: always
+    volumes:
+      - valkey-data:/data/
+
+volumes:
+  core-data:
+  valkey-data:

container/entrypoint.sh

@@ -0,0 +1,117 @@
+#!/bin/sh
+# shellcheck shell=dash
+set -u
+
+# Check if it's a valid file
+check_file() {
+    local target="$1"
+
+    if [ ! -f "$target" ]; then
+        cat <<EOF
+!!!
+!!! ERROR
+!!! "$target" is not a valid file, exiting...
+!!!
+EOF
+        exit 127
+    fi
+}
+
+# Check if it's a valid directory
+check_directory() {
+    local target="$1"
+
+    if [ ! -d "$target" ]; then
+        cat <<EOF
+!!!
+!!! ERROR
+!!! "$target" is not a valid directory, exiting...
+!!!
+EOF
+        exit 127
+    fi
+}
+
+setup_ownership() {
+    local target="$1"
+    local type="$2"
+
+    case "$type" in
+        file | directory) ;;
+        *)
+            cat <<EOF
+!!!
+!!! ERROR
+!!! "$type" is not a valid type, exiting...
+!!!
+EOF
+            exit 1
+            ;;
+    esac
+
+    target_ownership=$(stat -c %U:%G "$target")
+
+    if [ "$target_ownership" != "searxng:searxng" ]; then
+        if [ "${FORCE_OWNERSHIP:-true}" = true ] && [ "$(id -u)" -eq 0 ]; then
+            chown -R searxng:searxng "$target"
+        else
+            cat <<EOF
+!!!
+!!! WARNING
+!!! "$target" $type is not owned by "searxng:searxng"
+!!! This may cause issues when running SearXNG
+!!!
+!!! Expected "searxng:searxng"
+!!! Got "$target_ownership"
+!!!
+EOF
+        fi
+    fi
+}
+
+# Handle volume mounts
+volume_handler() {
+    local target="$1"
+
+    check_directory "$target"
+    setup_ownership "$target" "directory"
+}
+
+setup() {
+    local template_settings="/usr/local/searxng/settings.template.yml"
+    local target_settings="$__SEARXNG_CONFIG_PATH/settings.yml"
+
+    if [ ! -f "$target_settings" ]; then
+        cat <<EOF
+...
+... INFORMATION
+... "$target_settings" does not exist, creating from template...
+...
+EOF
+        cp -pfT "$template_settings" "$target_settings"
+
+        sed -i "s/ultrasecretkey/$(head -c 24 /dev/urandom | base64 | tr -dc 'a-zA-Z0-9')/g" "$target_settings"
+    fi
+
+    check_file "$target_settings"
+}
+
+cat <<EOF
+SearXNG $__SEARXNG_VERSION
+EOF
+
+# Check for volume mounts
+volume_handler "$__SEARXNG_CONFIG_PATH"
+volume_handler "$__SEARXNG_DATA_PATH"
+
+setup
+
+# root only features
+if [ "$(id -u)" -eq 0 ]; then
+    update-ca-certificates
+fi
+
+# ENVs aliases
+export GRANIAN_PORT="${SEARXNG_PORT:-$GRANIAN_PORT}"
+
+exec /usr/local/searxng/.venv/bin/granian searx.webapp:app

container/settings.template.yml

@@ -0,0 +1,8 @@
+# Read the documentation before extending the defaults:
+# https://docs.searxng.org/admin/settings/
+
+use_default_settings: true
+
+server:
+  secret_key: "ultrasecretkey"
+  image_proxy: true

dockerfiles/docker-entrypoint.sh

@@ -1,178 +0,0 @@
-#!/bin/sh
-
-help() {
-    cat <<EOF
-Command line:
-  -h  Display this help
-  -d  Dry run to update the configuration files.
-  -f  Always update on the configuration files (existing files are renamed with
-      the .old suffix).  Without this option, the new configuration files are
-      copied with the .new suffix
-Environment variables:
-  INSTANCE_NAME settings.yml : general.instance_name
-  AUTOCOMPLETE  settings.yml : search.autocomplete
-  BASE_URL      settings.yml : server.base_url
-  MORTY_URL     settings.yml : result_proxy.url
-  MORTY_KEY     settings.yml : result_proxy.key
-  BIND_ADDRESS  uwsgi bind to the specified TCP socket using HTTP protocol.
-                Default value: ${DEFAULT_BIND_ADDRESS}
-Volume:
-  /etc/searxng  the docker entry point copies settings.yml and uwsgi.ini in
-                this directory (see the -f command line option)"
-
-EOF
-}
-
-export DEFAULT_BIND_ADDRESS="0.0.0.0:8080"
-export BIND_ADDRESS="${BIND_ADDRESS:-${DEFAULT_BIND_ADDRESS}}"
-
-# Parse command line
-FORCE_CONF_UPDATE=0
-DRY_RUN=0
-
-while getopts "fdh" option
-do
-    case $option in
-
-        f) FORCE_CONF_UPDATE=1 ;;
-        d) DRY_RUN=1 ;;
-
-        h)
-            help
-            exit 0
-            ;;
-        *)
-            echo "unknow option ${option}"
-            exit 42
-            ;;
-    esac
-done
-
-get_searxng_version(){
-    su searxng -c \
-       'python3 -c "import six; import searx.version; six.print_(searx.version.VERSION_STRING)"' \
-       2>/dev/null
-}
-
-SEARXNG_VERSION="$(get_searxng_version)"
-export SEARXNG_VERSION
-echo "SearXNG version ${SEARXNG_VERSION}"
-
-# helpers to update the configuration files
-patch_uwsgi_settings() {
-    CONF="$1"
-
-    # update uwsg.ini
-    sed -i \
-        -e "s|workers = .*|workers = ${UWSGI_WORKERS:-%k}|g" \
-        -e "s|threads = .*|threads = ${UWSGI_THREADS:-4}|g" \
-        "${CONF}"
-}
-
-patch_searxng_settings() {
-    CONF="$1"
-
-    # Make sure that there is trailing slash at the end of BASE_URL
-    # see https://www.gnu.org/savannah-checkouts/gnu/bash/manual/bash.html#Shell-Parameter-Expansion
-    export BASE_URL="${BASE_URL%/}/"
-
-    # update settings.yml
-    sed -i \
-        -e "s|base_url: false|base_url: ${BASE_URL}|g" \
-        -e "s/instance_name: \"SearXNG\"/instance_name: \"${INSTANCE_NAME}\"/g" \
-        -e "s/autocomplete: \"\"/autocomplete: \"${AUTOCOMPLETE}\"/g" \
-        -e "s/ultrasecretkey/$(openssl rand -hex 32)/g" \
-        "${CONF}"
-
-    # Morty configuration
-
-    if [ -n "${MORTY_KEY}" ] && [ -n "${MORTY_URL}" ]; then
-        sed -i -e "s/image_proxy: false/image_proxy: true/g" \
-            "${CONF}"
-        cat >> "${CONF}" <<-EOF
-
-# Morty configuration
-result_proxy:
-   url: ${MORTY_URL}
-   key: !!binary "${MORTY_KEY}"
-EOF
-    fi
-}
-
-update_conf() {
-    FORCE_CONF_UPDATE=$1
-    CONF="$2"
-    NEW_CONF="${2}.new"
-    OLD_CONF="${2}.old"
-    REF_CONF="$3"
-    PATCH_REF_CONF="$4"
-
-    if [ -f "${CONF}" ]; then
-        if [ "${REF_CONF}" -nt "${CONF}" ]; then
-            # There is a new version
-            if [ "$FORCE_CONF_UPDATE" -ne 0 ]; then
-                # Replace the current configuration
-                printf '⚠️  Automatically update %s to the new version\n' "${CONF}"
-                if [ ! -f "${OLD_CONF}" ]; then
-                    printf 'The previous configuration is saved to %s\n' "${OLD_CONF}"
-                    mv "${CONF}" "${OLD_CONF}"
-                fi
-                cp "${REF_CONF}" "${CONF}"
-                $PATCH_REF_CONF "${CONF}"
-            else
-                # Keep the current configuration
-                printf '⚠️  Check new version %s to make sure SearXNG is working properly\n' "${NEW_CONF}"
-                cp "${REF_CONF}" "${NEW_CONF}"
-                $PATCH_REF_CONF "${NEW_CONF}"
-            fi
-        else
-            printf 'Use existing %s\n' "${CONF}"
-        fi
-    else
-        printf 'Create %s\n' "${CONF}"
-        cp "${REF_CONF}" "${CONF}"
-        $PATCH_REF_CONF "${CONF}"
-    fi
-}
-
-# searx compatibility: copy /etc/searx/* to /etc/searxng/*
-SEARX_CONF=0
-if [ -f "/etc/searx/settings.yml" ]; then
-    if  [ ! -f "${SEARXNG_SETTINGS_PATH}" ]; then
-        printf '⚠️  /etc/searx/settings.yml is copied to /etc/searxng\n'
-        cp "/etc/searx/settings.yml" "${SEARXNG_SETTINGS_PATH}"
-    fi
-    SEARX_CONF=1
-fi
-if [ -f "/etc/searx/uwsgi.ini" ]; then
-    printf '⚠️  /etc/searx/uwsgi.ini is ignored. Use the volume /etc/searxng\n'
-    SEARX_CONF=1
-fi
-if [ "$SEARX_CONF" -eq "1" ]; then
-    printf '⚠️  The deprecated volume /etc/searx is mounted. Please update your configuration to use /etc/searxng ⚠️\n'
-    cat << EOF > /etc/searx/deprecated_volume_read_me.txt
-This Docker image uses the volume /etc/searxng
-Update your configuration:
-* remove uwsgi.ini (or very carefully update your existing uwsgi.ini using https://github.com/searxng/searxng/blob/master/dockerfiles/uwsgi.ini )
-* mount /etc/searxng instead of /etc/searx
-EOF
-fi
-# end of searx compatibility
-
-# make sure there are uwsgi settings
-update_conf "${FORCE_CONF_UPDATE}" "${UWSGI_SETTINGS_PATH}" "/usr/local/searxng/dockerfiles/uwsgi.ini" "patch_uwsgi_settings"
-
-# make sure there are searxng settings
-update_conf "${FORCE_CONF_UPDATE}" "${SEARXNG_SETTINGS_PATH}" "/usr/local/searxng/searx/settings.yml" "patch_searxng_settings"
-
-# dry run (to update configuration files, then inspect them)
-if [ $DRY_RUN -eq 1 ]; then
-    printf 'Dry run\n'
-    exit
-fi
-
-unset MORTY_KEY
-
-# Start uwsgi
-printf 'Listen on %s\n' "${BIND_ADDRESS}"
-exec uwsgi --master --uid searxng --gid searxng --http-socket "${BIND_ADDRESS}" "${UWSGI_SETTINGS_PATH}"