Merge branch 'issue3400' into develop

Ip address and Net mask are now retreived thanks to PSutil.

.coveragerc

@@ -0,0 +1,29 @@
+[report]
+
+include =
+    *glances*
+
+omit =
+    glances/outputs/*
+    glances/exports/*
+    glances/compat.py
+    glances/autodiscover.py
+    glances/client_browser.py
+    glances/config.py
+    glances/history.py
+    glances/monitored_list.py
+    glances/outdated.py
+    glances/password*.py
+    glances/snmp.py
+    glances/static_list.py
+
+exclude_lines =
+    pragma: no cover
+    if PY3:
+    if __name__ == .__main__.:
+    if sys.platform.startswith
+    except ImportError:
+    raise NotImplementedError
+    if WINDOWS
+    if MACOS
+    if BSD

.dockerignore

@@ -0,0 +1,22 @@
+# Ignore everything
+*
+
+# Include only code files
+!/glances/**/*.py
+
+# Include WebUI files (remove when webui moved to seperate package)
+!/glances/outputs/static
+
+# Include Requirements files
+!/all-requirements.txt
+!/docker-requirements.txt
+
+# Include Config file
+!/docker-compose/glances.conf
+!/docker-files/docker-logger.json
+
+# Include Binary file
+!/docker-bin.sh
+
+# Include TOML file
+!/pyproject.toml

.gitattributes

@@ -0,0 +1 @@
+glances/outputs/static/public/* -diff linguist-vendored

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: nicolargo

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,27 @@
+Before filling this issue, please read the manual (https://glances.readthedocs.io/en/latest/) and search if the bug do not already exists in the database (https://github.com/nicolargo/glances/issues).
+
+For any questions concerning installation or use, please open a discussion (https://github.com/nicolargo/glances/discussions), not an issue.
+
+#### Description
+
+For a bug: Describe the bug and list the steps you used when the issue occurred.
+
+For an enhancement or new feature: Describe your needs.
+
+#### Versions
+
+* Glances & psutil versions: `To be completed with result of: glances -V`
+* Operating System: `To be completed with result of: lsb_release -a`
+* How do you install Glances (Pypi package, script, package manager, source): `To be completed`
+* Glances test (only available with Glances 3.1.7 or higher):
+
+ ```
+ To be completed with result of: glances --issue
+ ```
+
+#### Configuration and log file
+
+You can also [pastebin](https://pastebin.com/):
+
+* the Glances configuration file (https://glances.readthedocs.io/en/latest/config.html#location)
+* the Glances log file (https://glances.readthedocs.io/en/latest/config.html#logging)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+**Check the bug**
+Before filling this bug report, please search if a similar issue already exists.
+In this case, just add a comment on this existing issue.
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Start Glances with the following options '...'
+2. Press the key '....'
+3. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environement (please complete the following information)**
+ - Operating System (lsb_release -a or OS name/version): `To be completed with result of: lsb_release -a`
+ - Glances & psutil versions: `To be completed with result of: glances -V`
+ - How do you install Glances (Pypi package, script, package manager, source): `To be completed`
+ - Glances test: ` To be completed with result of: glances --issue`
+
+**Additional context**
+Add any other context about the problem here.
+
+You can also [pastebin](https://pastebin.com/):
+
+* the Glances configuration file (https://glances.readthedocs.io/en/latest/config.html#location)
+* the Glances log file (https://glances.readthedocs.io/en/latest/config.html#logging)

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**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 [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**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.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,11 @@
+#### Description
+
+Please describe the goal of this pull request.
+
+For any questions concerning installation or use, please open a discussion (https://github.com/nicolargo/glances/discussions), not an issue.
+
+#### Resume
+
+* Bug fix: yes/no
+* New feature: yes/no
+* Fixed tickets: comma-separated list of tickets fixed by the PR, if any

.github/workflows/build.yml

@@ -0,0 +1,82 @@
+# This pipeline aims at building Glances Pypi packages
+
+name: build
+
+on:
+  workflow_call:
+
+jobs:
+
+  build:
+    name: Build distribution 📦
+    if: github.event_name == 'push'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - name: Install pypa/build
+        run: >-
+          python3 -m
+          pip install
+          build
+          --user
+      - name: Build a binary wheel and a source tarball
+        run: python3 -m build
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  pypi:
+    name: Publish Python 🐍 distribution 📦 to PyPI
+    if: startsWith(github.ref, 'refs/tags')
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/glances
+    permissions:
+      attestations: write
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution 📦 to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+          attestations: false
+          print-hash: true
+
+  pypi_test:
+    name: Publish Python 🐍 distribution 📦 to TestPyPI
+    if: github.ref == 'refs/heads/develop'
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://pypi.org/p/glances
+    permissions:
+      attestations: write
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution 📦 to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+          attestations: false

.github/workflows/build_docker.yml

@@ -0,0 +1,105 @@
+# This pipeline aims at building Glances Docker images
+
+name: build_docker
+
+env:
+  DEFAULT_DOCKER_IMAGE: nicolargo/glances
+  PUSH_BRANCH: ${{ 'refs/heads/develop' == github.ref || startsWith(github.ref, 'refs/tags/v') }}
+  # Alpine image platform: https://hub.docker.com/_/alpine
+  # linux/arm/v6,linux/arm/v7 do not work (timeout during the build)
+  DOCKER_PLATFORMS: linux/amd64,linux/arm64/v8
+  # Ubuntu image platforms list: https://hub.docker.com/_/ubuntu
+  # linux/arm/v7 do not work (Cargo/Rust not available)
+  DOCKER_PLATFORMS_UBUNTU: linux/amd64,linux/arm64/v8
+
+on:
+  workflow_call:
+    secrets:
+      DOCKER_USERNAME:
+        description: 'Docker Hub username'
+        required: true
+      DOCKER_TOKEN:
+        description: 'Docker Hub token'
+        required: true
+
+jobs:
+
+  create_docker_images_list:
+    runs-on: ubuntu-latest
+    outputs:
+      tags: ${{ steps.config.outputs.tags }}
+    steps:
+      - name: Determine image tags
+        id: config
+        shell: bash
+        run: |
+          if [[ $GITHUB_REF == refs/tags/* ]]; then
+            VERSION=${GITHUB_REF#refs/tags/v}
+            TAG_ARRAY="[{ \"target\": \"minimal\", \"tag\": \"${VERSION}\" },"
+            TAG_ARRAY="$TAG_ARRAY { \"target\": \"minimal\", \"tag\": \"latest\" },"
+            TAG_ARRAY="$TAG_ARRAY { \"target\": \"full\", \"tag\": \"${VERSION}-full\" },"
+            TAG_ARRAY="$TAG_ARRAY { \"target\": \"full\", \"tag\": \"latest-full\" }]"
+          elif [[ $GITHUB_REF == refs/heads/develop ]]; then
+            TAG_ARRAY="[{ \"target\": \"dev\", \"tag\": \"dev\" }]"
+          else
+            TAG_ARRAY="[]"
+          fi
+
+          echo "Tags to build: $TAG_ARRAY"
+          echo "tags=$TAG_ARRAY" >> $GITHUB_OUTPUT
+
+  build_docker_images:
+    runs-on: ubuntu-latest
+    needs:
+      - create_docker_images_list
+    strategy:
+      fail-fast: false
+      matrix:
+        os: ['alpine', 'ubuntu']
+        tag: ${{ fromJson(needs.create_docker_images_list.outputs.tags) }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Retrieve Repository Docker metadata
+        id: docker_meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.DEFAULT_DOCKER_IMAGE }}
+          labels: |
+            org.opencontainers.image.url=https://nicolargo.github.io/glances/
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: all
+
+      - name: Set up Docker Buildx
+        id: buildx
+        uses: docker/setup-buildx-action@v3
+        with:
+          version: latest
+
+      - name: Login to DockerHub
+        uses: docker/login-action@v3
+        if: ${{ env.PUSH_BRANCH == 'true' }}
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_TOKEN }}
+
+      - name: Build and push image
+        uses: docker/build-push-action@v6
+        with:
+          push: ${{ env.PUSH_BRANCH == 'true' }}
+          tags: "${{ env.DEFAULT_DOCKER_IMAGE }}:${{ matrix.os != 'alpine' && format('{0}-', matrix.os) || '' }}${{ matrix.tag.tag }}"
+          build-args: |
+            CHANGING_ARG=${{ github.sha }}
+          context: .
+          file: "docker-files/${{ matrix.os }}.Dockerfile"
+          platforms: ${{ matrix.os != 'ubuntu' && env.DOCKER_PLATFORMS || env.DOCKER_PLATFORMS_UBUNTU }}
+          target: ${{ matrix.tag.target }}
+          labels: ${{ steps.docker_meta.outputs.labels }}
+          # GHA default behaviour overwrites last build cache. Causes alpine and ubuntu cache to overwrite each other.
+          # Use `scope` with the os name to prevent that
+          cache-from: 'type=gha,scope=${{ matrix.os }}'
+          cache-to: 'type=gha,mode=max,scope=${{ matrix.os }}'

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: ci
+
+on:
+    pull_request:
+      branches: [ develop ]
+    push:
+      branches: [ master, develop ]
+      tags:
+        - v*
+
+jobs:
+    quality:
+      uses: ./.github/workflows/quality.yml
+    test:
+      uses: ./.github/workflows/test.yml
+      needs: [quality]
+    build:
+      if: github.event_name != 'pull_request'
+      uses: ./.github/workflows/build.yml
+      needs: [quality, test]
+    build_docker:
+      if: github.event_name != 'pull_request'
+      uses: ./.github/workflows/build_docker.yml
+      secrets:
+        DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
+        DOCKER_TOKEN: ${{ secrets.DOCKER_TOKEN }}
+      needs: [quality, test]

.github/workflows/cyber.yml

@@ -0,0 +1,28 @@
+name: cyber
+
+on:
+    workflow_call:
+
+jobs:
+  trivy:
+    name: Trivy scan
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Run Trivy vulnerability scanner in repo mode
+        uses: aquasecurity/trivy-action@master
+        with:
+          scan-type: 'fs'
+          ignore-unfixed: true
+          format: 'sarif'
+          output: 'trivy-results.sarif'
+          severity: 'CRITICAL'
+
+      - name: Upload Trivy scan results to GitHub Security tab
+        uses: github/codeql-action/upload-sarif@v3
+        with:
+          sarif_file: 'trivy-results.sarif'

.github/workflows/inactive_issues.yml

@@ -0,0 +1,22 @@
+name: Label inactive issues
+on:
+  schedule:
+    - cron: "30 1 * * *"
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/stale@v10
+        with:
+          days-before-issue-stale: 90
+          days-before-issue-close: -1
+          stale-issue-label: "inactive"
+          stale-issue-message: "This issue is stale because it has been open for 3 months with no activity."
+          close-issue-message: "This issue was closed because it has been inactive for 30 days since being marked as stale."
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/needs_contributor.yml

@@ -0,0 +1,22 @@
+name: Add a message when needs contributor tag is used
+on:
+  issues:
+    types:
+      - labeled
+jobs:
+  add-comment:
+    if: github.event.label.name == 'needs contributor'
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - name: Add comment
+        run: gh issue comment "$NUMBER" --body "$BODY"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_REPO: ${{ github.repository }}
+          NUMBER: ${{ github.event.issue.number }}
+          BODY: >
+            This issue is available for anyone to work on.
+            **Make sure to reference this issue in your pull request.**
+            :sparkles: Thank you for your contribution ! :sparkles:

.github/workflows/quality.yml

@@ -0,0 +1,54 @@
+name: quality
+
+on:
+  workflow_call:
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript', 'python' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
+        # Learn more:
+        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v5
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3

.github/workflows/test.yml

@@ -0,0 +1,143 @@
+# Run unitary test
+
+name: test
+
+on:
+  workflow_call:
+
+jobs:
+
+  source-code-checks:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Check formatting with Ruff
+        uses: chartboost/ruff-action@v1
+        with:
+          args: 'format --check'
+
+      - name: Check linting with Ruff
+        uses: chartboost/ruff-action@v1
+        with:
+          args: 'check'
+
+      # - name: Static type check
+      #   run: |
+      #     echo "Skipping static type check for the moment, too much error...";
+      #     # pip install pyright
+      #     # pyright glances
+
+
+  test-linux:
+
+    needs: source-code-checks
+    # https://github.com/actions/runner-images?tab=readme-ov-file#available-images
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        # Python EOL version are note tested
+        # Multiple Python version only tested for Linux
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+
+      - uses: actions/checkout@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          if [ -f dev-requirements.txt ]; then python -m pip install -r dev-requirements.txt; fi
+          if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; fi
+
+      - name: Unitary tests
+        run: |
+          python -m pytest ./tests/test_core.py
+
+  test-windows:
+
+    needs: source-code-checks
+    # https://github.com/actions/runner-images?tab=readme-ov-file#available-images
+    runs-on: windows-2025
+    strategy:
+      matrix:
+        # Windows-curses not available for Python 3.14 for the moment
+        # See https://github.com/zephyrproject-rtos/windows-curses/issues/76
+        python-version: ["3.13"]
+    steps:
+
+    - uses: actions/checkout@v5
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+        cache: 'pip'
+
+    - name: Install dependencies
+      run: |
+        if (Test-Path -PathType Leaf "dev-requirements.txt") { python -m pip install -r dev-requirements.txt }
+        if (Test-Path -PathType Leaf "requirements.txt") { python -m pip install -r requirements.txt }
+        pip install .
+
+    - name: Unitary tests
+      run: |
+        python -m pytest ./tests/test_core.py
+
+  test-macos:
+
+    needs: source-code-checks
+    # https://github.com/actions/runner-images?tab=readme-ov-file#available-images
+    runs-on: macos-15
+    strategy:
+      matrix:
+        # Only test the latest stable version
+        python-version: ["3.14"]
+
+    steps:
+
+      - uses: actions/checkout@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          if [ -f dev-requirements.txt ]; then python -m pip install -r dev-requirements.txt; fi
+          if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; fi
+
+      - name: Unitary tests
+        run: |
+          python -m pytest ./tests/test_core.py
+
+  # Error when trying to implement #2749
+  # pkg: No packages available to install matching 'py-pip' have been found in the repositories
+  # test-freebsd:
+
+  #   runs-on: ubuntu-22.04
+
+  #   steps:
+
+  #     - uses: actions/checkout@v4
+
+  #     - name: Run tests
+  #       uses: vmactions/freebsd-vm@v1
+  #       with:
+  #         usesh: true
+  #         prepare: |
+  #           pkg install -y python3
+  #         run: |
+  #           set -e -x
+  #           python3 -m pip install pytest
+  #           python3 -m pip install --user -r dev-requirements.txt
+  #           python3 -m pip install --user -r requirements.txt
+  #           python3 -m pytest ./tests/test_core.py

.github/workflows/webui.yml

@@ -0,0 +1,40 @@
+name: webui
+
+on:
+  workflow_call:
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x]
+        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+
+    steps:
+    - uses: actions/checkout@v5
+    - name: Glances will be build with Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v5
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+        cache-dependency-path: ./glances/outputs/static/package-lock.json
+    - name: Build Glances WebUI
+      working-directory: ./glances/outputs/static
+      # TODO: add the following line when https://github.com/nicolargo/glances/issues/2914 will be solved
+      #  npm audit fix
+      run: |
+        npm ci
+        npm run build
+    - name: Commit and push WebUI
+      env:
+        CI_COMMIT_MESSAGE: Continuous Integration Build Artifacts
+        CI_COMMIT_AUTHOR: Continuous Integration
+      run: |
+        git config --global user.name "${{ env.CI_COMMIT_AUTHOR }}"
+        git config --global user.email "username@users.noreply.github.com"
+        git add glances/outputs/static
+        /bin/bash -c "git commit -m '${{ env.CI_COMMIT_MESSAGE }}' || true"
+        git push

.gitignore

@@ -7,7 +7,8 @@
 dist
 build
 
-# Eclipse
+# Eclipse and other IDE
+.idea
 *.pydevproject
 .project
 .metadata
@@ -22,9 +23,11 @@ local.properties
 .classpath
 .settings/
 .loadpath
+.ipynb_checkpoints/
 
 # External tool builders
 .externalToolBuilders/
+*yarn.lock
 
 # Locally stored "Eclipse launch configurations"
 *.launch
@@ -43,3 +46,32 @@ _build
 
 # Tox
 .tox/
+
+# web ui
+node_modules/
+bower_components/
+
+# visual stdio code
+.vscode/
+
+# Snap packaging specific
+/snap/.snapcraft/
+/parts/
+/stage/
+/prime/
+
+/*.snap
+/*_source.tar.bz2
+
+# Virtual env
+.venv-uv/
+.venv/
+uv.lock
+.python-version
+
+# Test
+.coverage
+tests-data/issues/*/config/
+
+# Local SSL certificates
+glances.local*.pem

.mailmap

@@ -0,0 +1,13 @@
+Nicolas Hennion <nicolashennion@gmail.com> Nicolargo <nicolas@nicolargo.com>
+Nicolas Hennion <nicolashennion@gmail.com> Nicolas Hennion <nicolas@nicolargo.com>
+Nicolas Hennion <nicolashennion@gmail.com> nicolargo <nicolas@nicolargo.com>
+Nicolas Hennion <nicolashennion@gmail.com> nicolargo <nicolashennion@gmail.com>
+Nicolas Hennion <nicolashennion@gmail.com> nicolargo <nicolargo@nicolargo-boulot.(none)>
+Nicolas Hennion <nicolashennion@gmail.com> nicolargo <nicolargo@nicolargo-fujitsu.(none)>
+Nicolas Hennion <nicolashennion@gmail.com> Nicolargo <nicolashennion@gmail.com>
+Nicolas Hennion <nicolashennion@gmail.com> nicolargo <nicolargo@lifebook.(none)>
+Alessio Sergi <al3hex@gmail.com> asergi <al3hex@gmail.com>
+Nicolas Hart <contact@nclshart.net> nclsHart <contact@nclshart.net>
+Nicolas Hart <contact@nclshart.net> Nicolas Hart <n.hart@hexanet.fr>
+Floran Brutel <f.brutel@hexanet.fr> Floran Brutel <contact@floran.fr>
+Brandon Philips <brandon@ifup.org> Brandon Philips <brandon.philips@rackspace.com>

.pre-commit-config.yaml

@@ -0,0 +1,107 @@
+repos:
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.24.2
+    hooks:
+      - id: gitleaks
+        name: "🔒 security · Detect hardcoded secrets"
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.10
+    hooks:
+    - id: ruff-format
+      name: "🐍 python · Formatter with Ruff"
+      types_or: [ python, pyi ]
+      args: [ --config, './pyproject.toml' ]
+    - id: ruff-check
+      name: "🐍 python · Linter with Ruff"
+      types_or: [ python, pyi ]
+      args: [ --fix, --exit-non-zero-on-fix, --config, './pyproject.toml' ]
+
+  # - repo: https://github.com/RobertCraigie/pyright-python
+  #   rev: v1.1.391
+  #   hooks:
+  #     - id: pyright
+  #       name: "🐍 python · Check types"
+
+  # - repo: https://github.com/biomejs/pre-commit
+  #   rev: "v2.3.7"
+  #   hooks:
+  #     - id: biome-check
+  #       name: "🟨 javascript · Lint, format, and safe fixes with Biome"
+
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.35.0
+    hooks:
+      - id: check-github-workflows
+        name: "🐙 github-actions · Validate gh workflow files"
+        args: ["--verbose"]
+
+  - repo: https://github.com/shellcheck-py/shellcheck-py
+    rev: v0.11.0.1
+    hooks:
+      - id: shellcheck
+        name: "🐚 shell · Lint shell scripts"
+
+  - repo: https://github.com/openstack/bashate
+    rev: 2.1.1
+    hooks:
+      - id: bashate
+        name: "🐚 shell · Check shell script code style"
+        entry: bashate --error . --ignore=E006
+
+  # - repo: https://github.com/mrtazz/checkmake.git
+  #   rev: 0.2.2
+  #   hooks:
+  #     - id: checkmake
+  #       name: "🐮 Makefile · Lint Makefile"
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-executables-have-shebangs
+        name: "📁 filesystem/⚙️ exec · Verify shebang presence"
+      - id: check-shebang-scripts-are-executable
+        name: "📁 filesystem/⚙️ exec · Verify script permissions"
+      - id: check-case-conflict
+        name: "📁 filesystem/📝 names · Check case sensitivity"
+      - id: destroyed-symlinks
+        name: "📁 filesystem/🔗 symlink · Detect broken symlinks"
+      - id: check-merge-conflict
+        name: "🌳 git · Detect conflict markers"
+      - id: forbid-new-submodules
+        name: "🌳 git · Prevent submodule creation"
+      - id: no-commit-to-branch
+        name: "🌳 git · Protect main branches"
+        args: ["--branch", "main", "--branch", "master"]
+      - id: check-added-large-files
+        name: "🌳 git · Block large file commits"
+        args: ['--maxkb=5000']
+      - id: check-ast
+        name: "🐍 python/🔍 quality · Validate Python AST"
+      - id: check-docstring-first
+        name: "🐍 python/📝 style · Enforce docstring at top"
+      - id: check-json
+        name: "📄 formats/json · Validate JSON files"
+      - id: check-shebang-scripts-are-executable
+        name: "📁 filesystem/⚙️ exec · Ensure scripts are executable"
+      - id: check-toml
+        name: "📄 formats/toml · Validate TOML files"
+      - id: check-yaml
+        name: "📄 formats/yaml · Validate YAML syntax"
+      - id: debug-statements
+        name: "🐍 python/🪲 debug · Detect debug statements"
+      - id: detect-private-key
+        name: "🔐 security · Detect private keys"
+      - id: mixed-line-ending
+        name: "📄 text/↩️ newline · Normalize line endings"
+      - id: requirements-txt-fixer
+        name: "🐍 python/📦 deps · Sort requirements.txt"
+
+  - repo: local
+    hooks:
+      - id: find-duplicate-lines
+        name: "❗️local script · Find duplicate lines at the end of file"
+        entry: bash tests-data/tools/find-duplicate-lines.sh
+        language: system
+        types: [python]
+        pass_filenames: false

.readthedocs.yaml

@@ -0,0 +1,34 @@
+# Read the Docs configuration file for Glances projects
+
+# Required
+version: 2
+
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+    # You can also specify other tool versions:
+    # nodejs: "20"
+    # rust: "1.70"
+    # golang: "1.20"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+  # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
+  # builder: "dirhtml"
+  # Fail on all warnings to avoid broken references
+  # fail_on_warning: true
+
+# Optionally build your docs in additional formats such as PDF and ePub
+# formats:
+#   - pdf
+#   - epub
+
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+    - requirements: dev-requirements.txt

.reuse/dep5

@@ -0,0 +1,10 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: Glances
+Upstream-Contact: Nicolas Hennion <nicolashennion@gmail.com>
+Source: https://github.com/nicolargo/glances
+
+# Sample paragraph, commented out:
+#
+# Files: src/*
+# Copyright: $YEAR $NAME <$CONTACT>
+# License: ...

.travis.yml

@@ -1,15 +0,0 @@
-language: python
-python:
-  - "2.7"
-  - "3.3"
-  - "3.4"
-  - "3.5"
-  - "pypy"
-install:
-  - pip install -r requirements.txt
-  - pip install coveralls
-script:
-  - python setup.py install
-  - coverage run --source=glances unitest.py
-after_success:
-  - coveralls

AUTHORS

@@ -7,13 +7,25 @@ http://blog.nicolargo.com
 https://twitter.com/nicolargo
 https://github.com/nicolargo
 nicolashennion@gmail.com
-PGP Fingerprint: 835F C447 3BCD 60E9 9200  2778 ABA4 D1AB 9731 6A3C
-PGP Public key:  gpg --keyserver pgp.mit.edu --recv-keys 0xaba4d1ab97316a3c
+PGP Fingerprint: A0D9 628F 5A83 A879 48EA  B1FE BA43 C11F 2C8B 4347
+PGP Public key:  gpg --keyserver pgp.mit.edu --recv-keys 0xba43c11f2c8b4347
 
-Alessio Sergi (aka) Al3hex
+RazCrimson (maintainer of the Glances project)
+https://github.com/RazCrimson
+
+Ariel Otibili (aka) ariel-anieli (for the huge work on code quality)
+https://github.com/ariel-anieli
+
+Alessio Sergi (aka) Al3hex (thanks you for the great job on this project)
 https://twitter.com/al3hex
 https://github.com/asergi
 
+Floran Brutel (aka) notFloran (maintainer of the Web User Interface)
+https://github.com/notFloran
+
+fr4nc0is (maintainer of the Web User Interface)
+https://github.com/fr4nc0is
+
 Brandon Philips (aka) Philips
 http://ifup.org/
 https://github.com/philips
@@ -30,17 +42,21 @@ https://github.com/nclsHart
 Sylvain Mouquet (aka) SylvainMouquet (for the Web user interface)
 http://github.com/sylvainmouquet
 
-Floran Brutel (aka) notFloran (for the Web user interface)
-https://github.com/notFloran
+Erik Eriksson (aka) Molobrakos (for the MQTT plugin and various PR)
+https://www.linkedin.com/in/error-errorsson/
 
 =========
 Packagers
 =========
 
+林博仁(Buo-ren Lin) Lin-Buo-Ren for the Snap package
+https://lin-buo-ren.github.io/
+https://snapcraft.io/glances/releases
+
 Daniel Echeverry and Sebastien Badia for the Debian package
 https://tracker.debian.org/pkg/glances
 
-Philip Lacroix for the Slackware (SlackBuild) package
+Philip Lacroix and Nicolas Kovacs for the Slackware (SlackBuild) package
 
 gasol.wu@gmail.com for the FreeBSD port
 
@@ -51,3 +67,7 @@ http://www.macports.org/ports.php?by=name&substr=glances
 
 John Kirkham for the conda package (at conda-forge)
 https://github.com/conda-forge/glances-feedstock
+
+Rui Chen for the Homebrew package
+https://chenrui.dev/
+https://formulae.brew.sh/formula/glances

CODE-OF-CONDUCT.md

@@ -0,0 +1,73 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+education, socioeconomic status, nationality, personal appearance, race,
+religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+  advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at nicolashennion@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org

CONTRIBUTING.md

@@ -10,7 +10,6 @@ the developers managing and developing this open source project. In return,
 they should reciprocate that respect in addressing your issue or assessing
 patches and features.
 
-
 ## Using the issue tracker
 
 The [issue tracker](https://github.com/nicolargo/glances/issues) is
@@ -18,12 +17,12 @@ the preferred channel for [bug reports](#bug-reports), [features requests](#feat
 and [submitting pull requests](#pull-requests), but please respect the following
 restrictions:
 
-* Please **do not** use the issue tracker for personal support requests. A official Q&A exist. [Use it](https://groups.google.com/forum/?hl=en#!forum/glances-users)! 
+* Please **do not** use the issue tracker for personal support requests. An
+  official Q&A exist. [Use it](https://groups.google.com/forum/?hl=en#!forum/glances-users)!
 
 * Please **do not** derail or troll issues. Keep the discussion on topic and
   respect the opinions of others.
 
-
 ## Bug reports
 
 A bug is a _demonstrable problem_ that is caused by the code in the repository.
@@ -44,9 +43,9 @@ Guidelines for bug reports:
 
 Example:
 
-> Short and descriptive example bug report title
+> Short and descriptive example bug report title.
 >
-> Glances and PsUtil version used (glances -V)
+> Glances and psutil version used (glances -V).
 >
 > Operating system description (name and version).
 >
@@ -57,22 +56,24 @@ Example:
 > 2. This is the second step
 > 3. Further steps, etc.
 >
-> Screenshot (if usefull)
+> Screenshot (if useful)
 >
 > Any other information you want to share that is relevant to the issue being
 > reported. This might include the lines of code that you have identified as
 > causing the bug, and potential solutions (and your opinions on their
 > merits).
-
+>
+> You can also run Glances in debug mode (-d) and paste/bin the glances.conf file (<https://glances.readthedocs.io/en/latest/config.html>).
+>
+> Glances 3.2.0 or higher have also a --issue option to run a simple test. Please use it and copy/paste the output.
 
 ## Feature requests
 
 Feature requests are welcome. But take a moment to find out whether your idea
-fits with the scope and aims of the project. It's up to *you* to make a strong
+fits with the scope and aims of the project. It's up to _you* to make a strong
 case to convince the project's developers of the merits of this feature. Please
 provide as much detail and context as possible.
 
-
 ## Pull requests
 
 Good pull requests—patches, improvements, new features—are a fantastic
@@ -86,12 +87,13 @@ project's developers might not want to merge into the project.
 
 First of all, all pull request should be done on the `develop` branch.
 
-Glances uses PEP8 compatible code, so use a PEP validator before submitting 
-your pull request. Also uses the unitaries tests scripts (unitest.py).
+Glances uses PEP8 compatible code, so use a PEP validator before submitting
+your pull request. Also uses the unitaries tests scripts (unitest-all.py).
 
 Similarly, when contributing to Glances's documentation, you should edit the
 documentation source files in
-[the `/doc/` and `/man/` directories of the `develop` branch](https://github.com/nicolargo/glances/tree/develop/docs).
+[the `/doc/` and `/man/` directories of the `develop` branch](https://github.com/nicolargo/glances/tree/develop/docs) and generate
+the documentation outputs files by reading the [README](https://github.com/nicolargo/glances/tree/develop/docs/README.txt) file.
 
 Adhering to the following process is the best way to get your work
 included in the project:
@@ -124,27 +126,37 @@ included in the project:
 
 4. It's coding time !
    Please respect the following coding convention: [Elements of Python Style](https://github.com/amontalenti/elements-of-python-style)
-   Commit your changes in logical chunks. Please adhere to these [git commit
+
+5. Test you code using the Makefile:
+
+   * make format ==> Format your code thanks to the Ruff linter
+   * make run ==> Run Glances
+   * make run-webserver ==> Run a Glances Web Server
+   * make test ==> Run unit tests
+   * make docs ==> Update docs
+   * make webui ==> Compile a new Web UI
+
+6. Commit your changes in logical chunks. Please adhere to these [git commit
    message guidelines](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)
    or your code is unlikely be merged into the main project. Use Git's
    [interactive rebase](https://help.github.com/articles/interactive-rebase)
    feature to tidy up your commits before making them public.
 
-5. Locally merge (or rebase) the upstream development branch into your topic branch:
+7. Locally merge (or rebase) the upstream development branch into your topic branch:
 
    ```bash
    git pull [--rebase] upstream develop
    ```
 
-6. Push your topic branch up to your fork:
+8. Push your topic branch up to your fork:
 
    ```bash
    git push origin <topic-branch-name>
    ```
 
-7. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
+9. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
     with a clear title and description against the `develop` branch.
 
 **IMPORTANT**: By submitting a patch, you agree to allow the project owners to
-license your work under the terms of the [LGPL](LICENSE) (if it
+license your work under the terms of the [LGPLv3](COPYING) (if it
 includes code changes).

COPYING

@@ -1,166 +1,304 @@
-                   GNU LESSER GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
+GNU LESSER GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
 
- Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
+Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
 
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
 
-  This version of the GNU Lesser General Public License incorporates
-the terms and conditions of version 3 of the GNU General Public
-License, supplemented by the additional permissions listed below.
+This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below.
 
-  0. Additional Definitions.
+0. Additional Definitions.
 
-  As used herein, "this License" refers to version 3 of the GNU Lesser
-General Public License, and the "GNU GPL" refers to version 3 of the GNU
-General Public License.
+As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License.
 
-  "The Library" refers to a covered work governed by this License,
-other than an Application or a Combined Work as defined below.
+"The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below.
 
-  An "Application" is any work that makes use of an interface provided
-by the Library, but which is not otherwise based on the Library.
-Defining a subclass of a class defined by the Library is deemed a mode
-of using an interface provided by the Library.
+An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library.
 
-  A "Combined Work" is a work produced by combining or linking an
-Application with the Library.  The particular version of the Library
-with which the Combined Work was made is also called the "Linked
-Version".
+A "Combined Work" is a work produced by combining or linking an Application with the Library.  The particular version of the Library with which the Combined Work was made is also called the "Linked Version".
 
-  The "Minimal Corresponding Source" for a Combined Work means the
-Corresponding Source for the Combined Work, excluding any source code
-for portions of the Combined Work that, considered in isolation, are
-based on the Application, and not on the Linked Version.
+The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version.
 
-  The "Corresponding Application Code" for a Combined Work means the
-object code and/or source code for the Application, including any data
-and utility programs needed for reproducing the Combined Work from the
-Application, but excluding the System Libraries of the Combined Work.
+The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work.
 
-  1. Exception to Section 3 of the GNU GPL.
+1. Exception to Section 3 of the GNU GPL.
+You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL.
 
-  You may convey a covered work under sections 3 and 4 of this License
-without being bound by section 3 of the GNU GPL.
+2. Conveying Modified Versions.
+If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version:
 
-  2. Conveying Modified Versions.
+     a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or
 
-  If you modify a copy of the Library, and, in your modifications, a
-facility refers to a function or data to be supplied by an Application
-that uses the facility (other than as an argument passed when the
-facility is invoked), then you may convey a copy of the modified
-version:
+     b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy.
 
-   a) under this License, provided that you make a good faith effort to
-   ensure that, in the event an Application does not supply the
-   function or data, the facility still operates, and performs
-   whatever part of its purpose remains meaningful, or
+3. Object Code Incorporating Material from Library Header Files.
+The object code form of an Application may incorporate material from a header file that is part of the Library.  You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following:
 
-   b) under the GNU GPL, with none of the additional permissions of
-   this License applicable to that copy.
+     a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License.
 
-  3. Object Code Incorporating Material from Library Header Files.
+     b) Accompany the object code with a copy of the GNU GPL and this license document.
 
-  The object code form of an Application may incorporate material from
-a header file that is part of the Library.  You may convey such object
-code under terms of your choice, provided that, if the incorporated
-material is not limited to numerical parameters, data structure
-layouts and accessors, or small macros, inline functions and templates
-(ten or fewer lines in length), you do both of the following:
+4. Combined Works.
+You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following:
 
-   a) Give prominent notice with each copy of the object code that the
-   Library is used in it and that the Library and its use are
-   covered by this License.
+     a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License.
 
-   b) Accompany the object code with a copy of the GNU GPL and this license
-   document.
+     b) Accompany the Combined Work with a copy of the GNU GPL and this license document.
 
-  4. Combined Works.
+     c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document.
 
-  You may convey a Combined Work under terms of your choice that,
-taken together, effectively do not restrict modification of the
-portions of the Library contained in the Combined Work and reverse
-engineering for debugging such modifications, if you also do each of
-the following:
+     d) Do one of the following:
 
-   a) Give prominent notice with each copy of the Combined Work that
-   the Library is used in it and that the Library and its use are
-   covered by this License.
+           0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.
 
-   b) Accompany the Combined Work with a copy of the GNU GPL and this license
-   document.
+          1) Use a suitable shared library mechanism for linking with the Library.  A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version.
 
-   c) For a Combined Work that displays copyright notices during
-   execution, include the copyright notice for the Library among
-   these notices, as well as a reference directing the user to the
-   copies of the GNU GPL and this license document.
+     e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.)
 
-   d) Do one of the following:
+5. Combined Libraries.
+You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following:
 
-       0) Convey the Minimal Corresponding Source under the terms of this
-       License, and the Corresponding Application Code in a form
-       suitable for, and under terms that permit, the user to
-       recombine or relink the Application with a modified version of
-       the Linked Version to produce a modified Combined Work, in the
-       manner specified by section 6 of the GNU GPL for conveying
-       Corresponding Source.
+     a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License.
 
-       1) Use a suitable shared library mechanism for linking with the
-       Library.  A suitable mechanism is one that (a) uses at run time
-       a copy of the Library already present on the user's computer
-       system, and (b) will operate properly with a modified version
-       of the Library that is interface-compatible with the Linked
-       Version.
+     b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work.
 
-   e) Provide Installation Information, but only if you would otherwise
-   be required to provide such information under section 6 of the
-   GNU GPL, and only to the extent that such information is
-   necessary to install and execute a modified version of the
-   Combined Work produced by recombining or relinking the
-   Application with a modified version of the Linked Version. (If
-   you use option 4d0, the Installation Information must accompany
-   the Minimal Corresponding Source and Corresponding Application
-   Code. If you use option 4d1, you must provide the Installation
-   Information in the manner specified by section 6 of the GNU GPL
-   for conveying Corresponding Source.)
+6. Revised Versions of the GNU Lesser General Public License.
+The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
 
-  5. Combined Libraries.
+Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation.
 
-  You may place library facilities that are a work based on the
-Library side by side in a single library together with other library
-facilities that are not Applications and are not covered by this
-License, and convey such a combined library under terms of your
-choice, if you do both of the following:
+If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library.
 
-   a) Accompany the combined library with a copy of the same work based
-   on the Library, uncombined with any other library facilities,
-   conveyed under the terms of this License.
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
 
-   b) Give prominent notice with the combined library that part of it
-   is a work based on the Library, and explaining where to find the
-   accompanying uncombined form of the same work.
+Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>
 
-  6. Revised Versions of the GNU Lesser General Public License.
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
 
-  The Free Software Foundation may publish revised and/or new versions
-of the GNU Lesser General Public License from time to time. Such new
-versions will be similar in spirit to the present version, but may
-differ in detail to address new problems or concerns.
+Preamble
 
-  Each version is given a distinguishing version number. If the
-Library as you received it specifies that a certain numbered version
-of the GNU Lesser General Public License "or any later version"
-applies to it, you have the option of following the terms and
-conditions either of that published version or of any later version
-published by the Free Software Foundation. If the Library as you
-received it does not specify a version number of the GNU Lesser
-General Public License, you may choose any version of the GNU Lesser
-General Public License ever published by the Free Software Foundation.
+The GNU General Public License is a free, copyleft license for software and other kinds of works.
 
-  If the Library as you received it specifies that a proxy can decide
-whether future versions of the GNU Lesser General Public License shall
-apply, that proxy's public statement of acceptance of any version is
-permanent authorization for you to choose that version for the
-Library.
+The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.
 
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.
+
+To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.
+
+For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.
+
+Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.
+
+Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.
+
+The precise terms and conditions for copying, distribution and modification follow.
+
+TERMS AND CONDITIONS
+
+0. Definitions.
+
+“This License” refers to version 3 of the GNU General Public License.
+
+“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.
+
+“The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.
+
+To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.
+
+A “covered work” means either the unmodified Program or a work based on the Program.
+
+To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.
+
+To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.
+
+An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.
+
+1. Source Code.
+The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work.
+
+A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.
+
+The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.
+
+The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same work.
+
+2. Basic Permissions.
+All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
+
+3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.
+
+When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.
+
+4. Conveying Verbatim Copies.
+You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.
+
+5. Conveying Modified Source Versions.
+You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:
+
+     a) The work must carry prominent notices stating that you modified it, and giving a relevant date.
+
+     b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”.
+
+     c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.
+
+     d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.
+
+A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.
+
+6. Conveying Non-Source Forms.
+You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:
+
+     a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.
+
+     b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.
+
+     c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.
+
+     d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.
+
+     e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.
+
+A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.
+
+“Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).
+
+The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.
+
+Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.
+
+7. Additional Terms.
+“Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:
+
+     a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or
+
+     b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or
+
+     c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or
+
+     d) Limiting the use for publicity purposes of names of licensors or authors of the material; or
+
+     e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or
+
+     f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.
+
+All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.
+
+8. Termination.
+You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).
+
+However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.
+
+Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.
+
+9. Acceptance Not Required for Having Copies.
+You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.
+
+10. Automatic Licensing of Downstream Recipients.
+Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.
+
+An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.
+
+11. Patents.
+A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”.
+
+A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.
+
+In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.
+
+A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.
+
+12. No Surrender of Others' Freedom.
+If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.
+
+13. Use with the GNU Affero General Public License.
+Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.
+
+14. Revised Versions of this License.
+The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.
+
+Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.
+
+15. Disclaimer of Warranty.
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+16. Limitation of Liability.
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+17. Interpretation of Sections 15 and 16.
+If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found.
+
+     <one line to give the program's name and a brief idea of what it does.>
+     Copyright (C) <year>  <name of author>
+
+     This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+     This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+
+     You should have received a copy of the GNU General Public License along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode:
+
+     <program>  Copyright (C) <year>  <name of author>
+     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+     This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”.
+
+You should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see <http://www.gnu.org/licenses/>.
+
+The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read <http://www.gnu.org/philosophy/why-not-lgpl.html>.

Dockerfile

@@ -1,24 +0,0 @@
-#
-# Glances Dockerfile
-#
-# https://github.com/nicolargo/glances
-#
-
-# Pull base image.
-FROM ubuntu
-
-# Install Glances (develop branch)
-RUN apt-get -y install curl && \
-    curl -L https://raw.githubusercontent.com/nicolargo/glancesautoinstall/master/install-develop.sh | /bin/bash
-
-# Define working directory.
-WORKDIR /glances
-
-# EXPOSE PORT (For XMLRPC)
-EXPOSE 61209
-
-# EXPOSE PORT (For Web UI)
-EXPOSE 61208
-
-# Define default command.
-CMD python -m glances $GLANCES_OPT

LICENSES/LGPL-3.0-only.txt

@@ -0,0 +1,304 @@
+GNU LESSER GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below.
+
+0. Additional Definitions.
+
+As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License.
+
+"The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below.
+
+An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library.
+
+A "Combined Work" is a work produced by combining or linking an Application with the Library.  The particular version of the Library with which the Combined Work was made is also called the "Linked Version".
+
+The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version.
+
+The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work.
+
+1. Exception to Section 3 of the GNU GPL.
+You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL.
+
+2. Conveying Modified Versions.
+If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version:
+
+     a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or
+
+     b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy.
+
+3. Object Code Incorporating Material from Library Header Files.
+The object code form of an Application may incorporate material from a header file that is part of the Library.  You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following:
+
+     a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License.
+
+     b) Accompany the object code with a copy of the GNU GPL and this license document.
+
+4. Combined Works.
+You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following:
+
+     a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License.
+
+     b) Accompany the Combined Work with a copy of the GNU GPL and this license document.
+
+     c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document.
+
+     d) Do one of the following:
+
+           0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.
+
+          1) Use a suitable shared library mechanism for linking with the Library.  A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version.
+
+     e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.)
+
+5. Combined Libraries.
+You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following:
+
+     a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License.
+
+     b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work.
+
+6. Revised Versions of the GNU Lesser General Public License.
+The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation.
+
+If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library.
+
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+Preamble
+
+The GNU General Public License is a free, copyleft license for software and other kinds of works.
+
+The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.
+
+To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.
+
+For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.
+
+Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.
+
+Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.
+
+The precise terms and conditions for copying, distribution and modification follow.
+
+TERMS AND CONDITIONS
+
+0. Definitions.
+
+“This License” refers to version 3 of the GNU General Public License.
+
+“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.
+
+“The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.
+
+To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.
+
+A “covered work” means either the unmodified Program or a work based on the Program.
+
+To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.
+
+To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.
+
+An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.
+
+1. Source Code.
+The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work.
+
+A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.
+
+The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.
+
+The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same work.
+
+2. Basic Permissions.
+All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.
+
+You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.
+
+Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
+
+3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.
+
+When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.
+
+4. Conveying Verbatim Copies.
+You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.
+
+5. Conveying Modified Source Versions.
+You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:
+
+     a) The work must carry prominent notices stating that you modified it, and giving a relevant date.
+
+     b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”.
+
+     c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.
+
+     d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.
+
+A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.
+
+6. Conveying Non-Source Forms.
+You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:
+
+     a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.
+
+     b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.
+
+     c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.
+
+     d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.
+
+     e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.
+
+A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.
+
+“Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).
+
+The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.
+
+Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.
+
+7. Additional Terms.
+“Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:
+
+     a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or
+
+     b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or
+
+     c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or
+
+     d) Limiting the use for publicity purposes of names of licensors or authors of the material; or
+
+     e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or
+
+     f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.
+
+All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.
+
+Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.
+
+8. Termination.
+You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).
+
+However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.
+
+Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.
+
+9. Acceptance Not Required for Having Copies.
+You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.
+
+10. Automatic Licensing of Downstream Recipients.
+Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.
+
+An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.
+
+You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.
+
+11. Patents.
+A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”.
+
+A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.
+
+In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.
+
+If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.
+
+A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.
+
+Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.
+
+12. No Surrender of Others' Freedom.
+If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.
+
+13. Use with the GNU Affero General Public License.
+Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.
+
+14. Revised Versions of this License.
+The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.
+
+Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.
+
+15. Disclaimer of Warranty.
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+16. Limitation of Liability.
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+17. Interpretation of Sections 15 and 16.
+If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found.
+
+     <one line to give the program's name and a brief idea of what it does.>
+     Copyright (C) <year>  <name of author>
+
+     This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+     This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
+
+     You should have received a copy of the GNU General Public License along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode:
+
+     <program>  Copyright (C) <year>  <name of author>
+     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+     This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”.
+
+You should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see <http://www.gnu.org/licenses/>.
+
+The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read <http://www.gnu.org/philosophy/why-not-lgpl.html>.

MANIFEST.in

@@ -1,8 +1,14 @@
 include AUTHORS
+include CONTRIBUTING.md
 include COPYING
-include NEWS
+include NEWS.rst
 include README.rst
+include README-pypi.rst
+include SECURITY.md
 include conf/glances.conf
+include conf/fetch-templates/*.jinja
+include requirements.txt
+include all-requirements.txt
 recursive-include docs *
 recursive-include glances *.py
 recursive-include glances/outputs/static *

Makefile

@@ -0,0 +1,387 @@
+PORT     	  ?= 8008
+CONF     	  := conf/glances.conf
+LASTTAG  	   = $(shell git describe --tags --abbrev=0)
+
+IMAGES_TYPES      := full minimal
+DISTROS           := alpine ubuntu
+alpine_images     := $(IMAGES_TYPES:%=docker-alpine-%)
+ubuntu_images     := $(IMAGES_TYPES:%=docker-ubuntu-%)
+DOCKER_IMAGES     := $(alpine_images) $(ubuntu_images)
+DOCKER_RUNTIMES   := $(DOCKER_IMAGES:%=run-%)
+UNIT_TESTS        := test-core test-restful test-xmlrpc
+DOCKER_BUILD      := docker buildx build
+DOCKER_RUN        := docker run
+PODMAN_SOCK       ?= /run/user/$(shell id -u)/podman/podman.sock
+DOCKER_SOCK       ?= /var/run/docker.sock
+DOCKER_SOCKS      := -v $(PODMAN_SOCK):$(PODMAN_SOCK):ro -v $(DOCKER_SOCK):$(DOCKER_SOCK):ro
+DOCKER_OPTS       := --rm -e TZ="${TZ}" -e GLANCES_OPT="" --pid host --network host
+UV_RUN		   	  := .venv-uv/bin/uv
+
+# if the command is only `make`, the default tasks will be the printing of the help.
+.DEFAULT_GOAL := help
+
+.PHONY: help test docs docs-server venv requirements profiling docker all clean all test
+
+help: ## List all make commands available
+	@grep -E '^[\.a-zA-Z_%-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
+	awk -F ":" '{print $1}' | \
+	grep -v % | sed 's/\\//g' | sort | \
+	awk 'BEGIN {FS = ":[^:]*?##"}; {printf "\033[1;34mmake %-50s\033[0m %s\n", $$1, $$2}'
+
+# ===================================================================
+# Virtualenv
+# ===================================================================
+
+# install-uv: ## Instructions to install the UV tool
+# 	@echo "Install the UV tool (https://astral.sh/uv/)"
+# 	@echo "Please install the UV tool manually"
+# 	@echo "For example with: curl -LsSf https://astral.sh/uv/install.sh | sh"
+# 	@echo "Or via a package manager of your distribution"
+# 	@echo "For example for Snap: snap install astral-uv"
+
+install-uv: ## Install UV tool in a specific virtualenv
+	python3 -m venv .venv-uv
+	.venv-uv/bin/pip install uv
+
+upgrade-uv: ## Upgrade the UV tool
+	.venv-uv/bin/pip install --upgrade pip
+	.venv-uv/bin/pip install --upgrade uv
+
+venv: ## Create the virtualenv with all dependencies
+	$(UV_RUN) sync --all-extras --no-group dev
+
+venv-upgrade venv-switch-to-full: ## Upgrade the virtualenv with all dependencies
+	$(UV_RUN) sync --upgrade --all-extras
+
+venv-min: ## Create the virtualenv with minimal dependencies
+	$(UV_RUN) sync
+
+venv-upgrade-min venv-switch-to-min: ## Upgrade the virtualenv with minimal dependencies
+	$(UV_RUN) sync --upgrade
+
+venv-clean: ## Remove the virtualenv
+	rm -rf .venv
+
+venv-dev: ## Create the virtualenv with dev dependencies
+	$(UV_RUN) sync --dev --all-extras
+	$(UV_RUN) run pre-commit install --hook-type pre-commit
+
+# ===================================================================
+# Requirements
+#
+# Note: the --no-hashes option should be used because pip (in CI) has
+# issues with hashes.
+# ===================================================================
+
+requirements-min: ## Generate the requirements.txt files (minimal dependencies)
+	$(UV_RUN) export --no-emit-workspace --no-hashes --no-group dev --output-file requirements.txt
+
+requirements-all: ## Generate the all-requirements.txt files (all dependencies)
+	$(UV_RUN) export --no-emit-workspace --no-hashes --all-extras --no-group dev --output-file all-requirements.txt
+
+requirements-docker: ## Generate the docker-requirements.txt files (Docker specific dependencies)
+	$(UV_RUN) export --no-emit-workspace --no-hashes --no-group dev --extra containers --extra web --output-file docker-requirements.txt
+
+requirements-dev: ## Generate the dev-requirements.txt files (dev dependencies)
+	$(UV_RUN) export --no-hashes --only-dev --output-file dev-requirements.txt
+
+requirements: requirements-min requirements-all requirements-dev requirements-docker  ## Generate all the requirements files
+
+requirements-upgrade: venv-upgrade requirements  ## Upgrade the virtualenv and regenerate all the requirements files
+
+# ===================================================================
+# Tests
+# ===================================================================
+
+test: ## Run All unit tests
+	$(UV_RUN) run pytest
+
+test-core: ## Run Core unit tests
+	$(UV_RUN) run pytest tests/test_core.py
+
+test-api: ## Run API unit tests
+	$(UV_RUN) run pytest tests/test_api.py
+
+test-memoryleak: ## Run Memory-leak unit tests
+	$(UV_RUN) run pytest tests/test_memoryleak.py
+
+test-perf: ## Run Perf unit tests
+	$(UV_RUN) run pytest tests/test_perf.py
+
+test-restful: ## Run Restful API unit tests
+	$(UV_RUN) run pytest tests/test_restful.py
+
+test-webui: ## Run WebUI unit tests
+	$(UV_RUN) run pytest tests/test_webui.py
+
+test-xmlrpc: ## Run XMLRPC API unit tests
+	$(UV_RUN) run pytest tests/test_xmlrpc.py
+
+test-with-upgrade: venv-upgrade test ## Upgrade deps and run unit tests
+
+test-export-csv: ## Run interface tests with CSV
+	/bin/bash ./tests/test_export_csv.sh
+
+test-export-json: ## Run interface tests with JSON
+	/bin/bash ./tests/test_export_json.sh
+
+test-export-influxdb-v1: ## Run interface tests with InfluxDB version 1 (Legacy)
+	/bin/bash ./tests/test_export_influxdb_v1.sh
+
+test-export-influxdb-v3: ## Run interface tests with InfluxDB version 3 (Core)
+	/bin/bash ./tests/test_export_influxdb_v3.sh
+
+test-export-timescaledb: ## Run interface tests with TimescaleDB
+	/bin/bash ./tests/test_export_timescaledb.sh
+
+test-export-nats: ## Run interface tests with NATS
+	/bin/bash ./tests/test_export_nats.sh
+
+test-exports: test-export-csv test-export-json test-export-influxdb-v1 test-export-influxdb-v3 test-export-timescaledb test-export-nats ## Tests all exports
+
+# ===================================================================
+# Linters, profilers and cyber security
+# ===================================================================
+
+pre-commit: ## Run pre-commit hooks
+	$(UV_RUN) run pre-commit run --all-files
+
+find-duplicate-lines: ## Search for duplicate lines in files
+	/bin/bash tests-data/tools/find-duplicate-lines.sh
+
+format: ## Format the code
+	$(UV_RUN) run ruff format .
+
+lint: ## Lint the code.
+	$(UV_RUN) run ruff check . --fix
+
+lint-readme: ## Lint the main README.rst file
+	$(UV_RUN) run rstcheck README.rst
+	$(UV_RUN) run rstcheck README-pypi.rst
+
+codespell: ## Run codespell to fix common misspellings in text files
+	$(UV_RUN) run codespell -S .git,./docs/_build,./Glances.egg-info,./venv*,./glances/outputs,*.svg -L hart,bu,te,statics -w
+
+semgrep: ## Run semgrep to find bugs and enforce code standards
+	$(UV_RUN) run semgrep scan --config=auto
+
+profiling-%: SLEEP = 3
+profiling-%: TIMES = 30
+profiling-%: OUT_DIR = docs/_static
+
+define DISPLAY-BANNER
+@echo "Start Glances for $(TIMES) iterations (more or less 1 mins, please do not exit !)"
+sleep $(SLEEP)
+endef
+
+profiling-gprof: CPROF = glances.cprof
+profiling-gprof: ## Callgraph profiling (need "apt install graphviz")
+	$(DISPLAY-BANNER)
+	$(UV_RUN) run python -m cProfile -o $(CPROF) run-venv.py -C $(CONF) --stop-after $(TIMES)
+	$(UV_RUN) run gprof2dot -f pstats $(CPROF) | dot -Tsvg -o $(OUT_DIR)/glances-cgraph.svg
+	rm -f $(CPROF)
+
+profiling-pyinstrument: ## PyInstrument profiling
+	$(DISPLAY-BANNER)
+	$(UV_RUN) add pyinstrument
+	$(UV_RUN) run pyinstrument -r html -o $(OUT_DIR)/glances-pyinstrument.html -m glances -C $(CONF) --stop-after $(TIMES)
+
+profiling-pyspy: ## Flame profiling
+	$(DISPLAY-BANNER)
+	$(UV_RUN) run py-spy record -o $(OUT_DIR)/glances-flame.svg -d 60 -s -- .venv-uv/bin/uvrun python run-venv.py -C $(CONF) --stop-after $(TIMES)
+
+profiling: profiling-gprof profiling-pyinstrument profiling-pyspy ## Profiling of the Glances software
+
+trace-malloc: ## Trace the malloc() calls
+	@echo "Malloc test is running, please wait ~30 secondes..."
+	$(UV_RUN) run python -m glances -C $(CONF) --trace-malloc --stop-after 15 --quiet
+
+memory-leak: ## Profile memory leaks
+	$(UV_RUN) run python -m glances -C $(CONF) --memory-leak
+
+memory-profiling: TIMES = 2400
+memory-profiling: PROFILE = mprofile_*.dat
+memory-profiling: OUT_DIR = docs/_static
+memory-profiling: ## Profile memory usage
+	@echo "It's a very long test (~4 hours)..."
+	rm -f $(PROFILE)
+	@echo "1/2 - Start memory profiling with the history option enable"
+	$(UV_RUN) run mprof run -T 1 -C run-venv.py -C $(CONF) --stop-after $(TIMES) --quiet
+	$(UV_RUN) run mprof plot --output $(OUT_DIR)/glances-memory-profiling-with-history.png
+	rm -f $(PROFILE)
+	@echo "2/2 - Start memory profiling with the history option disable"
+	$(UV_RUN) run mprof run -T 1 -C run-venv.py -C $(CONF) --disable-history --stop-after $(TIMES) --quiet
+	$(UV_RUN) run mprof plot --output $(OUT_DIR)/glances-memory-profiling-without-history.png
+	rm -f $(PROFILE)
+
+# Trivy installation: https://aquasecurity.github.io/trivy/latest/getting-started/installation/
+trivy: ## Run Trivy to find vulnerabilities
+	$(UV_RUN) run trivy fs ./glances/
+
+bandit: ## Run Bandit to find vulnerabilities
+	$(UV_RUN) run bandit glances -r
+
+# ===================================================================
+# Docs
+# ===================================================================
+
+docs: ## Create the documentation
+	$(UV_RUN) run python -m glances -C $(CONF) --api-doc > ./docs/api/python.rst
+	$(UV_RUN) run python ./generate_openapi.py
+	$(UV_RUN) run python -m glances -C $(CONF) --api-restful-doc > ./docs/api/restful.rst
+	cd docs && ./build.sh && cd ..
+
+docs-server: docs ## Start a Web server to serve the documentation
+	(sleep 2 && sensible-browser "http://localhost:$(PORT)") &
+	cd docs/_build/html/ && .venv-uv/bin/uvrun python -m http.server $(PORT)
+
+docs-jupyter:  ## Start Jupyter Notebook
+	$(UV_RUN) run --with jupyter jupyter lab
+
+release-note: ## Generate release note
+	git --no-pager log $(LASTTAG)..HEAD --first-parent --pretty=format:"* %s"
+	@echo "\n"
+	git --no-pager shortlog -s -n $(LASTTAG)..HEAD
+
+install: ## Open a Web Browser to the installation procedure
+	sensible-browser "https://github.com/nicolargo/glances#installation"
+
+# ===================================================================
+# WebUI
+# Follow ./glances/outputs/static/README.md for more information
+# ===================================================================
+
+webui webui%: DIR = glances/outputs/static/
+
+webui-gen-config: ## Generate the Web UI config file
+	$(UV_RUN) run python ./generate_webui_conf.py > ./glances/outputs/static/js/uiconfig.json
+
+webui: webui-gen-config ## Build the Web UI
+	cd $(DIR) && npm ci && npm run build
+
+webui-audit: ## Audit the Web UI
+	cd $(DIR) && npm audit
+
+webui-audit-fix: webui-gen-config ## Fix audit the Web UI
+	cd $(DIR) && npm audit fix && npm ci && npm run build
+
+webui-update: webui-gen-config ## Update JS dependencies
+	cd $(DIR) && npm update --save && npm ci && npm run build
+
+# ===================================================================
+# Packaging
+# ===================================================================
+
+flatpak: venv-upgrade ## Generate FlatPack JSON file
+	git clone https://github.com/flatpak/flatpak-builder-tools.git
+	$(UV_RUN) run python ./flatpak-builder-tools/pip/flatpak-pip-generator glances
+	rm -rf ./flatpak-builder-tools
+	@echo "Now follow: https://github.com/flathub/flathub/wiki/App-Submission"
+
+# Snap package is automatically build on the Snapcraft.io platform
+# https://snapcraft.io/glances
+# But you can try an offline build with the following command
+snapcraft:
+	snapcraft
+
+# ===================================================================
+# Docker
+# Need Docker Buildx package (apt install docker-buildx on Ubuntu)
+# ===================================================================
+
+define MAKE_DOCKER_BUILD_RULES
+$($(DISTRO)_images): docker-$(DISTRO)-%: docker-files/$(DISTRO).Dockerfile
+	$(DOCKER_BUILD) --target $$* -f $$< -t glances:local-$(DISTRO)-$$* .
+endef
+
+$(foreach DISTRO,$(DISTROS),$(eval $(MAKE_DOCKER_BUILD_RULES)))
+
+docker: docker-alpine docker-ubuntu ## Generate local docker images
+
+docker-alpine: $(alpine_images) ## Generate local docker images (Alpine)
+docker-ubuntu: $(ubuntu_images) ## Generate local docker images (Ubuntu)
+
+docker-alpine-full: ## Generate local docker image (Alpine full)
+docker-alpine-minimal: ## Generate local docker image (Alpine minimal)
+docker-alpine-dev: ## Generate local docker image (Alpine dev)
+docker-ubuntu-full: ## Generate local docker image (Ubuntu full)
+docker-ubuntu-minimal: ## Generate local docker image (Ubuntu minimal)
+docker-ubuntu-dev: ## Generate local docker image (Ubuntu dev)
+
+trivy-docker: ## Run Trivy to find vulnerabilities in Docker images
+	$(UV_RUN) run trivy image glances:local-alpine-full
+	$(UV_RUN) run trivy image glances:local-alpine-minimal
+	$(UV_RUN) run trivy image glances:local-ubuntu-full
+	$(UV_RUN) run trivy image glances:local-ubuntu-minimal
+
+# ===================================================================
+# Run
+# ===================================================================
+
+run: ## Start Glances in console mode (also called standalone)
+	$(UV_RUN) run python -m glances -C $(CONF)
+
+run-debug: ## Start Glances in debug console mode (also called standalone)
+	$(UV_RUN) run python -m glances -C $(CONF) -d
+
+run-local-conf: ## Start Glances in console mode with the system conf file
+	$(UV_RUN) run python -m glances
+
+run-local-conf-hide-public: ## Start Glances in console mode with the system conf file and hide public information
+	$(UV_RUN) run python -m glances --hide-public-info
+
+run-like-htop: ## Start Glances with the same features than Htop
+	$(UV_RUN) run python -m glances --disable-plugin network,ports,wifi,connections,diskio,fs,irq,folders,raid,smart,sensors,vms,containers,ip,amps --disable-left-sidebar
+
+run-fetch: ## Start Glances in fetch mode
+	$(UV_RUN) run python -m glances --fetch
+
+$(DOCKER_RUNTIMES): run-docker-%:
+	$(DOCKER_RUN) $(DOCKER_OPTS) $(DOCKER_SOCKS) -it glances:local-$*
+
+run-docker-alpine-minimal: ## Start Glances Alpine Docker minimal in console mode
+run-docker-alpine-full: ## Start Glances Alpine Docker full in console mode
+run-docker-alpine-dev: ## Start Glances Alpine Docker dev in console mode
+run-docker-ubuntu-minimal: ## Start Glances Ubuntu Docker minimal in console mode
+run-docker-ubuntu-full: ## Start Glances Ubuntu Docker full in console mode
+run-docker-ubuntu-dev: ## Start Glances Ubuntu Docker dev in console mode
+
+generate-ssl: ## Generate local and sel signed SSL certificates for dev (need mkcert)
+	mkcert glances.local localhost 120.0.0.1 0.0.0.0
+
+run-webserver: ## Start Glances in Web server mode
+	$(UV_RUN) run python -m glances -C $(CONF) -w
+
+run-webserver-local-conf: ## Start Glances in Web server mode with the system conf file
+	$(UV_RUN) run python -m glances -w
+
+run-webserver-local-conf-hide-public: ## Start Glances in Web server mode with the system conf file and hide public info
+	$(UV_RUN) run python -m glances -w --hide-public-info
+
+run-restapiserver: ## Start Glances in REST API server mode
+	$(UV_RUN) run python -m glances -C $(CONF) -w --disable-webui
+
+run-server: ## Start Glances in server mode (RPC)
+	$(UV_RUN) run python -m glances -C $(CONF) -s
+
+run-client: ## Start Glances in client mode (RPC)
+	$(UV_RUN) run python -m glances -C $(CONF) -c localhost
+
+run-browser: ## Start Glances in browser mode (RPC)
+	$(UV_RUN) run python -m glances -C $(CONF) --browser
+
+run-web-browser: ## Start Web Central Browser
+	$(UV_RUN) run python -m glances -C $(CONF) -w --browser
+
+run-issue: ## Start Glances in issue mode
+	$(UV_RUN) run python -m glances -C $(CONF) --issue
+
+run-multipass: ## Install and start Glances in a VM (only available on Ubuntu with multipass already installed)
+	multipass launch -n glances-on-lts lts
+	multipass exec glances-on-lts -- sudo snap install glances
+	multipass exec glances-on-lts -- glances
+	multipass stop glances-on-lts
+	multipass delete glances-on-lts
+
+show-version: ## Show Glances version number
+	$(UV_RUN) run python -m glances -C $(CONF) -V

NEWS

@@ -1,641 +0,0 @@
-==============================================================================
-Glances Version 2
-==============================================================================
-
-Version 2.6.1
-=============
-
-Enhancements and new features:
-
-    * Add a connector to Riemann (issue #822 by Greogo Nagy)
-
-Bugs corrected:
-
-    * Browsing for servers which are in the [serverlist] is broken (issue #819)
-    * [WebUI] Glances will not get past loading screen (issue #815) opened 9 days ago
-    * Python error after upgrading from 2.5.1 to 2.6 bug (issue #813)
-
-Version 2.6
-===========
-
-Deprecations:
-
-    * Add deprecation warning for Python 2.6.
-      Python 2.6 support will be dropped in future releases.
-      Please switch to at least Python 2.7 or 3.3+ as soon as possible.
-      See http://www.snarky.ca/stop-using-python-2-6 for more information.
-
-Enhancements and new features:
-
-    * Add a connector to ElasticSearch (welcome to Kibana dashboard) (issue #311)
-    * New folders' monitoring plugins (issue #721)
-    * Use wildcard (regexp) to the hide configuration option for network, diskio and fs sections (issue #799 )
-    * Command line arguments are now take into account in the WebUI (#789 by  @notFloran)
-    * Change username for server and web server authentication (issue #693)
-    * Add an option to disable top menu (issue #766)
-    * Add IOps in the DiskIO plugin (issue #763)
-    * Add hide configuration key for FS Plugin (issue #736)
-    * Add process summary min/max stats (issue #703)
-    * Add timestamp to the CSV export module (issue #708)
-    * Add a shortcut 'E' to delete process filter (issue #699)
-    * By default, hide disk I/O ram1-** (issue #714)
-    * When Glances is starting the notifications should be delayed (issue #732)
-    * Add option (--disable-bg) to disable ANSI background colours (issue #738 by okdana)
-    * [WebUI] add "pointer" cursor for sortable columns (issue #704 by @notFloran)
-    * [WebUI] Make web page title configurable (issue #724)
-    * Do not show interface in down state (issue #765)
-    * InfluxDB > 0.9.3 needs float and not int for numerical value (issue#749 and issue#750 by nicolargo)
-
-Bugs corrected:
-
-    * Can't read sensors on a Thinkpad (issue #711)
-    * InfluxDB/OpenTSDB: tag parsing broken (issue #713)
-    * Grafana Dashboard outdated for InfluxDB 0.9.x (issue #648)
-    * '--tree' breaks process filter on Debian 8 (issue #768)
-    * Fix highlighting of process when it contains whitespaces (issue #546 by Alessio Sergi)
-    * Fix RAID support in Python 3 (issue #793 by Alessio Sergi)
-    * Use dict view objects to avoid issue (issue #758 by Alessio Sergi)
-    * System exit if Cpu not supported by the Cpuinfo lib (issue #754 by nicolargo)
-    * KeyError: 'cpucore' when exporting data to InfluxDB (issue #729) by nicolargo)
-
-Others:
-    * A new Glances docker container to monitor your Docker infrastructure is available here (issue #728): https://hub.docker.com/r/nicolargo/glances/
-    * Documentation is now generated automatically thanks to Sphinx and the Alessio Sergi patch (http://glances.readthedocs.org/en/latest/)
-
-Contributors summary:
-    * Nicolas Hennion: 112 commits
-    * Alessio Sergi: 55 commits
-    * Floran Brutel: 19 commits
-    * Nicolas Hart: 8 commits
-    * @desbma: 4 commits
-    * @dana: 2 commits
-    * Damien Martin, Raju Kadam, @georgewhewell: 1 commit
-
-Version 2.5.1
-=============
-
-Bugs corrected:
-
-    * Unable to unlock password protected servers in browser mode bug (issue #694)
-    * Correct issue when Glances is started in console on Windows OS
-    * [WebUI] when alert is ongoing hide level enhancement (issue #692)
-
-Version 2.5
-===========
-
-Enhancements and new features:
-
-    * Allow export of Docker and sensors plugins stats to InfluxDB, StatsD... (issue #600)
-    * Docker plugin shows IO and network bitrate (issue #520)
-    * Server password configuration for the browser mode (issue #500)
-    * Add support for OpenTSDB export (issue #638)
-    * Add additional stats (iowait, steal) to the perCPU plugin (issue #672)
-    * Support Fahrenheit unit in the sensor plugin using the --fahrenheit command line option (issue #620)
-    * When a process filter is set, display sum of CPU, MEM... (issue #681)
-    * Improve the QuickLookplugin by adding hardware CPU info (issue #673)
-    * WebUI display a message if server is not available (issue #564)
-    * Display an error if export is not used in the standalone/client mode (issue #614)
-    * New --disable-quicklook, --disable-cpu, --disable-mem, --disable-swap, --disable-load tags (issue #631)
-    * Complete refactoring of the WebUI thanks to the (awesome) Floran pull (issue #656)
-    * Network cumulative /combination feature available in the WebUI (issue #552)
-    * IRIX mode off implementation (issue#628)
-    * Short process name displays arguments (issue #609)
-    * Server password configuration for the browser mode (issue #500)
-    * Display an error if export is not used in the standalone/client mode (issue #614)
-
-Bugs corrected:
-
-    * The WebUI displays bad sensors stats (issue #632)
-    * Filter processes crashs with a bad regular expression pattern (issue #665)
-    * Error with IP plugin (issue #651)
-    * Crach with Docker plugin (issue #649)
-    * Docker plugin crashs with webserver mode (issue #654)
-    * Infrequently crashing due to assert (issue #623)
-    * Value for free disk space is counterintuative on ext file systems (issue #644)
-    * Try/catch for unexpected psutil.NoSuchProcess: process no longer exists (issue #432)
-    * Fatal error using Python 3.4 and Docker plugin bug (issue #602)
-    * Add missing new line before g man option (issue #595)
-    * Remove unnecessary type="text/css" for link (HTML5) (issue #595)
-    * Correct server mode issue when no network interface is available (issue #528)
-    * Avoid crach on olds kernels (issue #554)
-    * Avoid crashing if LC_ALL is not defined by user (issue #517)
-    * Add a disable HDD temperature option on the command line (issue #515)
-
-
-Version 2.4.2
-=============
-
-Bugs corrected:
-
-    * Process no longer exists (again) (issue #613)
-    * Crash when "top extended stats" is enabled on OS X (issue #612)
-    * Graphical percentage bar displays "?" (issue #608)
-    * Quick look doesn't work (issue #605)
-    * [Web UI] Display empty Battery sensors enhancement (issue #601)
-    * [Web UI] Per CPU plugin has to be improved (issue #566)
-
-Version 2.4.1
-=============
-
-Bugs corrected:
-
-    * Fatal error using Python 3.4 and Docker plugin bug (issue #602)
-
-Version 2.4
-===========
-
-Changes:
-
-    * Glances doesn't provide a system-wide configuration file by default anymore.
-      Just copy it in any of the supported locations. See glances-doc.html for
-      more information. (issue #541)
-    * The default key bindings have been changed to:
-      - 'u': sort processes by USER
-      - 'U': show cumulative network I/O
-    * No more translations
-
-Enhancements and new features:
-
-    * The Web user interface is now based on AngularJS (issue #473, #508, #468)
-    * Implement a 'quick look' plugin (issue #505)
-    * Add sort processes by USER (issue #531)
-    * Add a new IP information plugin (issue #509)
-    * Add RabbitMQ export module (issue #540 Thk to @Katyucha)
-    * Add a quiet mode (-q), can be useful using with export module
-    * Grab FAN speed in the Glances sensors plugin (issue #501)
-    * Allow logical mounts points in the FS plugin (issue #448)
-    * Add a --disable-hddtemp to disable HDD temperature module at startup (issue #515)
-    * Increase alert minimal delay to 6 seconds (issue #522)
-    * If the Curses application raises an exception, restore the terminal correctly (issue #537)
-
-Bugs corrected:
-
-    * Monitor list, all processes are take into account (issue #507)
-    * Duplicated --enable-history in the doc (issue #511)
-    * Sensors title is displayed if no sensors are detected (issue #510)
-    * Server mode issue when no network interface is available (issue #528)
-    * DEBUG mode activated by default with Python 2.6 (issue #512)
-    * Glances display of time trims the hours showing only minutes and seconds (issue #543)
-    * Process list header not decorating when sorting by command (issue #551)
-
-Version 2.3
-===========
-
-Enhancements and new features:
-
-    * Add the Docker plugin (issue #440) with per container CPU and memory monitoring (issue #490)
-    * Add the RAID plugin (issue #447)
-    * Add actions on alerts (issue #132). It is now possible to run action (command line) by triggers. Action could contain {{tag}} (Mustache) with stat value.
-    * Add InfluxDB export module (--export-influxdb) (issue #455)
-    * Add StatsD export module (--export-statsd) (issue #465)
-    * Refactor export module (CSV export option is now --export-csv). It is now possible to export stats from the Glances client mode (issue #463)
-    * The Web inteface is now based on Bootstrap / RWD grid (issue #417, #366 and #461) Thanks to Nicolas Hart @nclsHart
-    * It is now possible, through the configuration file, to define if an alarm should be logged or not (using the _log option) (issue #437)
-    * You can now set alarm for Disk IO
-    * API: add getAllLimits and getAllViews methods (issue #481) and allow CORS request (issue #479)
-    * SNMP client support NetApp appliance (issue #394)
-
-Bugs corrected:
-
-    *  R/W error with the glances.log file (issue #474)
-
-Other enhancement:
-
-    * Alert < 3 seconds are no longer displayed
-
-Version 2.2.1
-=============
-
-    * Fix incorrect kernel thread detection with --hide-kernel-threads (issue #457)
-    * Handle IOError exception if no /etc/os-release to use Glances on Synology DSM (issue #458)
-    * Check issue error in client/server mode (issue #459)
-
-Version 2.2
-===========
-
-Enhancements and new features:
-
-    * Add centralized curse interface with a Glances servers list to monitor (issue #418)
-    * Add processes tree view (--tree) (issue #444)
-    * Improve graph history feature (issue #69)
-    * Extended stats is disable by default (use --enable-process-extended to enable it - issue #430)
-    * Add a short key ('F') and a command line option (--fs-free-space) to display FS free space instead of used space (issue #411)
-    * Add a short key ('2') and a command line option (--disable-left-sidebar) to disable/enable the side bar (issue #429)
-    * Add CPU times sort short key ('t') in the curse interface (issue #449)
-    * Refactor operating system detection for GNU/Linux operating system
-    * Code optimization
-
-Bugs corrected:
-
-    * Correct a bug with Glances pip install --user (issue #383)
-    * Correct issue on battery stat update (issue #433)
-    * Correct issue on process no longer exist (issues #414 and #432)
-
-Version 2.1.2
-=============
-
-    Maintenance version (only needed for Mac OS X).
-
-Bugs corrected:
-
-    * Mac OS X: Error if Glances is not ran with sudo (issue #426)
-
-Version 2.1.1
-=============
-
-Enhancement:
-
-    * Automaticaly compute top processes number for the current screen (issue #408)
-    * CPU and Memory footprint optimization (issue #401)
-
-Bugs corrected:
-
-    * Mac OS X 10.9: Exception at start (issue #423)
-    * Process no longer exists (issue #421)
-    * Error with Glances Client with Python 3.4.1 (issue #419)
-    * TypeError: memory_maps() takes exactly 2 arguments (issue #413)
-    * No filesystem informations since Glances 2.0 bug enhancement (issue #381)
-
-Version 2.1
-===========
-
-    * Add user process filter feature
-      User can define a process filter pattern (as a regular expression).
-      The pattern could be defined from the command line (-f <pattern>)
-      or by pressing the ENTER key in the curse interface.
-      For the moment, process filter feature is only available in standalone mode.
-    * Add extended processes informations for top process
-      Top process stats availables: CPU affinity, extended memory information (shared, text, lib, datat, dirty, swap), open threads/files and TCP/UDP network sessions, IO nice level
-      For the moment, extended processes stats are only available in standalone mode.
-    * Add --process-short-name tag and '/' key to switch between short/command line
-    * Create a max_processes key in the configuration file
-      The goal is to reduce the number of displayed processes in the curses UI and
-      so limit the CPU footprint of the Glances standalone mode.
-      The API always return all the processes, the key is only active in the curses UI.
-      If the key is not define, all the processes will be displayed.
-      The default value is 20 (processes displayed).
-      For the moment, this feature is only available in standalone mode.
-    * Alias for network interfaces, disks and sensors
-      Users can configure alias from the Glances configuration file.
-    * Add Glances log message (in the /tmp/glances.log file)
-      The default log level is INFO, you can switch to the DEBUG mode using the -d option on the command line.
-    * Add RESTFul API to the Web server mode
-      RestFul API doc: https://github.com/nicolargo/glances/wiki/The-Glances-RESTFULL-JSON-API
-    * Improve SNMP fallback mode for Cisco IOS, VMware ESXi
-    * Add --theme-white feature to optimize display for white background
-    * Experimental history feature (--enable-history option on the command line)
-      This feature allows users to generate graphs within the curse interface.
-      Graphs are available for CPU, LOAD and MEM.
-      To generate graph, click on the 'g' key.
-      To reset the history, press the 'r' key.
-      Note: This feature uses the matplotlib library.
-    * CI: Improve Travis coverage
-
-Bugs corrected:
-
-    * Quitting glances leaves a column layout to the current terminal (issue #392)
-    * Glances crashes with malformed UTF-8 sequences in process command lines (issue #391)
-    * SNMP fallback mode is not Python 3 compliant (issue #386)
-    * Trouble using batinfo, hddtemp, pysensors w/ Python (issue #324)
-
-
-Version 2.0.1
-=============
-
-Maintenance version.
-
-Bugs corrected:
-
-    * Error when displaying numeric process user names (#380)
-    * Display users without username correctly (#379)
-    * Bug when parsing configuration file (#378)
-    * The sda2 partition is not seen by glances (#376)
-    * Client crash if server is ended during XML request (#375)
-    * Error with the Sensors module on Debian/Ubuntu (#373)
-    * Windows don't view all processes (#319)
-
-Version 2.0
-===========
-
-    Glances v2.0 is not a simple upgrade of the version 1.x but a complete code refactoring.
-    Based on a plugins system, it aims at providing an easy way to add new features.
-    - Core defines the basics and commons functions.
-    - all stats are grabbed through plugins (see the glances/plugins source folder).
-    - also outputs methods (Curse, Web mode, CSV) are managed as plugins.
-
-    The Curse interface is almost the same than the version 1.7. Some improvements have been made:
-    - space optimisation for the CPU, LOAD and MEM stats (justified alignment)
-    - CPU:
-        . CPU stats are displayed as soon as Glances is started
-        . steal CPU alerts are no more logged
-    - LOAD:
-        . 5 min LOAD alerts are no more logged
-    - File System:
-        . Display the device name (if space is available)
-    - Sensors:
-        . Sensors and HDD temperature are displayed in the same block
-    - Process list:
-        . Refactor columns: CPU%, MEM%, VIRT, RES, PID, USER, NICE, STATUS, TIME, IO, Command/name
-        . The running processes status is highlighted
-        . The process name is highlighted in the command line
-
-    Glances 2.0 brings a brand new Web Interface. You can run Glances in Web server mode and
-    consult the stats directly from a standard Web Browser.
-
-    The client mode can now fallback to a simple SNMP mode if Glances server is not found on the remote machine.
-
-    Complete release notes:
-    * Cut ifName and DiskName if they are too long in the curses interface (by Nicolargo)
-    * Windows CLI is OK but early experimental (by Nicolargo)
-    * Add bitrate limits to the networks interfaces (by Nicolargo)
-    * Batteries % stats are now in the sensors list (by Nicolargo)
-    * Refactor the client/server password security: using SHA256 (by Nicolargo,
-      based on Alessio Sergi's example script)
-    * Refactor the CSV output (by Nicolargo)
-    * Glances client fallback to SNMP server if Glances one not found (by Nicolargo)
-    * Process list: Highlight running/basename processes (by Alessio Sergi)
-    * New Web server mode thk to the Bottle library (by Nicolargo)
-    * Responsive design for Bottle interface (by Nicolargo)
-    * Remove HTML output (by Nicolargo)
-    * Enable/disable for optional plugins through the command line (by Nicolargo)
-    * Refactor the API (by Nicolargo)
-    * Load-5 alert are no longer logged (by Nicolargo)
-    * Rename In/Out by Read/Write for DiskIO according to #339 (by Nicolargo)
-    * Migrate from pysensors to py3sensors (by Alessio Sergi)
-    * Migration to PsUtil 2.x (by Nicolargo)
-    * New plugins system (by Nicolargo)
-    * Python 2.x and 3.x compatibility (by Alessio Sergi)
-    * Code quality improvements (by Alessio Sergi)
-    * Refactor unitaries tests (by Nicolargo)
-    * Development now follow the git flow workflow (by Nicolargo)
-
-
-==============================================================================
-Glances Version 1
-==============================================================================
-
-Version 1.7.7
-=============
-
-    * Fix CVS export [issue #348]
-    * Adapt to PSUtil 2.1.1
-    * Compatibility with Python 3.4
-    * Improve German update
-
-Version 1.7.6
-=============
-
-    * Adapt to psutil 2.0.0 API
-    * Fixed psutil 0.5.x support on Windows
-    * Fix help screen in 80x24 terminal size
-    * Implement toggle of process list display ('z' key)
-
-Version 1.7.5
-=============
-
-    * Force the Pypi installer to use the PsUtil branch 1.x (#333)
-
-Version 1.7.4
-=============
-
-    * Add threads number in the task summary line (#308)
-    * Add system uptime (#276)
-    * Add CPU steal % to cpu extended stats (#309)
-    * You can hide disk from the IOdisk view using the conf file (#304)
-    * You can hide network interface from the Network view using the conf file
-    * Optimisation of CPU consumption (around ~10%)
-    * Correct issue #314: Client/server mode always asks for password
-    * Correct issue #315: Defining password in client/server mode doesn't work as intended
-    * Correct issue #316: Crash in client server mode
-    * Correct issue #318: Argument parser, try-except blocks never get triggered
-
-Version 1.7.3
-=============
-
-    * Add --password argument to enter the client/server password from the prompt
-    * Fix an issue with the configuration file path (#296)
-    * Fix an issue with the HTML template (#301)
-
-Version 1.7.2
-=============
-
-    * Console interface is now Microsoft Windows compatible (thk to @fraoustin)
-    * Update documentation and Wiki regarding the API
-    * Added package name for python sources/headers in openSUSE/SLES/SLED
-    * Add FreeBSD packager
-    * Bugs corrected
-
-Version 1.7.1
-=============
-
-    * Fix IoWait error on FreeBSD / Mac OS
-    * HDDTemp module is now Python v3 compatible
-    * Don't warn a process is not running if countmin=0
-    * Add Pypi badge on the README.rst
-    * Update documentation
-    * Add document structure for http://readthedocs.org
-
-Version 1.7
-===========
-
-    * Add monitored processes list
-    * Add hard disk temperature monitoring (thanks to the HDDtemp daemon)
-    * Add batteries capacities information (thanks to the Batinfo lib)
-    * Add command line argument -r toggles processes (reduce CPU usage)
-    * Add command line argument -1 to run Glances in per CPU mode
-    * Platform/architecture is more specific now
-    * XML-RPC server: Add IPv6 support for the client/server mode
-    * Add support for local conf file
-    * Add a uninstall script
-    * Add getNetTimeSinceLastUpdate() getDiskTimeSinceLastUpdate() and getProcessDiskTimeSinceLastUpdate() in the API
-    * Add more translation: Italien, Chinese
-    * and last but not least... up to 100 hundred bugs corrected / software and
-    * docs improvements
-
-Version 1.6.1
-=============
-
-    * Add per-user settings (configuration file) support
-    * Add -z/--nobold option for better appearance under Solarized terminal
-    * Key 'u' shows cumulative net traffic
-    * Work in improving autoUnit
-    * Take into account the number of core in the CPU process limit
-    * API improvment add time_since_update for disk, process_disk and network
-    * Improve help display
-    * Add more dummy FS to the ignore list
-    * Code refactory: PsUtil < 0.4.1 is depredicated (Thk to Alessio)
-    * Correct a bug on the CPU process limit
-    * Fix crash bug when specifying custom server port
-    * Add Debian style init script for the Glances server
-
-Version 1.6
-===========
-
-    * Configuration file: user can defines limits
-    * In client/server mode, limits are set by the server side
-    * Display limits in the help screen
-    * Add per process IO (read and write) rate in B per second
-      IO rate only available on Linux from a root account
-    * If CPU iowait alert then sort by processes by IO rate
-    * Per CPU display IOwait (if data is available)
-    * Add password for the client/server mode (-P password)
-    * Process column style auto (underline) or manual (bold)
-    * Display a sort indicator (is space is available)
-    * Change the table key in the help screen
-
-Version 1.5.2
-=============
-
-    * Add sensors module (enable it with -e option)
-    * Improve CPU stats (IO wait, Nice, IRQ)
-    * More stats in lower space (yes it's possible)
-    * Refactor processes list and count (lower CPU/MEM footprint)
-    * Add functions to the RCP method
-    * Completed unit test
-    * and fixes...
-
-Version 1.5.1
-=============
-
-    * Patch for PsUtil 0.4 compatibility
-    * Test PsUtil version before running Glances
-
-Version 1.5
-===========
-
-    * Add a client/server mode (XMLRPC) for remote monitoring
-    * Correct a bug on process IO with non root users
-    * Add 'w' shortkey to delete finished warning message
-    * Add 'x' shortkey to delete finished warning/critical message
-    * Bugs correction
-    * Code optimization
-
-Version 1.4.2.2
-===============
-
-    * Add switch between bit/sec and byte/sec for network IO
-    * Add Changelog (generated with gitchangelog)
-
-Version 1.4.2.1
-===============
-
-    * Minor patch to solve memomy issue (#94) on Mac OS X
-
-Version 1.4.2
-=============
-
-    * Use the new virtual_memory() and virtual_swap() fct (PsUtil)
-    * Display "Top process" in logs
-    * Minor patch on man page for Debian packaging
-    * Code optimization (less try and except)
-
-Version 1.4.1.1
-===============
-
-    * Minor patch to disable Process IO for OS X (not available in PsUtil)
-
-Version 1.4.1
-=============
-
-    * Per core CPU stats (if space is available)
-    * Add Process IO Read/Write information (if space is available)
-    * Uniformize units
-
-Version 1.4
-===========
-
-    * Goodby StatGrab... Welcome to the PsUtil library !
-    * No more autotools, use setup.py to install (or package)
-    * Only major stats (CPU, Load and memory) use background colors
-    * Improve operating system name detection
-    * New system info: one-line layout and add Arch Linux support
-    * No decimal places for values < GB
-    * New memory and swap layout
-    * Add percentage of usage for both memory and swap
-    * Add MEM% usage, NICE, STATUS, UID, PID and running TIME per process
-    * Add sort by MEM% ('m' key)
-    * Add sort by Process name ('p' key)
-    * Multiple minor fixes, changes and improvements
-    * Disable Disk IO module from the command line (-d)
-    * Disable Mount module from the command line (-m)
-    * Disable Net rate module from the command line (-n)
-    * Improved FreeBSD support
-    * Cleaning code and style
-    * Code is now checked with pep8
-    * CSV and HTML output (experimental functions, no yet documentation)
-
-Version 1.3.7
-=============
-
-    * Display (if terminal space is available) an alerts history (logs)
-    * Add a limits classe to manage stats limits
-    * Manage black and white console (issue #31)
-
-Version 1.3.6
-=============
-
-    * Add control before libs import
-    * Change static Python path (issue #20)
-    * Correct a bug with a network interface disaippear (issue #27)
-    * Add French and Spanish translation (thx to Jean Bob)
-
-Version 1.3.5
-=============
-
-    * Add an help panel when Glances is running (key: 'h')
-    * Add keys descriptions in the syntax (--help | -h)
-
-Version 1.3.4
-=============
-
-    * New key: 'n' to enable/disable network stats
-    * New key: 'd' to enable/disable disk IO stats
-    * New key: 'f' to enable/disable FS stats
-    * Reorganised the screen when stat are not available|disable
-    * Force Glances to use the enmbeded fs stats (issue #16)
-
-Version 1.3.3
-=============
-
-    * Automatically swith between process short and long name
-    * Center the host / system information
-    * Always put the hour/date in the bottom/right
-    * Correct a bug if there is a lot of Disk/IO
-    * Add control about available libstatgrab functions
-
-Version 1.3.2
-=============
-
-    * Add alert for network bit rate°
-    * Change the caption
-    * Optimised net, disk IO and fs display (share the space)
-      Disable on Ubuntu because the libstatgrab return a zero value
-      for the network interface speed.
-
-Version 1.3.1
-=============
-
-    * Add alert on load (depend on number of CPU core)
-    * Fix bug when the FS list is very long
-
-Version 1.3
-===========
-
-    * Add file system stats (total and used space)
-    * Adapt unit dynamically (K, M, G)
-    * Add man page (Thanks to Edouard Bourguignon)
-
-Version 1.2
-===========
-
-    * Resize the terminal and the windows are adapted dynamically
-    * Refresh screen instantanetly when a key is pressed
-
-Version 1.1.3
-=============
-
-    * Add disk IO monitoring
-    * Add caption
-    * Correct a bug when computing the bitrate with the option -t
-    * Catch CTRL-C before init the screen (Bug #2)
-    * Check if mem.total = 0 before division (Bug #1)

README-pypi.rst

@@ -0,0 +1,385 @@
+Glances 🌟
+==========
+
+**Glances** is an open-source system cross-platform monitoring tool.
+It allows real-time monitoring of various aspects of your system such as
+CPU, memory, disk, network usage etc. It also allows monitoring of running processes,
+logged in users, temperatures, voltages, fan speeds etc.
+It also supports container monitoring, it supports different container management
+systems such as Docker, LXC. The information is presented in an easy to read dashboard
+and can also be used for remote monitoring of systems via a web interface or command
+line interface. It is easy to install and use and can be customized to show only
+the information that you are interested in.
+
+In client/server mode, remote monitoring could be done via terminal,
+Web interface or API (XML-RPC and RESTful).
+Stats can also be exported to files or external time/value databases, CSV or direct
+output to STDOUT.
+
+Glances is written in Python and uses libraries to grab information from
+your system. It is based on an open architecture where developers can
+add new plugins or exports modules.
+
+Usage 👋
+========
+
+For the standalone mode, just run:
+
+.. code-block:: console
+
+    $ glances
+
+.. image:: https://github.com/nicolargo/glances/raw/refs/heads/master/docs/_static/glances-responsive-webdesign.png
+
+For the Web server mode, run:
+
+.. code-block:: console
+
+    $ glances -w
+
+and enter the URL ``http://<ip>:61208`` in your favorite web browser.
+
+In this mode, a HTTP/Restful API is exposed, see document `RestfulApi`_ for more details.
+
+.. image:: https://github.com/nicolargo/glances/raw/refs/heads/master/docs/_static/screenshot-web.png
+
+For the client/server mode (remote monitoring through XML-RPC), run the following command on the server:
+
+.. code-block:: console
+
+    $ glances -s
+
+and this one on the client:
+
+.. code-block:: console
+
+    $ glances -c <ip>
+
+You can also detect and display all Glances servers available on your
+network (or defined in the configuration file) in TUI:
+
+.. code-block:: console
+
+    $ glances --browser
+
+or WebUI:
+
+.. code-block:: console
+
+    $ glances -w --browser
+
+It possible to display raw stats on stdout:
+
+.. code-block:: console
+
+    $ glances --stdout cpu.user,mem.used,load
+    cpu.user: 30.7
+    mem.used: 3278204928
+    load: {'cpucore': 4, 'min1': 0.21, 'min5': 0.4, 'min15': 0.27}
+    cpu.user: 3.4
+    mem.used: 3275251712
+    load: {'cpucore': 4, 'min1': 0.19, 'min5': 0.39, 'min15': 0.27}
+    ...
+
+or in a CSV format thanks to the stdout-csv option:
+
+.. code-block:: console
+
+    $ glances --stdout-csv now,cpu.user,mem.used,load
+    now,cpu.user,mem.used,load.cpucore,load.min1,load.min5,load.min15
+    2018-12-08 22:04:20 CEST,7.3,5948149760,4,1.04,0.99,1.04
+    2018-12-08 22:04:23 CEST,5.4,5949136896,4,1.04,0.99,1.04
+    ...
+
+or in a JSON format thanks to the stdout-json option (attribute not supported in this mode in order to have a real JSON object in output):
+
+.. code-block:: console
+
+    $ glances --stdout-json cpu,mem
+    cpu: {"total": 29.0, "user": 24.7, "nice": 0.0, "system": 3.8, "idle": 71.4, "iowait": 0.0, "irq": 0.0, "softirq": 0.0, "steal": 0.0, "guest": 0.0, "guest_nice": 0.0, "time_since_update": 1, "cpucore": 4, "ctx_switches": 0, "interrupts": 0, "soft_interrupts": 0, "syscalls": 0}
+    mem: {"total": 7837949952, "available": 2919079936, "percent": 62.8, "used": 4918870016, "free": 2919079936, "active": 2841214976, "inactive": 3340550144, "buffers": 546799616, "cached": 3068141568, "shared": 788156416}
+    ...
+
+Last but not least, you can use the fetch mode to get a quick look of a machine:
+
+.. code-block:: console
+
+    $ glances --fetch
+
+Results look like this:
+
+.. image:: https://github.com/nicolargo/glances/raw/refs/heads/master/docs/_static/screenshot-fetch.png
+
+Use Glances as a Python library 📚
+==================================
+
+You can access the Glances API by importing the `glances.api` module and creating an
+instance of the `GlancesAPI` class. This instance provides access to all Glances plugins
+and their fields. For example, to access the CPU plugin and its total field, you can
+use the following code:
+
+.. code-block:: python
+
+    >>> from glances import api
+    >>> gl = api.GlancesAPI()
+    >>> gl.cpu
+    {'cpucore': 16,
+     'ctx_switches': 1214157811,
+     'guest': 0.0,
+     'idle': 91.4,
+     'interrupts': 991768733,
+     'iowait': 0.3,
+     'irq': 0.0,
+     'nice': 0.0,
+     'soft_interrupts': 423297898,
+     'steal': 0.0,
+     'syscalls': 0,
+     'system': 5.4,
+     'total': 7.3,
+     'user': 3.0}
+    >>> gl.cpu["total"]
+    7.3
+    >>> gl.mem["used"]
+    12498582144
+    >>> gl.auto_unit(gl.mem["used"])
+    11.6G
+
+If the stats return a list of items (like network interfaces or processes), you can
+access them by their name:
+
+.. code-block:: python
+
+    >>> gl.network.keys()
+    ['wlp0s20f3', 'veth33b370c', 'veth19c7711']
+    >>> gl.network["wlp0s20f3"]
+    {'alias': None,
+     'bytes_all': 362,
+     'bytes_all_gauge': 9242285709,
+     'bytes_all_rate_per_sec': 1032.0,
+     'bytes_recv': 210,
+     'bytes_recv_gauge': 7420522678,
+     'bytes_recv_rate_per_sec': 599.0,
+     'bytes_sent': 152,
+     'bytes_sent_gauge': 1821763031,
+     'bytes_sent_rate_per_sec': 433.0,
+     'interface_name': 'wlp0s20f3',
+     'key': 'interface_name',
+     'speed': 0,
+     'time_since_update': 0.3504955768585205}
+
+For a complete example of how to use Glances as a library, have a look to the `PythonApi`_.
+
+Documentation 📜
+================
+
+For complete documentation have a look at the readthedocs_ website.
+
+If you have any question (after RTFM! and the `FAQ`_), please post it on the official Reddit `forum`_ or in GitHub `Discussions`_.
+
+Gateway to other services 🌐
+============================
+
+Glances can export stats to:
+
+- ``CSV`` file
+- ``JSON`` file
+- ``InfluxDB`` server
+- ``Cassandra`` server
+- ``CouchDB`` server
+- ``OpenTSDB`` server
+- ``Prometheus`` server
+- ``StatsD`` server
+- ``ElasticSearch`` server
+- ``PostgreSQL/TimeScale`` server
+- ``RabbitMQ/ActiveMQ`` broker
+- ``ZeroMQ`` broker
+- ``Kafka`` broker
+- ``Riemann`` server
+- ``Graphite`` server
+- ``RESTful`` endpoint
+
+Installation 🚀
+===============
+
+There are several methods to test/install Glances on your system. Choose your weapon!
+
+PyPI: Pip, the standard way
+---------------------------
+
+Glances is on ``PyPI``. By using PyPI, you will be using the latest stable version.
+
+To install Glances, simply use the ``pip`` command line.
+
+Warning: on modern Linux operating systems, you may have an externally-managed-environment
+error message when you try to use ``pip``. In this case, go to the the PipX section below.
+
+.. code-block:: console
+
+    pip install --user glances
+
+*Note*: Python headers are required to install `psutil`_, a Glances
+dependency. For example, on Debian/Ubuntu **the simplest** is
+``apt install python3-psutil`` or alternatively need to install first
+the *python-dev* package and gcc (*python-devel* on Fedora/CentOS/RHEL).
+For Windows, just install psutil from the binary installation file.
+
+By default, Glances is installed **without** the Web interface dependencies.
+To install it, use the following command:
+
+.. code-block:: console
+
+    pip install --user 'glances[web]'
+
+For a full installation (with all features, see features list bellow):
+
+.. code-block:: console
+
+    pip install --user 'glances[all]'
+
+Features list:
+
+- all: install dependencies for all features
+- action: install dependencies for action feature
+- browser: install dependencies for Glances centram browser
+- cloud: install dependencies for cloud plugin
+- containers: install dependencies for container plugin
+- export: install dependencies for all exports modules
+- gpu: install dependencies for GPU plugin
+- graph: install dependencies for graph export
+- ip: install dependencies for IP public option
+- raid: install dependencies for RAID plugin
+- sensors: install dependencies for sensors plugin
+- smart: install dependencies for smart plugin
+- snmp: install dependencies for SNMP
+- sparklines: install dependencies for sparklines option
+- web: install dependencies for Webserver (WebUI) and Web API
+- wifi: install dependencies for Wifi plugin
+
+To upgrade Glances to the latest version:
+
+.. code-block:: console
+
+    pip install --user --upgrade glances
+
+The current develop branch is published to the test.pypi.org package index.
+If you want to test the develop version (could be instable), enter:
+
+.. code-block:: console
+
+    pip install --user -i https://test.pypi.org/simple/ Glances
+
+PyPI: PipX, the alternative way
+-------------------------------
+
+Install PipX on your system (apt install pipx on Ubuntu).
+
+Install Glances (with all features):
+
+.. code-block:: console
+
+    pipx install 'glances[all]'
+
+The glances script will be installed in the ~/.local/bin folder.
+
+Shell tab completion 🔍
+=======================
+
+Glances 4.3.2 and higher includes shell tab autocompletion thanks to the --print-completion option.
+
+For example, on a Linux operating system with bash shell:
+
+.. code-block:: console
+
+    $ mkdir -p ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion
+    $ glances --print-completion bash > ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances
+    $ source ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances
+
+Following shells are supported: bash, zsh and tcsh.
+
+Requirements 🧩
+===============
+
+Glances is developed in Python. A minimal Python version 3.10 or higher
+should be installed on your system.
+
+*Note for Python 2 users*
+
+Glances version 4 or higher do not support Python 2 (and Python 3 < 3.10).
+Please uses Glances version 3.4.x if you need Python 2 support.
+
+Dependencies:
+
+- ``psutil`` (better with latest version)
+- ``defusedxml`` (in order to monkey patch xmlrpc)
+- ``packaging`` (for the version comparison)
+- ``windows-curses`` (Windows Curses implementation) [Windows-only]
+- ``shtab`` (Shell autocompletion) [All but Windows]
+- ``jinja2`` (for fetch mode and templating)
+
+Extra dependencies:
+
+- ``batinfo`` (for battery monitoring)
+- ``bernhard`` (for the Riemann export module)
+- ``cassandra-driver`` (for the Cassandra export module)
+- ``chevron`` (for the action script feature)
+- ``docker`` (for the Containers Docker monitoring support)
+- ``elasticsearch`` (for the Elastic Search export module)
+- ``FastAPI`` and ``Uvicorn`` (for Web server mode)
+- ``graphitesender`` (For the Graphite export module)
+- ``hddtemp`` (for HDD temperature monitoring support) [Linux-only]
+- ``influxdb`` (for the InfluxDB version 1 export module)
+- ``influxdb-client``  (for the InfluxDB version 2 export module)
+- ``kafka-python`` (for the Kafka export module)
+- ``nvidia-ml-py`` (for the GPU plugin)
+- ``pycouchdb`` (for the CouchDB export module)
+- ``pika`` (for the RabbitMQ/ActiveMQ export module)
+- ``podman`` (for the Containers Podman monitoring support)
+- ``potsdb`` (for the OpenTSDB export module)
+- ``prometheus_client`` (for the Prometheus export module)
+- ``psycopg[binary]`` (for the PostgreSQL/TimeScale export module)
+- ``pygal`` (for the graph export module)
+- ``pymdstat`` (for RAID support) [Linux-only]
+- ``pymongo`` (for the MongoDB export module)
+- ``pysnmp-lextudio`` (for SNMP support)
+- ``pySMART.smartx`` (for HDD Smart support) [Linux-only]
+- ``pyzmq`` (for the ZeroMQ export module)
+- ``requests`` (for the Ports, Cloud plugins and RESTful export module)
+- ``sparklines`` (for the Quick Plugin sparklines option)
+- ``statsd`` (for the StatsD export module)
+- ``wifi`` (for the wifi plugin) [Linux-only]
+- ``zeroconf`` (for the autodiscover mode)
+
+Project sponsorship 🙌
+======================
+
+You can help me to achieve my goals of improving this open-source project
+or just say "thank you" by:
+
+- sponsor me using one-time or monthly tier Github sponsors_ page
+- send me some pieces of bitcoin: 185KN9FCix3svJYp7JQM7hRMfSKyeaJR4X
+- buy me a gift on my wishlist_ page
+
+Any and all contributions are greatly appreciated.
+
+Authors and Contributors 🔥
+===========================
+
+Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>
+
+.. image:: https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40nicolargo
+    :target: https://twitter.com/nicolargo
+
+License 📜
+==========
+
+Glances is distributed under the LGPL version 3 license. See ``COPYING`` for more details.
+
+.. _psutil: https://github.com/giampaolo/psutil
+.. _readthedocs: https://glances.readthedocs.io/
+.. _forum: https://www.reddit.com/r/glances/
+.. _sponsors: https://github.com/sponsors/nicolargo
+.. _wishlist: https://www.amazon.fr/hz/wishlist/ls/BWAAQKWFR3FI?ref_=wl_share
+.. _PythonApi: https://glances.readthedocs.io/en/develop/api/python.html
+.. _RestfulApi: https://glances.readthedocs.io/en/develop/api/restful.html
+.. _FAQ: https://github.com/nicolargo/glances/blob/develop/docs/faq.rst
+.. _Discussions: https://github.com/nicolargo/glances/discussions

README.rst

@@ -1,112 +1,307 @@
-===============================
-Glances - An eye on your system
-===============================
+.. raw:: html
 
+   <div align="center">
 
-.. image:: https://img.shields.io/pypi/v/glances.svg
+.. image:: ./docs/_static/glances-responsive-webdesign.png
+
+.. raw:: html
+
+   <h1>Glances</h1>
+
+An Eye on your System
+
+|  |pypi| |test| |contributors| |quality|
+|  |starts| |docker| |pypistat| |sponsors|
+|  |reddit|
+
+.. |pypi| image:: https://img.shields.io/pypi/v/glances.svg
     :target: https://pypi.python.org/pypi/Glances
-.. image:: https://img.shields.io/pypi/dm/glances.svg
-    :target: https://pypi.python.org/pypi/glances#downloads
-    :alt: Downloads this month
-.. image:: https://img.shields.io/github/stars/nicolargo/glances.svg
+
+.. |starts| image:: https://img.shields.io/github/stars/nicolargo/glances.svg
     :target: https://github.com/nicolargo/glances/
     :alt: Github stars
-.. image:: https://travis-ci.org/nicolargo/glances.svg?branch=master
-    :target: https://travis-ci.org/nicolargo/glances
-.. image:: https://circleci.com/gh/nicolargo/glances/tree/develop.svg?style=svg
-    :target: https://circleci.com/gh/nicolargo/glances/tree/develop
-.. image:: https://img.shields.io/scrutinizer/g/nicolargo/glances.svg
-    :target: https://scrutinizer-ci.com/g/nicolargo/glances/
-.. image:: https://api.flattr.com/button/flattr-badge-large.png
-    :target: https://flattr.com/thing/484466/nicolargoglances-on-GitHub
 
-Follow Glances on Twitter: `@nicolargo`_ or `@glances_system`_
+.. |docker| image:: https://img.shields.io/docker/pulls/nicolargo/glances
+    :target: https://hub.docker.com/r/nicolargo/glances/
+    :alt: Docker pull
 
-**Glances** is a cross-platform curses-based system monitoring tool
-written in Python.
+.. |pypistat| image:: https://pepy.tech/badge/glances/month
+    :target: https://pepy.tech/project/glances
+    :alt: Pypi downloads
 
-.. image:: https://raw.githubusercontent.com/nicolargo/glances/master/docs/_static/screenshot-wide.png
+.. |test| image:: https://github.com/nicolargo/glances/actions/workflows/ci.yml/badge.svg?branch=develop
+    :target: https://github.com/nicolargo/glances/actions
+    :alt: Linux tests (GitHub Actions)
 
-Requirements
-============
+.. |contributors| image:: https://img.shields.io/github/contributors/nicolargo/glances
+    :target: https://github.com/nicolargo/glances/issues?q=is%3Aissue+is%3Aopen+label%3A%22needs+contributor%22
+    :alt: Contributors
 
-- ``python >= 2.6`` or ``>= 3.3`` (tested with version 2.6, 2.7, 3.3, 3.4, 3.5)
-- ``psutil >= 2.0.0``
-- ``setuptools``
+.. |quality| image:: https://scrutinizer-ci.com/g/nicolargo/glances/badges/quality-score.png?b=develop
+    :target: https://scrutinizer-ci.com/g/nicolargo/glances/?branch=develop
+    :alt: Code quality
 
-Optional dependencies:
+.. |sponsors| image:: https://img.shields.io/github/sponsors/nicolargo
+    :target: https://github.com/sponsors/nicolargo
+    :alt: Sponsors
 
-- ``bottle`` (for Web server mode)
-- ``py3sensors`` (for hardware monitoring support) [Linux-only]
-- ``hddtemp`` (for HDD temperature monitoring support) [Linux-only]
-- ``batinfo`` (for battery monitoring support) [Linux-only]
-- ``pymdstat`` (for RAID support) [Linux-only]
-- ``pysnmp`` (for SNMP support)
-- ``zeroconf`` (for the autodiscover mode)
-- ``netifaces`` (for the IP plugin)
-- ``influxdb`` (for the InfluxDB export module)
-- ``statsd`` (for the StatsD export module)
-- ``pystache`` (for the action script feature)
-- ``docker-py`` (for the Docker monitoring support) [Linux-only]
-- ``matplotlib`` (for graphical/chart support)
-- ``pika`` (for the RabbitMQ/ActiveMQ export module)
-- ``bernhard`` (for the Riemann export module)
-- ``py-cpuinfo`` (for the Quicklook CPU info module)
-- ``scandir`` (for the Folders plugin) [Only for Python < 3.5]
+.. |twitter| image:: https://img.shields.io/badge/X-000000?style=for-the-badge&logo=x&logoColor=white
+    :target: https://twitter.com/nicolargo
+    :alt: @nicolargo
 
-Installation
-============
+.. |reddit| image:: https://img.shields.io/badge/Reddit-FF4500?style=for-the-badge&logo=reddit&logoColor=white
+    :target: https://www.reddit.com/r/glances/
+    :alt: @reddit
 
-Several method to test/install Glances on your system. Choose your weapon !
+.. raw:: html
 
-Glances Auto Install script: the total way
-------------------------------------------
+   </div>
 
-To install both dependencies and latest Glances production ready version
-(aka *master* branch), just enter the following command line:
+Summary 🌟
+==========
+
+**Glances** is an open-source system cross-platform monitoring tool.
+It allows real-time monitoring of various aspects of your system such as
+CPU, memory, disk, network usage etc. It also allows monitoring of running processes,
+logged in users, temperatures, voltages, fan speeds etc.
+It also supports container monitoring, it supports different container management
+systems such as Docker, LXC. The information is presented in an easy to read dashboard
+and can also be used for remote monitoring of systems via a web interface or command
+line interface. It is easy to install and use and can be customized to show only
+the information that you are interested in.
+
+In client/server mode, remote monitoring could be done via terminal,
+Web interface or API (XML-RPC and RESTful).
+Stats can also be exported to files or external time/value databases, CSV or direct
+output to STDOUT.
+
+Glances is written in Python and uses libraries to grab information from
+your system. It is based on an open architecture where developers can
+add new plugins or exports modules.
+
+Usage 👋
+========
+
+For the standalone mode, just run:
 
 .. code-block:: console
 
-    curl -L https://bit.ly/glances | /bin/bash
+    $ glances
 
-or
+.. image:: ./docs/_static/glances-summary.png
+
+For the Web server mode, run:
 
 .. code-block:: console
 
-    wget -O- https://bit.ly/glances | /bin/bash
+    $ glances -w
 
-*Note*: Only supported on some GNU/Linux distributions. If you want to
-support other distributions, please contribute to `glancesautoinstall`_.
+and enter the URL ``http://<ip>:61208`` in your favorite web browser.
 
-PyPI: The simple way
---------------------
+In this mode, a HTTP/Restful API is exposed, see document `RestfulApi`_ for more details.
 
-Glances is on ``PyPI``. By using PyPI, you are sure to have the latest
-stable version.
+.. image:: ./docs/_static/screenshot-web.png
 
-To install, simply use ``pip``:
+For the client/server mode (remote monitoring through XML-RPC), run the following command on the server:
 
 .. code-block:: console
 
+    $ glances -s
+
+and this one on the client:
+
+.. code-block:: console
+
+    $ glances -c <ip>
+
+You can also detect and display all Glances servers available on your
+network (or defined in the configuration file) in TUI:
+
+.. code-block:: console
+
+    $ glances --browser
+
+or WebUI:
+
+.. code-block:: console
+
+    $ glances -w --browser
+
+It possible to display raw stats on stdout:
+
+.. code-block:: console
+
+    $ glances --stdout cpu.user,mem.used,load
+    cpu.user: 30.7
+    mem.used: 3278204928
+    load: {'cpucore': 4, 'min1': 0.21, 'min5': 0.4, 'min15': 0.27}
+    cpu.user: 3.4
+    mem.used: 3275251712
+    load: {'cpucore': 4, 'min1': 0.19, 'min5': 0.39, 'min15': 0.27}
+    ...
+
+or in a CSV format thanks to the stdout-csv option:
+
+.. code-block:: console
+
+    $ glances --stdout-csv now,cpu.user,mem.used,load
+    now,cpu.user,mem.used,load.cpucore,load.min1,load.min5,load.min15
+    2018-12-08 22:04:20 CEST,7.3,5948149760,4,1.04,0.99,1.04
+    2018-12-08 22:04:23 CEST,5.4,5949136896,4,1.04,0.99,1.04
+    ...
+
+or in a JSON format thanks to the stdout-json option (attribute not supported in this mode in order to have a real JSON object in output):
+
+.. code-block:: console
+
+    $ glances --stdout-json cpu,mem
+    cpu: {"total": 29.0, "user": 24.7, "nice": 0.0, "system": 3.8, "idle": 71.4, "iowait": 0.0, "irq": 0.0, "softirq": 0.0, "steal": 0.0, "guest": 0.0, "guest_nice": 0.0, "time_since_update": 1, "cpucore": 4, "ctx_switches": 0, "interrupts": 0, "soft_interrupts": 0, "syscalls": 0}
+    mem: {"total": 7837949952, "available": 2919079936, "percent": 62.8, "used": 4918870016, "free": 2919079936, "active": 2841214976, "inactive": 3340550144, "buffers": 546799616, "cached": 3068141568, "shared": 788156416}
+    ...
+
+Last but not least, you can use the fetch mode to get a quick look of a machine:
+
+.. code-block:: console
+
+    $ glances --fetch
+
+Results look like this:
+
+.. image:: ./docs/_static/screenshot-fetch.png
+
+Use Glances as a Python library 📚
+==================================
+
+You can access the Glances API by importing the `glances.api` module and creating an
+instance of the `GlancesAPI` class. This instance provides access to all Glances plugins
+and their fields. For example, to access the CPU plugin and its total field, you can
+use the following code:
+
+.. code-block:: python
+
+    >>> from glances import api
+    >>> gl = api.GlancesAPI()
+    >>> gl.cpu
+    {'cpucore': 16,
+     'ctx_switches': 1214157811,
+     'guest': 0.0,
+     'idle': 91.4,
+     'interrupts': 991768733,
+     'iowait': 0.3,
+     'irq': 0.0,
+     'nice': 0.0,
+     'soft_interrupts': 423297898,
+     'steal': 0.0,
+     'syscalls': 0,
+     'system': 5.4,
+     'total': 7.3,
+     'user': 3.0}
+    >>> gl.cpu.get("total")
+    7.3
+    >>> gl.mem.get("used")
+    12498582144
+    >>> gl.auto_unit(gl.mem.get("used"))
+    11.6G
+
+If the stats return a list of items (like network interfaces or processes), you can
+access them by their name:
+
+.. code-block:: python
+
+    >>> gl.network.keys()
+    ['wlp0s20f3', 'veth33b370c', 'veth19c7711']
+    >>> gl.network.get("wlp0s20f3")
+    {'alias': None,
+     'bytes_all': 362,
+     'bytes_all_gauge': 9242285709,
+     'bytes_all_rate_per_sec': 1032.0,
+     'bytes_recv': 210,
+     'bytes_recv_gauge': 7420522678,
+     'bytes_recv_rate_per_sec': 599.0,
+     'bytes_sent': 152,
+     'bytes_sent_gauge': 1821763031,
+     'bytes_sent_rate_per_sec': 433.0,
+     'interface_name': 'wlp0s20f3',
+     'key': 'interface_name',
+     'speed': 0,
+     'time_since_update': 0.3504955768585205}
+
+For a complete example of how to use Glances as a library, have a look to the `PythonApi`_.
+
+Documentation 📜
+================
+
+For complete documentation have a look at the readthedocs_ website.
+
+If you have any question (after RTFM! and the `FAQ`_), please post it on the official Reddit `forum`_ or in GitHub `Discussions`_.
+
+Gateway to other services 🌐
+============================
+
+Glances can export stats to:
+
+- files: ``CSV`` and ``JSON``
+- databases:  ``InfluxDB``, ``ElasticSearch``, ``PostgreSQL/TimeScale``, ``Cassandra``, ``CouchDB``, ``OpenTSDB``, ``Prometheus``, ``StatsD``, ``Riemann`` and ``Graphite``
+- brokers: ``RabbitMQ/ActiveMQ``, ``NATS``, ``ZeroMQ`` and ``Kafka``
+- others: ``RESTful`` endpoint
+
+Installation 🚀
+===============
+
+There are several methods to test/install Glances on your system. Choose your weapon!
+
+PyPI: Pip, the standard way
+---------------------------
+
+Glances is on ``PyPI``. By using PyPI, you will be using the latest stable version.
+
+To install Glances, simply use the ``pip`` command line in an virtual environment.
+
+.. code-block:: console
+
+    cd ~
+    python3 -m venv ~/.venv
+    source ~/.venv/bin/activate
     pip install glances
 
-*Note*: Python headers are required to install `psutil`_. For example,
-on Debian/Ubuntu you need to install first the *python-dev* package.
-For Fedora/CentOS/RHEL install first *python-devel* package.
+*Note*: Python headers are required to install `psutil`_, a Glances
+dependency. For example, on Debian/Ubuntu **the simplest** is
+``apt install python3-psutil`` or alternatively need to install first
+the *python-dev* package and gcc (*python-devel* on Fedora/CentOS/RHEL).
+For Windows, just install psutil from the binary installation file.
 
-You can also install the following libraries in order to use optional
-features (like the Web interface):
+By default, Glances is installed **without** the Web interface dependencies.
+
+To install it, use the following command:
 
 .. code-block:: console
 
-    pip install bottle batinfo https://bitbucket.org/gleb_zhulik/py3sensors/get/tip.tar.gz zeroconf netifaces pymdstat influxdb potsdb statsd pystache docker-py pysnmp pika py-cpuinfo scandir
+    pip install 'glances[web]'
 
-Install or upgrade Glances from the Git ``develop`` repository:
+For a full installation (with all features, see features list bellow):
 
 .. code-block:: console
 
-    git clone -b develop https://github.com/nicolargo/glances.git
+    pip install 'glances[all]'
 
+Features list:
+
+- all: install dependencies for all features
+- action: install dependencies for action feature
+- browser: install dependencies for Glances centram browser
+- cloud: install dependencies for cloud plugin
+- containers: install dependencies for container plugin
+- export: install dependencies for all exports modules
+- gpu: install dependencies for GPU plugin
+- graph: install dependencies for graph export
+- ip: install dependencies for IP public option
+- raid: install dependencies for RAID plugin
+- sensors: install dependencies for sensors plugin
+- smart: install dependencies for smart plugin
+- snmp: install dependencies for SNMP
+- sparklines: install dependencies for sparklines option
+- web: install dependencies for Webserver (WebUI) and Web API
+- wifi: install dependencies for Wifi plugin
 
 To upgrade Glances to the latest version:
 
@@ -114,74 +309,156 @@ To upgrade Glances to the latest version:
 
     pip install --upgrade glances
 
-If you need to install Glances in a specific user location, use:
+PyPI: PipX, the alternative way
+-------------------------------
+
+Install PipX on your system. For example on Ubuntu/Debian:
 
 .. code-block:: console
 
-    export PYTHONUSERBASE=~/mylocalpath
-    pip install --user glances
+    sudo apt install pipx
 
-Docker: the funny way
----------------------
-
-A Glances container is available. It will include the latest development HEAD version. You can use it to monitor your server and all your others containers !
-
-Get the Glances container:
+Then install Glances (with all features):
 
 .. code-block:: console
 
-    docker pull nicolargo/glances
+    pipx install 'glances[all]'
 
-Run the container in console mode:
+The glances script will be installed in the ~/.local/bin folder.
+
+To upgrade Glances to the latest version:
 
 .. code-block:: console
 
-    docker run -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host -it docker.io/nicolargo/glances
+    pipx upgrade glances
 
+Docker: the cloudy way
+----------------------
 
-GNU/Linux
----------
+Glances Docker images are available. You can use it to monitor your
+server and all your containers !
 
-At the moment, packages exist for the following GNU/Linux distributions:
+The following tags are available:
 
-- Arch Linux
-- Debian
-- Fedora/CentOS/RHEL
-- Gentoo
-- Slackware (SlackBuild)
-- Ubuntu
-- Void Linux
+- *latest-full* for a full Alpine Glances image (latest release) with all dependencies
+- *latest* for a basic Alpine Glances (latest release) version with minimal dependencies (FastAPI and Docker)
+- *dev* for a basic Alpine Glances image (based on development branch) with all dependencies (Warning: may be instable)
+- *ubuntu-latest-full* for a full Ubuntu Glances image (latest release) with all dependencies
+- *ubuntu-latest* for a basic Ubuntu Glances (latest release) version with minimal dependencies (FastAPI and Docker)
+- *ubuntu-dev* for a basic Ubuntu Glances image (based on development branch) with all dependencies (Warning: may be instable)
 
-So you should be able to install it using your favorite package manager.
+Run last version of Glances container in *console mode*:
+
+.. code-block:: console
+
+    docker run --rm -e TZ="${TZ}" -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host --network host -it nicolargo/glances:latest-full
+
+By default, the /etc/glances/glances.conf file is used (based on docker-compose/glances.conf).
+
+Additionally, if you want to use your own glances.conf file, you can
+create your own Dockerfile:
+
+.. code-block:: console
+
+    FROM nicolargo/glances:latest
+    COPY glances.conf /root/.config/glances/glances.conf
+    CMD python -m glances -C /root/.config/glances/glances.conf $GLANCES_OPT
+
+Alternatively, you can specify something along the same lines with
+docker run options (notice the `GLANCES_OPT` environment
+variable setting parameters for the glances startup command):
+
+.. code-block:: console
+
+    docker run -e TZ="${TZ}" -v $HOME/.config/glances/glances.conf:/glances.conf:ro -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host -e GLANCES_OPT="-C /glances.conf" -it nicolargo/glances:latest-full
+
+Where $HOME/.config/glances/glances.conf is a local directory containing your glances.conf file.
+
+Run the container in *Web server mode*:
+
+.. code-block:: console
+
+    docker run -d --restart="always" -p 61208-61209:61208-61209 -e TZ="${TZ}" -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host nicolargo/glances:latest-full
+
+For a full list of options, see the Glances `Docker`_ documentation page.
+
+It is also possible to use a simple Docker compose file (see in ./docker-compose/docker-compose.yml):
+
+.. code-block:: console
+
+    cd ./docker-compose
+    docker-compose up
+
+It will start a Glances server with WebUI.
+
+Brew: The missing package manager
+---------------------------------
+
+For Linux and Mac OS, it is also possible to install Glances with `Brew`_:
+
+.. code-block:: console
+
+    brew install glances
+
+GNU/Linux package
+-----------------
+
+`Glances` is available on many Linux distributions, so you should be
+able to install it using your favorite package manager. Nevetheless,
+i do not recommend it. Be aware that when you use this method the operating
+system `package`_ for `Glances`may not be the latest version and only basics
+plugins are enabled.
+
+Note: The Debian package (and all other Debian-based distributions) do
+not include anymore the JS statics files used by the Web interface
+(see ``issue2021``). If you want to add it to your Glances installation,
+follow the instructions: ``issue2021comment``. In Glances version 4 and
+higher, the path to the statics file is configurable (see ``issue2612``).
 
 FreeBSD
 -------
 
-To install the binary package:
+On FreeBSD, package name depends on the Python version.
+
+Check for Python version:
 
 .. code-block:: console
 
-    # pkg install py27-glances
+     # python --version
 
-To install Glances from ports:
+Install the Glances package:
+
+.. code-block:: console
+
+    # pkg install pyXY-glances
+
+Where X and Y are the Major and Minor Values of your Python System.
+
+.. code-block:: console
+
+    # Example for Python 3.11.3: pkg install py311-glances
+
+**NOTE:** Check Glances Binary Package Version for your System Architecture.
+You must have the Correct Python Version Installed which corresponds to the Glances Binary Package.
+
+To install Glances from Ports:
 
 .. code-block:: console
 
     # cd /usr/ports/sysutils/py-glances/
     # make install clean
 
-OS X
-----
+macOS
+-----
 
-OS X users can install Glances using ``Homebrew`` or ``MacPorts``.
+MacOS users can install Glances using ``Homebrew`` or ``MacPorts``.
 
 Homebrew
 ````````
 
 .. code-block:: console
 
-    $ brew install python
-    $ pip install glances
+    $ brew install glances
 
 MacPorts
 ````````
@@ -193,13 +470,34 @@ MacPorts
 Windows
 -------
 
-Install `Python`_ for Windows (Python 2.7.9+ and 3.4+ ship with pip) and
-then just:
+Install `Python`_ for Windows (Python 3.4+ ship with pip) and
+follow the Glances Pip install procedure.
+
+Android
+-------
+
+You need a rooted device and the `Termux`_ application (available on the
+Google Play Store).
+
+Start Termux on your device and enter:
 
 .. code-block:: console
 
+    $ apt update
+    $ apt upgrade
+    $ apt install clang python
+    $ pip install fastapi uvicorn jinja2
     $ pip install glances
 
+And start Glances:
+
+.. code-block:: console
+
+    $ glances
+
+You can also run Glances in server mode (-s or -w) in order to remotely
+monitor your Android device.
+
 Source
 ------
 
@@ -207,98 +505,97 @@ To install Glances from source:
 
 .. code-block:: console
 
-    $ wget https://github.com/nicolargo/glances/archive/vX.Y.tar.gz -O - | tar xz
-    $ cd glances-*
-    # python setup.py install
+    $ pip install https://github.com/nicolargo/glances/archive/vX.Y.tar.gz
 
-*Note*: Python headers are required to install psutil. For example,
-on Debian/Ubuntu you need to install first the *python-dev* package.
+*Note*: Python headers are required to install psutil.
 
 Chef
 ----
 
-An awesome ``Chef`` cookbook is available to monitor your infrastructure: https://supermarket.chef.io/cookbooks/glances (thanks to Antoine Rouyer)
+An awesome ``Chef`` cookbook is available to monitor your infrastructure:
+https://supermarket.chef.io/cookbooks/glances (thanks to Antoine Rouyer)
 
 Puppet
 ------
 
 You can install Glances using ``Puppet``: https://github.com/rverchere/puppet-glances
 
-Known issue on RHEL/CentOS/Fedora installation
-==============================================
+Ansible
+-------
 
-For Python 2.6 RedHat-based distros there might be an issue with starting Glances:
+A Glances ``Ansible`` role is available: https://galaxy.ansible.com/zaxos/glances-ansible-role/
 
-    Traceback (most recent call last):
-    File "/usr/bin/glances", line 5, in <module>
-    from pkg_resources import load_entry_point
-    File "/usr/lib/python2.6/site-packages/pkg_resources.py", line 2655, in <module>
-    workingset.require(_requires)
-    File "/usr/lib/python2.6/site-packages/pkg_resources.py", line 648, in require
-    needed = self.resolve(parse_requirements(requirements))
-    File "/usr/lib/python2.6/site-packages/pkg_resources.py", line 546, in resolve
-    raise DistributionNotFound(req)
-    pkg_resources.DistributionNotFound: argparse
+Shell tab completion 🔍
+=======================
 
-Try upgrading setuptools, has been proven to solve the problem:
+Glances 4.3.2 and higher includes shell tab autocompletion thanks to the --print-completion option.
 
-    sudo pip install -U setuptools
-
-Usage
-=====
-
-For the standalone mode, just run:
+For example, on a Linux operating system with bash shell:
 
 .. code-block:: console
 
-    $ glances
+    $ mkdir -p ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion
+    $ glances --print-completion bash > ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances
+    $ source ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances
 
-For the Web server mode, run:
+Following shells are supported: bash, zsh and tcsh.
 
-.. code-block:: console
+Requirements 🧩
+===============
 
-    $ glances -w
+Glances is developed in Python. A minimal Python version 3.10 or higher
+should be installed on your system.
 
-and enter the URL ``http://<ip>:61208`` in your favorite web browser.
+*Note for Python 2 users*
 
-For the client/server mode, run:
+Glances version 4 or higher do not support Python 2 (and Python 3 < 3.10).
+Please uses Glances version 3.4.x if you need Python 2 support.
 
-.. code-block:: console
+Dependencies:
 
-    $ glances -s
+- ``psutil`` (better with latest version)
+- ``defusedxml`` (in order to monkey patch xmlrpc)
+- ``packaging`` (for the version comparison)
+- ``windows-curses`` (Windows Curses implementation) [Windows-only]
+- ``shtab`` (Shell autocompletion) [All but Windows]
+- ``jinja2`` (for fetch mode and templating)
 
-on the server side and run:
+Extra dependencies:
 
-.. code-block:: console
+- ``batinfo`` (for battery monitoring)
+- ``bernhard`` (for the Riemann export module)
+- ``cassandra-driver`` (for the Cassandra export module)
+- ``chevron`` (for the action script feature)
+- ``docker`` (for the Containers Docker monitoring support)
+- ``elasticsearch`` (for the Elastic Search export module)
+- ``FastAPI`` and ``Uvicorn`` (for Web server mode)
+- ``graphitesender`` (For the Graphite export module)
+- ``hddtemp`` (for HDD temperature monitoring support) [Linux-only]
+- ``influxdb`` (for the InfluxDB version 1 export module)
+- ``influxdb-client``  (for the InfluxDB version 2 export module)
+- ``kafka-python`` (for the Kafka export module)
+- ``nats-py`` (for the NATS export module)
+- ``nvidia-ml-py`` (for the GPU plugin)
+- ``pycouchdb`` (for the CouchDB export module)
+- ``pika`` (for the RabbitMQ/ActiveMQ export module)
+- ``podman`` (for the Containers Podman monitoring support)
+- ``potsdb`` (for the OpenTSDB export module)
+- ``prometheus_client`` (for the Prometheus export module)
+- ``psycopg[binary]`` (for the PostgreSQL/TimeScale export module)
+- ``pygal`` (for the graph export module)
+- ``pymdstat`` (for RAID support) [Linux-only]
+- ``pymongo`` (for the MongoDB export module)
+- ``pysnmp-lextudio`` (for SNMP support)
+- ``pySMART.smartx`` (for HDD Smart support) [Linux-only]
+- ``pyzmq`` (for the ZeroMQ export module)
+- ``requests`` (for the Ports, Cloud plugins and RESTful export module)
+- ``sparklines`` (for the Quick Plugin sparklines option)
+- ``statsd`` (for the StatsD export module)
+- ``wifi`` (for the wifi plugin) [Linux-only]
+- ``zeroconf`` (for the autodiscover mode)
 
-    $ glances -c <ip>
-
-on the client one.
-
-You can also detect and display all Glances servers available on your
-network or defined in the configuration file:
-
-.. code-block:: console
-
-    $ glances --browser
-
-and RTFM, always.
-
-Documentation
-=============
-
-For complete documentation have a look at the readthedocs_ website.
-
-If you have any question (after RTFM!), please post it on the official Q&A `forum`_.
-
-Gateway to other services
-=========================
-
-Glances can export stats to: ``CSV`` file, ``InfluxDB``, ``OpenTSDB``,
-``StatsD``, ``RabbitMQ`` and  ``Riemann`` server.
-
-How to contribute ?
-===================
+How to contribute ? 🤝
+======================
 
 If you want to contribute to the Glances project, read this `wiki`_ page.
 
@@ -307,21 +604,53 @@ There is also a chat dedicated to the Glances developers:
 .. image:: https://badges.gitter.im/Join%20Chat.svg
         :target: https://gitter.im/nicolargo/glances?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
 
-Author
-======
+Project sponsorship 🙌
+======================
+
+You can help me to achieve my goals of improving this open-source project
+or just say "thank you" by:
+
+- sponsor me using one-time or monthly tier Github sponsors_ page
+- send me some pieces of bitcoin: 185KN9FCix3svJYp7JQM7hRMfSKyeaJR4X
+- buy me a gift on my wishlist_ page
+
+Any and all contributions are greatly appreciated.
+
+Authors and Contributors 🔥
+===========================
 
 Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>
 
-License
-=======
+.. image:: https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40nicolargo
+    :target: https://twitter.com/nicolargo
 
-LGPL. See ``COPYING`` for more details.
+License 📜
+==========
+
+Glances is distributed under the LGPL version 3 license. See ``COPYING`` for more details.
+
+More stars ! 🌟
+===============
+
+Please give us a star on `GitHub`_ if you like this project.
+
+.. image:: https://api.star-history.com/svg?repos=nicolargo/glances&type=Date
+    :target: https://www.star-history.com/#nicolargo/glances&Date
+    :alt: Star history
 
 .. _psutil: https://github.com/giampaolo/psutil
-.. _glancesautoinstall: https://github.com/nicolargo/glancesautoinstall
-.. _@nicolargo: https://twitter.com/nicolargo
-.. _@glances_system: https://twitter.com/glances_system
+.. _Brew: https://formulae.brew.sh/formula/glances
 .. _Python: https://www.python.org/getit/
-.. _readthedocs: https://glances.readthedocs.org/
-.. _forum: https://groups.google.com/forum/?hl=en#!forum/glances-users
+.. _Termux: https://play.google.com/store/apps/details?id=com.termux
+.. _readthedocs: https://glances.readthedocs.io/
+.. _forum: https://www.reddit.com/r/glances/
 .. _wiki: https://github.com/nicolargo/glances/wiki/How-to-contribute-to-Glances-%3F
+.. _package: https://repology.org/project/glances/versions
+.. _sponsors: https://github.com/sponsors/nicolargo
+.. _wishlist: https://www.amazon.fr/hz/wishlist/ls/BWAAQKWFR3FI?ref_=wl_share
+.. _Docker: https://github.com/nicolargo/glances/blob/master/docs/docker.rst
+.. _GitHub: https://github.com/nicolargo/glances
+.. _PythonApi: https://glances.readthedocs.io/en/develop/api/python.html
+.. _RestfulApi: https://glances.readthedocs.io/en/develop/api/restful.html
+.. _FAQ: https://github.com/nicolargo/glances/blob/develop/docs/faq.rst
+.. _Discussions: https://github.com/nicolargo/glances/discussions

SECURITY.md

@@ -0,0 +1,30 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Support security updates |
+| ------- | ------------------------ |
+| 4.x     | :white_check_mark:       |
+| < 4.0   | :x:                      |
+
+## Reporting a Vulnerability
+
+If there are any vulnerabilities in {{cookiecutter.project_name}}, don't hesitate to report them.
+
+    1. Describe the vulnerability.
+
+      * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+      * Full paths of source file(s) related to the manifestation of the issue
+      * The location of the affected source code (tag/branch/commit or direct URL)
+      * Any special configuration required to reproduce the issue
+      * Step-by-step instructions to reproduce the issue
+      * Proof-of-concept or exploit code (if possible)
+      * Impact of the issue, including how an attacker might exploit the issue
+
+    2. If you have a fix, that is most welcome -- please attach or summarize it in your message!
+
+    3. We will evaluate the vulnerability and, if necessary, release a fix or mitigating steps to address it. We will contact you to let you know the outcome, and will credit you in the report.
+
+    4. Please do not disclose the vulnerability publicly until a fix is released!
+
+Once we have either a) published a fix, or b) declined to address the vulnerability for whatever reason, you are free to publicly disclose it.

all-requirements.txt

@@ -0,0 +1,237 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --no-emit-workspace --no-hashes --all-extras --no-group dev --output-file all-requirements.txt
+annotated-doc==0.0.4
+    # via fastapi
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.12.0
+    # via
+    #   elasticsearch
+    #   starlette
+batinfo==0.4.2 ; sys_platform == 'linux'
+    # via glances
+bernhard==0.2.6
+    # via glances
+cassandra-driver==3.29.3
+    # via glances
+certifi==2025.11.12
+    # via
+    #   elastic-transport
+    #   influxdb-client
+    #   influxdb3-python
+    #   requests
+cffi==2.0.0 ; implementation_name == 'pypy' or platform_python_implementation != 'PyPy'
+    # via
+    #   cryptography
+    #   pyzmq
+chardet==5.2.0
+    # via pysmart
+charset-normalizer==3.4.4
+    # via requests
+chevron==0.14.0
+    # via glances
+click==8.1.8
+    # via
+    #   geomet
+    #   uvicorn
+colorama==0.4.6 ; sys_platform == 'win32'
+    # via click
+cryptography==46.0.3
+    # via pysnmpcrypto
+defusedxml==0.7.1
+    # via glances
+dnspython==2.8.0
+    # via pymongo
+docker==7.1.0
+    # via glances
+elastic-transport==9.2.1
+    # via elasticsearch
+elasticsearch==9.2.1
+    # via glances
+exceptiongroup==1.2.2 ; python_full_version < '3.11'
+    # via anyio
+fastapi==0.128.0
+    # via glances
+geomet==1.1.0
+    # via cassandra-driver
+graphitesender==0.11.2
+    # via glances
+h11==0.16.0
+    # via uvicorn
+humanfriendly==10.0
+    # via pysmart
+ibm-cloud-sdk-core==3.24.2
+    # via ibmcloudant
+ibmcloudant==0.11.2
+    # via glances
+idna==3.11
+    # via
+    #   anyio
+    #   requests
+ifaddr==0.2.0
+    # via zeroconf
+importlib-metadata==8.7.1
+    # via pygal
+influxdb==5.3.2
+    # via glances
+influxdb-client==1.49.0
+    # via glances
+influxdb3-python==0.16.0
+    # via glances
+jinja2==3.1.6
+    # via
+    #   glances
+    #   pysmi-lextudio
+kafka-python==2.3.0
+    # via glances
+markupsafe==3.0.3
+    # via jinja2
+msgpack==1.1.2
+    # via influxdb
+nats-py==2.12.0
+    # via glances
+nvidia-ml-py==13.590.44
+    # via glances
+packaging==25.0
+    # via glances
+paho-mqtt==2.1.0
+    # via glances
+pbkdf2==1.3
+    # via wifi
+pika==1.3.2
+    # via glances
+ply==3.11
+    # via pysmi-lextudio
+podman==5.6.0
+    # via glances
+potsdb==1.0.3
+    # via glances
+prometheus-client==0.23.1
+    # via glances
+protobuf==6.33.2
+    # via bernhard
+psutil==7.2.1
+    # via glances
+psycopg==3.3.2
+    # via glances
+psycopg-binary==3.3.2 ; implementation_name != 'pypy'
+    # via psycopg
+pyarrow==22.0.0
+    # via influxdb3-python
+pyasn1==0.6.1
+    # via pysnmp-lextudio
+pycparser==2.23 ; (implementation_name != 'PyPy' and platform_python_implementation != 'PyPy') or (implementation_name == 'pypy' and platform_python_implementation == 'PyPy')
+    # via cffi
+pydantic==2.12.5
+    # via fastapi
+pydantic-core==2.41.5
+    # via pydantic
+pygal==3.1.0
+    # via glances
+pyjwt==2.10.1
+    # via
+    #   ibm-cloud-sdk-core
+    #   ibmcloudant
+pymdstat==0.4.3
+    # via glances
+pymongo==4.15.5
+    # via glances
+pyreadline3==3.5.4 ; sys_platform == 'win32'
+    # via humanfriendly
+pysmart==1.4.2
+    # via glances
+pysmi-lextudio==1.4.3
+    # via pysnmp-lextudio
+pysnmp-lextudio==6.1.2
+    # via glances
+pysnmpcrypto==0.0.4
+    # via pysnmp-lextudio
+python-dateutil==2.9.0.post0
+    # via
+    #   elasticsearch
+    #   glances
+    #   ibm-cloud-sdk-core
+    #   ibmcloudant
+    #   influxdb
+    #   influxdb-client
+    #   influxdb3-python
+pytz==2025.2
+    # via influxdb
+pywin32==311 ; sys_platform == 'win32'
+    # via docker
+pyzmq==27.1.0
+    # via glances
+reactivex==4.1.0
+    # via
+    #   influxdb-client
+    #   influxdb3-python
+requests==2.32.5
+    # via
+    #   docker
+    #   glances
+    #   ibm-cloud-sdk-core
+    #   ibmcloudant
+    #   influxdb
+    #   podman
+    #   pysmi-lextudio
+setuptools==80.9.0
+    # via
+    #   influxdb-client
+    #   wifi
+shtab==1.8.0 ; sys_platform != 'win32'
+    # via glances
+six==1.17.0
+    # via
+    #   glances
+    #   influxdb
+    #   python-dateutil
+sniffio==1.3.1
+    # via
+    #   elastic-transport
+    #   elasticsearch
+sparklines==0.7.0
+    # via glances
+starlette==0.50.0
+    # via fastapi
+statsd==4.0.1
+    # via glances
+termcolor==3.3.0
+    # via sparklines
+tomli==2.0.2 ; python_full_version < '3.11'
+    # via podman
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   cryptography
+    #   elasticsearch
+    #   fastapi
+    #   psycopg
+    #   pydantic
+    #   pydantic-core
+    #   reactivex
+    #   starlette
+    #   typing-inspection
+    #   uvicorn
+typing-inspection==0.4.2
+    # via pydantic
+tzdata==2025.3 ; sys_platform == 'win32'
+    # via psycopg
+urllib3==2.6.2
+    # via
+    #   docker
+    #   elastic-transport
+    #   ibm-cloud-sdk-core
+    #   influxdb-client
+    #   influxdb3-python
+    #   podman
+    #   requests
+uvicorn==0.40.0
+    # via glances
+wifi==0.3.8
+    # via glances
+windows-curses==2.4.1 ; sys_platform == 'win32'
+    # via glances
+zeroconf==0.148.0
+    # via glances
+zipp==3.23.0
+    # via importlib-metadata

conf/fetch-templates/short.jinja

@@ -0,0 +1,9 @@
+✨ {{ gl.system['hostname'] }}{{ ' - ' + gl.ip['address'] if gl.ip['address'] else '' }}
+⚙️  {{ gl.system['hr_name'] }} | Uptime: {{ gl.uptime }}
+
+💡 LOAD     {{ '%0.2f'| format(gl.load['min1']) }} {{ '%0.2f'| format(gl.load['min5']) }} {{ '%0.2f'| format(gl.load['min15']) }}
+⚡ CPU      {{ gl.bar(gl.cpu['total']) }} {{ gl.cpu['total'] }}% of {{ gl.core['log'] }} cores
+🧠 MEM      {{ gl.bar(gl.mem['percent']) }} {{ gl.mem['percent'] }}% ({{ gl.auto_unit(gl.mem['used']) }} {{ gl.auto_unit(gl.mem['total']) }})
+{% for fs in gl.fs.keys() %}💾 {% if loop.index == 1 %}DISK{% else %}    {% endif %}     {{ gl.bar(gl.fs[fs]['percent']) }} {{ gl.fs[fs]['percent'] }}% ({{ gl.auto_unit(gl.fs[fs]['used']) }} {{ gl.auto_unit(gl.fs[fs]['size']) }}) for {{ fs }}
+{% endfor %}{% for net in gl.network.keys() %}📡 {% if loop.index == 1 %}NET{% else %}   {% endif %}      ↓ {{ gl.auto_unit(gl.network[net]['bytes_recv_rate_per_sec']) }}b/s  ↑ {{ gl.auto_unit(gl.network[net]['bytes_sent_rate_per_sec']) }}b/s for {{ net }}
+{% endfor %}

conf/fetch-templates/with-logo.jinja

@@ -0,0 +1,23 @@
+                      _____ _
+                     / ____| |
+                    | |  __| | __ _ _ __   ___ ___  ___
+                    | | |_ | |/ _` | '_ \ / __/ _ \/ __|
+                    | |__| | | (_| | | | | (_|  __/\__
+                     \_____|_|\__,_|_| |_|\___\___||___/
+
+
+✨ {{ gl.system['hostname'] }}{{ ' - ' + gl.ip['address'] if gl.ip['address'] else '' }}
+⚙️  {{ gl.system['hr_name'] }} | Uptime: {{ gl.uptime }}
+
+💡 LOAD     {{ '%0.2f'| format(gl.load['min1']) }} {{ '%0.2f'| format(gl.load['min5']) }} {{ '%0.2f'| format(gl.load['min15']) }}
+⚡ CPU      {{ gl.bar(gl.cpu['total']) }} {{ gl.cpu['total'] }}% of {{ gl.core['log'] }} cores
+🧠 MEM      {{ gl.bar(gl.mem['percent']) }} {{ gl.mem['percent'] }}% ({{ gl.auto_unit(gl.mem['used']) }} {{ gl.auto_unit(gl.mem['total']) }})
+{% for fs in gl.fs.keys() %}💾 {% if loop.index == 1 %}DISK{% else %}    {% endif %}     {{ gl.bar(gl.fs[fs]['percent']) }} {{ gl.fs[fs]['percent'] }}% ({{ gl.auto_unit(gl.fs[fs]['used']) }} {{ gl.auto_unit(gl.fs[fs]['size']) }}) for {{ fs }}
+{% endfor %}{% for net in gl.network.keys() %}📡 {% if loop.index == 1 %}NET{% else %}   {% endif %}      ↓ {{ gl.auto_unit(gl.network[net]['bytes_recv_rate_per_sec']) }}b/s  ↑ {{ gl.auto_unit(gl.network[net]['bytes_sent_rate_per_sec']) }}b/s for {{ net }}
+{% endfor %}
+🔥 TOP PROCESS by CPU
+{% for process in gl.top_process() %}{{ loop.index }}️⃣ {{ process['name'][:20] }}{{ ' ' * (20 - process['name'][:20] | length) }}    ⚡ {{ process['cpu_percent'] }}% CPU{{ ' ' * (8 - (gl.auto_unit(process['cpu_percent']) | length)) }}    🧠 {{ gl.auto_unit(process['memory_info']['rss']) }}B MEM
+{% endfor %}
+🔥 TOP PROCESS by MEM
+{% for process in gl.top_process(sorted_by='memory_percent', sorted_by_secondary='cpu_percent') %}{{ loop.index }}️⃣ {{ process['name'][:20] }}{{ ' ' * (20 - process['name'][:20] | length) }}    🧠 {{ gl.auto_unit(process['memory_info']['rss']) }}B MEM{{ ' ' * (7 - (gl.auto_unit(process['memory_info']['rss']) | length)) }}    ⚡ {{ process['cpu_percent'] }}% CPU
+{% endfor %}

dev-requirements.txt

@@ -0,0 +1,395 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --no-hashes --only-dev --output-file dev-requirements.txt
+alabaster==1.0.0
+    # via sphinx
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.12.0
+    # via
+    #   httpx
+    #   mcp
+    #   sse-starlette
+    #   starlette
+attrs==25.4.0
+    # via
+    #   glom
+    #   jsonschema
+    #   outcome
+    #   referencing
+    #   reuse
+    #   semgrep
+    #   trio
+babel==2.17.0
+    # via sphinx
+boltons==21.0.0
+    # via
+    #   face
+    #   glom
+    #   semgrep
+boolean-py==5.0
+    # via license-expression
+bracex==2.6
+    # via wcmatch
+certifi==2025.11.12
+    # via
+    #   httpcore
+    #   httpx
+    #   requests
+    #   selenium
+cffi==2.0.0 ; (implementation_name != 'pypy' and os_name == 'nt') or platform_python_implementation != 'PyPy'
+    # via
+    #   cryptography
+    #   trio
+cfgv==3.5.0
+    # via pre-commit
+charset-normalizer==3.4.4
+    # via
+    #   python-debian
+    #   requests
+click==8.1.8
+    # via
+    #   click-option-group
+    #   reuse
+    #   semgrep
+    #   typer
+    #   uvicorn
+click-option-group==0.5.9
+    # via semgrep
+codespell==2.4.1
+colorama==0.4.6
+    # via
+    #   click
+    #   pytest
+    #   semgrep
+    #   sphinx
+contourpy==1.3.2 ; python_full_version < '3.11'
+    # via matplotlib
+contourpy==1.3.3 ; python_full_version >= '3.11'
+    # via matplotlib
+cryptography==46.0.3
+    # via pyjwt
+cycler==0.12.1
+    # via matplotlib
+distlib==0.4.0
+    # via virtualenv
+docutils==0.21.2
+    # via
+    #   rstcheck-core
+    #   sphinx
+    #   sphinx-rtd-theme
+exceptiongroup==1.2.2
+    # via
+    #   anyio
+    #   pytest
+    #   semgrep
+    #   trio
+    #   trio-websocket
+face==24.0.0
+    # via glom
+filelock==3.20.2
+    # via virtualenv
+fonttools==4.61.1
+    # via matplotlib
+glom==22.1.0
+    # via semgrep
+googleapis-common-protos==1.72.0
+    # via opentelemetry-exporter-otlp-proto-http
+gprof2dot==2025.4.14
+h11==0.16.0
+    # via
+    #   httpcore
+    #   uvicorn
+    #   wsproto
+httpcore==1.0.9
+    # via httpx
+httpx==0.28.1
+    # via mcp
+httpx-sse==0.4.3
+    # via mcp
+identify==2.6.15
+    # via pre-commit
+idna==3.11
+    # via
+    #   anyio
+    #   httpx
+    #   requests
+    #   trio
+imagesize==1.4.1
+    # via sphinx
+importlib-metadata==8.7.1
+    # via opentelemetry-api
+iniconfig==2.3.0
+    # via pytest
+jinja2==3.1.6
+    # via
+    #   reuse
+    #   sphinx
+jsonschema==4.25.1
+    # via
+    #   mcp
+    #   semgrep
+jsonschema-specifications==2025.9.1
+    # via jsonschema
+kiwisolver==1.4.9
+    # via matplotlib
+license-expression==30.4.4
+    # via reuse
+markdown-it-py==4.0.0
+    # via rich
+markupsafe==3.0.3
+    # via jinja2
+matplotlib==3.10.8
+mcp==1.23.3
+    # via semgrep
+mdurl==0.1.2
+    # via markdown-it-py
+memory-profiler==0.61.0
+nodeenv==1.10.0
+    # via
+    #   pre-commit
+    #   pyright
+numpy==2.2.6 ; python_full_version < '3.11'
+    # via
+    #   contourpy
+    #   matplotlib
+numpy==2.4.0 ; python_full_version >= '3.11'
+    # via
+    #   contourpy
+    #   matplotlib
+opentelemetry-api==1.37.0
+    # via
+    #   opentelemetry-exporter-otlp-proto-http
+    #   opentelemetry-instrumentation
+    #   opentelemetry-instrumentation-requests
+    #   opentelemetry-sdk
+    #   opentelemetry-semantic-conventions
+    #   semgrep
+opentelemetry-exporter-otlp-proto-common==1.37.0
+    # via opentelemetry-exporter-otlp-proto-http
+opentelemetry-exporter-otlp-proto-http==1.37.0
+    # via semgrep
+opentelemetry-instrumentation==0.58b0
+    # via opentelemetry-instrumentation-requests
+opentelemetry-instrumentation-requests==0.58b0
+    # via semgrep
+opentelemetry-proto==1.37.0
+    # via
+    #   opentelemetry-exporter-otlp-proto-common
+    #   opentelemetry-exporter-otlp-proto-http
+opentelemetry-sdk==1.37.0
+    # via
+    #   opentelemetry-exporter-otlp-proto-http
+    #   semgrep
+opentelemetry-semantic-conventions==0.58b0
+    # via
+    #   opentelemetry-instrumentation
+    #   opentelemetry-instrumentation-requests
+    #   opentelemetry-sdk
+opentelemetry-util-http==0.58b0
+    # via opentelemetry-instrumentation-requests
+outcome==1.3.0.post0
+    # via
+    #   trio
+    #   trio-websocket
+packaging==25.0
+    # via
+    #   matplotlib
+    #   opentelemetry-instrumentation
+    #   pytest
+    #   requirements-parser
+    #   semgrep
+    #   sphinx
+    #   webdriver-manager
+peewee==3.18.3
+    # via semgrep
+pillow==12.1.0
+    # via matplotlib
+platformdirs==4.5.1
+    # via virtualenv
+pluggy==1.6.0
+    # via pytest
+pre-commit==4.5.1
+protobuf==6.33.2
+    # via
+    #   googleapis-common-protos
+    #   opentelemetry-proto
+psutil==7.2.1
+    # via memory-profiler
+py-spy==0.4.1
+pycparser==2.23 ; (implementation_name != 'PyPy' and implementation_name != 'pypy' and os_name == 'nt') or (implementation_name != 'PyPy' and platform_python_implementation != 'PyPy')
+    # via cffi
+pydantic==2.12.5
+    # via
+    #   mcp
+    #   pydantic-settings
+    #   rstcheck-core
+pydantic-core==2.41.5
+    # via pydantic
+pydantic-settings==2.12.0
+    # via mcp
+pygments==2.19.2
+    # via
+    #   pytest
+    #   rich
+    #   sphinx
+pyinstrument==5.1.1
+pyjwt==2.10.1
+    # via mcp
+pyparsing==3.3.1
+    # via matplotlib
+pyright==1.1.407
+pysocks==1.7.1
+    # via urllib3
+pytest==9.0.2
+python-dateutil==2.9.0.post0
+    # via matplotlib
+python-debian==1.0.1
+    # via reuse
+python-dotenv==1.2.1
+    # via
+    #   pydantic-settings
+    #   webdriver-manager
+python-magic==0.4.27
+    # via reuse
+python-multipart==0.0.21
+    # via mcp
+pywin32==311 ; sys_platform == 'win32'
+    # via
+    #   mcp
+    #   semgrep
+pyyaml==6.0.3
+    # via pre-commit
+referencing==0.37.0
+    # via
+    #   jsonschema
+    #   jsonschema-specifications
+requests==2.32.5
+    # via
+    #   opentelemetry-exporter-otlp-proto-http
+    #   semgrep
+    #   sphinx
+    #   webdriver-manager
+requirements-parser==0.13.0
+reuse==6.2.0
+rich==13.5.3
+    # via
+    #   semgrep
+    #   typer
+roman-numerals==4.1.0 ; python_full_version >= '3.11'
+    # via roman-numerals-py
+roman-numerals-py==4.1.0 ; python_full_version >= '3.11'
+    # via sphinx
+rpds-py==0.30.0
+    # via
+    #   jsonschema
+    #   referencing
+rstcheck==6.2.5
+rstcheck-core==1.2.2
+    # via rstcheck
+ruamel-yaml==0.19.1
+    # via semgrep
+ruamel-yaml-clib==0.2.14
+    # via semgrep
+ruff==0.14.10
+selenium==4.39.0
+semgrep==1.146.0
+setuptools==80.9.0
+shellingham==1.5.4
+    # via typer
+six==1.17.0
+    # via python-dateutil
+sniffio==1.3.1
+    # via trio
+snowballstemmer==3.0.1
+    # via sphinx
+sortedcontainers==2.4.0
+    # via trio
+sphinx==8.1.3 ; python_full_version < '3.11'
+    # via
+    #   sphinx-rtd-theme
+    #   sphinxcontrib-jquery
+sphinx==8.2.3 ; python_full_version >= '3.11'
+    # via
+    #   sphinx-rtd-theme
+    #   sphinxcontrib-jquery
+sphinx-rtd-theme==3.0.2
+sphinxcontrib-applehelp==2.0.0
+    # via sphinx
+sphinxcontrib-devhelp==2.0.0
+    # via sphinx
+sphinxcontrib-htmlhelp==2.1.0
+    # via sphinx
+sphinxcontrib-jquery==4.1
+    # via sphinx-rtd-theme
+sphinxcontrib-jsmath==1.0.1
+    # via sphinx
+sphinxcontrib-qthelp==2.0.0
+    # via sphinx
+sphinxcontrib-serializinghtml==2.0.0
+    # via sphinx
+sse-starlette==3.1.2
+    # via mcp
+starlette==0.50.0
+    # via
+    #   mcp
+    #   sse-starlette
+tomli==2.0.2
+    # via
+    #   pytest
+    #   semgrep
+    #   sphinx
+tomlkit==0.13.3
+    # via reuse
+trio==0.32.0
+    # via
+    #   selenium
+    #   trio-websocket
+trio-websocket==0.12.2
+    # via selenium
+typer==0.21.0
+    # via rstcheck
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   cryptography
+    #   mcp
+    #   opentelemetry-api
+    #   opentelemetry-exporter-otlp-proto-http
+    #   opentelemetry-sdk
+    #   opentelemetry-semantic-conventions
+    #   pydantic
+    #   pydantic-core
+    #   pyright
+    #   referencing
+    #   selenium
+    #   semgrep
+    #   starlette
+    #   typer
+    #   typing-inspection
+    #   uvicorn
+    #   virtualenv
+typing-inspection==0.4.2
+    # via
+    #   mcp
+    #   pydantic
+    #   pydantic-settings
+urllib3==2.6.2
+    # via
+    #   requests
+    #   selenium
+    #   semgrep
+uvicorn==0.40.0 ; sys_platform != 'emscripten'
+    # via mcp
+virtualenv==20.35.4
+    # via pre-commit
+wcmatch==8.5.2
+    # via semgrep
+webdriver-manager==4.0.2
+websocket-client==1.9.0
+    # via selenium
+wrapt==1.17.3
+    # via opentelemetry-instrumentation
+wsproto==1.3.2
+    # via trio-websocket
+zipp==3.23.0
+    # via importlib-metadata

docker-bin.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+
+/venv/bin/python3 -m glances "$@"

docker-compose/docker-compose.yml

@@ -0,0 +1,55 @@
+services:
+  glances:
+    # See all images tags here: https://hub.docker.com/r/nicolargo/glances/tags
+    image: nicolargo/glances:latest-full
+    restart: always
+
+    pid: "host"
+    network_mode: "host"
+
+    read_only: true
+    privileged: false
+    # Uncomment next line for SATA or NVME smartctl monitoring
+    # cap_add:
+      # Uncomment next line for SATA smartctl monitoring
+      # - SYS_RAWIO
+      # Uncomment next line for NVME smartctl monitoring
+      # - SYS_ADMIN
+    # devices:
+    #   - "/dev/nvme0"
+
+    volumes:
+      - "/:/rootfs:ro"
+      - "/var/run/docker.sock:/var/run/docker.sock:ro"
+      - "/run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro"
+      - "./glances.conf:/glances/conf/glances.conf"
+      # Uncomment for proper distro information in upper panel.
+#     # Works only for distros that do have this file (most of distros do).
+#      - "/etc/os-release:/etc/os-release:ro"
+
+    tmpfs:
+      - /tmp
+
+    environment:
+      # Please set to your local timezone (or use local ${TZ} environment variable if set on your host)
+      - TZ=Europe/Paris
+      - GLANCES_OPT=-C /glances/conf/glances.conf -w --enable-plugin smart
+      - PYTHONPYCACHEPREFIX=/tmp/py_caches
+
+#     # Uncomment for GPU compatibility (Nvidia) inside the container
+#     deploy:
+#       resources:
+#         reservations:
+#           devices:
+#             - driver: nvidia
+#               count: 1
+#               capabilities: [gpu]
+
+    # Uncomment to protect Glances WebUI by a login/password (add --password to GLANCES_OPT)
+    # secrets:
+    #   - source: glances_password
+    #     target: /root/.config/glances/<login>.pwd
+
+# secrets:
+#   glances_password:
+#     file: ./secrets/glances_password

docker-compose/glances.conf

@@ -0,0 +1,969 @@
+##############################################################################
+# Globals Glances parameters
+##############################################################################
+
+[global]
+# Stats refresh rate (default is a minimum of 2 seconds)
+# Can be overwrite by the -t <sec> option
+# It is also possible to overwrite it in each plugin sections
+refresh=2
+# Does Glances should check if a newer version is available on PyPI ?
+check_update=False
+# History size (maximum number of values)
+# Default is 1200 values (~1h with the default refresh rate)
+history_size=1200
+# Set the way Glances should display the date (default is %Y-%m-%d %H:%M:%S %Z)
+#strftime_format=%Y-%m-%d %H:%M:%S %Z
+# Define external directory for loading additional plugins
+# The layout follows the glances standard for plugin definitions
+#plugin_dir=/home/user/dev/plugins
+
+##############################################################################
+# User interface
+##############################################################################
+
+[outputs]
+# Options for all UIs
+#--------------------
+# Separator in the Curses and WebUI interface (between top and others plugins)
+#separator=True
+# Set the the Curses and WebUI interface left menu plugin list (comma-separated)
+#left_menu=network,wifi,connections,ports,diskio,fs,irq,folders,raid,smart,sensors,now
+# Limit the number of processes to display (in the WebUI)
+max_processes_display=25
+#
+# Specifics options for TUI
+#--------------------------
+# Disable background color
+#disable_bg=True
+#
+# Specifics options for WebUI
+#----------------------------
+# Set URL prefix for the WebUI and the API
+# Example: url_prefix=/glances/ => http://localhost/glances/
+# Note: The final / is mandatory
+# Default is no prefix (/)
+#url_prefix=/glances/
+# Set root path for WebUI statics files
+# Why ? On Debian system, WebUI statics files are not provided.
+# You can download it in a specific folder
+# thanks to https://github.com/nicolargo/glances/issues/2021
+# then configure this folder with the webui_root_path key
+# Default is folder where glances_restful_api.py is hosted
+#webui_root_path=
+# CORS options
+# Comma separated list of origins that should be permitted to make cross-origin requests.
+# Default is *
+#cors_origins=*
+# Indicate that cookies should be supported for cross-origin requests.
+# Default is True
+#cors_credentials=True
+# Comma separated list of HTTP methods that should be allowed for cross-origin requests.
+# Default is *
+#cors_methods=*
+# Comma separated list of HTTP request headers that should be supported for cross-origin requests.
+# Default is *
+#cors_headers=*
+# Define SSL files (keyfile_password is optional)
+#ssl_keyfile_password=kfp
+#ssl_keyfile=./glances.local+3-key.pem
+#ssl_certfile=./glances.local+3.pem
+
+##############################################################################
+# Plugins
+##############################################################################
+
+[quicklook]
+# Set to true to disable a plugin
+# Note: you can also disable it from the command line (see --disable-plugin <plugin_name>)
+disable=False
+# Stats list (default is cpu,mem,load)
+# Available stats are: cpu,mem,load,swap
+list=cpu,mem,load
+# Graphical bar char used in the terminal user interface (default is |)
+bar_char=|
+# Define CPU, MEM and SWAP thresholds in %
+cpu_careful=50
+cpu_warning=70
+cpu_critical=90
+mem_careful=50
+mem_warning=70
+mem_critical=90
+swap_careful=50
+swap_warning=70
+swap_critical=90
+# Source: http://blog.scoutapp.com/articles/2009/07/31/understanding-load-averages
+# With 1 CPU core, the load should be lower than 1.00 ~ 100%
+load_careful=70
+load_warning=100
+load_critical=500
+
+[system]
+# This plugin display the first line in the Glances UI with:
+# Hostname / Operating system name / Architecture information
+# Set to true to disable a plugin
+disable=False
+# Default refresh rate is 60 seconds
+#refresh=60
+# System information to display (a string where {key} will be replaced by the value)
+# Available information are: hostname, os_name, os_version, os_arch, linux_distro, platform
+#system_info_msg= | My {os_name} system |
+
+[cpu]
+disable=False
+# See https://scoutapm.com/blog/slow_server_flow_chart
+#
+# I/O wait percentage should be lower than 1/# (# = Logical CPU cores)
+# Leave commented to just use the default config:
+# Careful=1/#*100-20% / Warning=1/#*100-10% / Critical=1/#*100
+#iowait_careful=30
+#iowait_warning=40
+#iowait_critical=50
+#
+# Total % is 100 - idle
+total_careful=65
+total_warning=75
+total_critical=85
+total_log=True
+#
+# Default values if not defined: 50/70/90 (except for iowait)
+user_careful=50
+user_warning=70
+user_critical=90
+user_log=False
+#user_critical_action=echo "{{time}} User CPU {{user}} higher than {{critical}}" > /tmp/cpu.alert
+#
+system_careful=50
+system_warning=70
+system_critical=90
+system_log=False
+#
+steal_careful=50
+steal_warning=70
+steal_critical=90
+#steal_log=True
+#
+# Context switch limit (core / second)
+# Leave commented to just use the default config critical is 50000*(Logical CPU cores)
+#ctx_switches_careful=10000
+#ctx_switches_warning=12000
+#ctx_switches_critical=14000
+
+[percpu]
+disable=False
+# Define the maximum number of CPU displayed at a time
+# If the number of CPU is higher than the one configured in max_cpu_display then:
+# - display top 'max_cpu_display' (sorted by CPU consumption)
+# - a last line will be added with the mean of all other CPUs
+max_cpu_display=4
+# Define CPU thresholds in %
+# Default values if not defined: 50/70/90
+user_careful=50
+user_warning=70
+user_critical=90
+iowait_careful=50
+iowait_warning=70
+iowait_critical=90
+system_careful=50
+system_warning=70
+system_critical=90
+
+[gpu]
+disable=False
+# Default processor values if not defined: 50/70/90
+proc_careful=50
+proc_warning=70
+proc_critical=90
+# Default memory values if not defined: 50/70/90
+mem_careful=50
+mem_warning=70
+mem_critical=90
+# Temperature
+temperature_careful=60
+temperature_warning=70
+temperature_critical=80
+
+[mem]
+disable=False
+# Display available memory instead of used memory
+#available=True
+# Define RAM thresholds in %
+# Default values if not defined: 50/70/90
+careful=50
+warning=70
+critical=90
+#critical_action_repeat=echo "{{time}} {{percent}} higher than {{critical}}"" >> /tmp/memory.alert
+
+[memswap]
+disable=False
+# Define SWAP thresholds in %
+# Default values if not defined: 50/70/90
+careful=50
+warning=70
+critical=90
+#warning_action=echo "{{time}} {{percent}} higher than {{warning}}"" > /tmp/memory.alert
+
+[load]
+disable=False
+# Define LOAD thresholds
+# Value * number of cores
+# Default values if not defined: 0.7/1.0/5.0 per number of cores
+# Source: http://blog.scoutapp.com/articles/2009/07/31/understanding-load-averages
+#         http://www.linuxjournal.com/article/9001
+careful=0.7
+warning=1.0
+critical=5.0
+#log=False
+
+[network]
+disable=False
+# Default bitrate thresholds in % of the network interface speed
+# Default values if not defined: 70/80/90
+rx_careful=70
+rx_warning=80
+rx_critical=90
+tx_careful=70
+tx_warning=80
+tx_critical=90
+# Define the list of hidden network interfaces (comma-separated regexp)
+#hide=docker.*,lo
+# Define the list of wireless network interfaces to be show (comma-separated)
+#show=docker.*
+# Automatically hide interface not up (default is False)
+hide_no_up=True
+# Automatically hide interface with no IP address (default is False)
+hide_no_ip=True
+# Set hide_zero to True to automatically hide interface with no traffic
+hide_zero=False
+# Set hide_threshold_bytes to an integer value to automatically hide
+# interface with traffic less or equal than this value
+#hide_threshold_bytes=0
+# It is possible to overwrite the bitrate thresholds per interface
+# WLAN 0 Default limits (in bits per second aka bps) for interface bitrate
+#wlan0_rx_careful=4000000
+#wlan0_rx_warning=5000000
+#wlan0_rx_critical=6000000
+#wlan0_rx_log=True
+#wlan0_tx_careful=700000
+#wlan0_tx_warning=900000
+#wlan0_tx_critical=1000000
+#wlan0_tx_log=True
+#wlan0_rx_critical_action=echo "{{time}} {{interface_name}} RX {{bytes_recv_rate_per_sec}}Bps" > /tmp/network.alert
+# Alias for network interface name
+#alias=wlp0s20f3:WIFI
+
+[ip]
+# Disable display of private IP address
+disable=False
+# Configure the online service where public IP address information will be downloaded
+# - public_disabled: Disable public IP address information (set to True for offline platform)
+# - public_refresh_interval: Refresh interval between to calls to the online service
+# - public_api: URL of the API (the API should return an JSON object)
+# - public_username: Login for the online service (if needed)
+# - public_password: Password for the online service (if needed)
+# - public_field: Field name of the public IP address in onlibe service JSON message
+# - public_template: Template to build the public message
+#
+# Example for IPLeak service:
+# public_api=https://ipv4.ipleak.net/json/
+# public_field=ip
+# public_template={ip} {continent_name}/{country_name}/{city_name}
+#
+public_disabled=True
+public_refresh_interval=300
+public_api=https://ipv4.ipleak.net/json/
+#public_username=<myname>
+#public_password=<mysecret>
+public_field=ip
+public_template={continent_name}/{country_name}/{city_name}
+
+[connections]
+# Display additional information about TCP connections
+# This plugin is disabled by default because it consumes lots of CPU
+disable=True
+# nf_conntrack thresholds in %
+nf_conntrack_percent_careful=70
+nf_conntrack_percent_warning=80
+nf_conntrack_percent_critical=90
+
+[wifi]
+disable=False
+# Define SIGNAL thresholds in dBm (lower is better...)
+# Based on: http://serverfault.com/questions/501025/industry-standard-for-minimum-wifi-signal-strength
+careful=-65
+warning=-75
+critical=-85
+
+[diskio]
+disable=False
+# Define the list of hidden disks (comma-separated regexp)
+#hide=sda2,sda5,loop.*
+hide=loop.*,/dev/loop.*
+# Set hide_zero to True to automatically hide disk with no read/write
+hide_zero=False
+# Set hide_threshold_bytes to an integer value to automatically hide
+# interface with traffic less or equal than this value
+#hide_threshold_bytes=0
+# Define the list of disks to be show (comma-separated)
+#show=sda.*
+# Alias for sda1 and sdb1
+#alias=sda1:SystemDisk,sdb1:DataDisk
+# Default latency thresholds (in ms) (rx = read / tx = write)
+rx_latency_careful=10
+rx_latency_warning=20
+rx_latency_critical=50
+tx_latency_careful=10
+tx_latency_warning=20
+tx_latency_critical=50
+# Set latency thresholds (latency in ms) for a given disk name (rx = read / tx = write)
+# dm-0_rx_latency_careful=10
+# dm-0_rx_latency_warning=20
+# dm-0_rx_latency_critical=50
+# dm-0_rx_latency_log=False
+# dm-0_tx_latency_careful=10
+# dm-0_tx_latency_warning=20
+# dm-0_tx_latency_critical=50
+# dm-0_tx_latency_log=False
+# There is no default bitrate thresholds for disk (because it is not possible to know the disk speed)
+# Set bitrate thresholds (in bytes per second) for a given disk name (rx = read / tx = write)
+#dm-0_rx_careful=4000000000
+#dm-0_rx_warning=5000000000
+#dm-0_rx_critical=6000000000
+#dm-0_rx_log=False
+#dm-0_tx_careful=700000000
+#dm-0_tx_warning=900000000
+#dm-0_tx_critical=1000000000
+#dm-0_tx_log=False
+
+[fs]
+disable=False
+# Define the list of file system to hide (comma-separated regexp)
+hide=/boot.*,.*/snap.*
+# Define the list of file system to show (comma-separated regexp)
+#show=/,/srv
+# Define filesystem space thresholds in %
+# Default values if not defined: 50/70/90
+careful=50
+warning=70
+critical=90
+# It is also possible to define per mount point value
+# Example: /_careful=40
+#/_careful=1
+#/_warning=5
+#/_critical=10
+#/_critical_action=echo "{{time}} {{mnt_point}} filesystem space {{percent}}% higher than {{critical}}%" > /tmp/fs.alert
+# Allow additional file system types (comma-separated FS type)
+#allow=shm
+# Alias for root file system
+#alias=/:Root,/zsfpool:ZSF
+
+[irq]
+# Documentation: https://glances.readthedocs.io/en/latest/aoa/irq.html
+# This plugin is disabled by default
+disable=True
+
+[folders]
+# Documentation: https://glances.readthedocs.io/en/latest/aoa/folders.html
+disable=False
+# Define a folder list to monitor
+# The list is composed of items (list_#nb <= 10)
+# An item is defined by:
+# * path: absolute path
+# * careful: optional careful threshold (in MB)
+# * warning: optional warning threshold (in MB)
+# * critical: optional critical threshold (in MB)
+# * refresh: interval in second between two refreshes
+#folder_1_path=/tmp
+#folder_1_careful=2500
+#folder_1_warning=3000
+#folder_1_critical=3500
+#folder_1_refresh=60
+#folder_2_path=/home/nicolargo/Videos
+#folder_2_warning=17000
+#folder_2_critical=20000
+#folder_3_path=/nonexisting
+#folder_4_path=/root
+
+[cloud]
+# Documentation: https://glances.readthedocs.io/en/latest/aoa/cloud.html
+# This plugin is disabled by default
+disable=True
+
+[raid]
+# Documentation: https://glances.readthedocs.io/en/latest/aoa/raid.html
+# This plugin is disabled by default
+disable=True
+
+[smart]
+# Documentation: https://glances.readthedocs.io/en/latest/aoa/smart.html
+# This plugin is disabled by default
+disable=True
+# Define the list of sensors to hide (comma-separated regexp)
+#hide=.*Hide_this_driver.*
+# Define the list of sensors to show (comma-separated regexp)
+#show=.*Drive_Temperature.*
+# List of attributes to hide (comma separated)
+#hide_attributes=Self-tests,Errors
+
+[hddtemp]
+disable=False
+# Define hddtemp server IP and port (default is 127.0.0.1 and 7634 (TCP))
+host=127.0.0.1
+port=7634
+
+[sensors]
+# Documentation: https://glances.readthedocs.io/en/latest/aoa/sensors.html
+disable=False
+# Set the refresh multiplicator for the sensors
+# By default refresh every Glances refresh * 5 (increase to reduce CPU consumption)
+#refresh=5
+# Hide some sensors (comma separated list of regexp)
+hide=unknown.*
+# Show only the following sensors (comma separated list of regexp)
+#show=CPU.*
+# Sensors core thresholds (in Celsius...)
+# By default values are grabbed from the system
+# Overwrite thresholds for a specific sensor
+# temperature_core_Ambient_careful=40
+# temperature_core_Ambient_warning=60
+# temperature_core_Ambient_critical=85
+# temperature_core_Ambient_log=True
+# temperature_core_Ambient_critical_action=echo "{{time}} {{label}} temperature {{value}}{{unit}} higher than {{critical}}{{unit}}" > /tmp/temperature.alert
+# Overwrite thresholds for a specific type of sensor
+#temperature_core_careful=45
+#temperature_core_warning=65
+#temperature_core_critical=80
+# Temperatures threshold in °C for hddtemp
+# Default values if not defined: 45/52/60
+#temperature_hdd_careful=45
+#temperature_hdd_warning=52
+#temperature_hdd_critical=60
+# Battery threshold in %
+# Default values if not defined: 70/80/90
+#battery_careful=70
+#battery_warning=80
+#battery_critical=90
+# Fan speed threshold in RPM
+#fan_speed_careful=100
+# Sensors alias
+#alias=core 0:CPU Core 0,core 1:CPU Core 1
+
+[processcount]
+disable=False
+# If you want to change the refresh rate of the processing list, please uncomment:
+#refresh=10
+
+[processlist]
+disable=False
+# Sort key: if not defined, the sort is automatically done by Glances (recommended)
+# Should be one of the following:
+# cpu_percent, memory_percent, io_counters, name, cpu_times, username
+#sort_key=memory_percent
+# List of stats to disable (not grabed and not display)
+# Stats that can be disabled: cpu_percent,memory_info,memory_percent,username,cpu_times,num_threads,nice,status,io_counters,cmdline
+# Stats that can not be disable: pid,name
+#disable_stats=cpu_percent,memory_info,memory_percent,username,cpu_times,num_threads,nice,status,io_counters,cmdline
+# Disable display of virtual memory
+#disable_virtual_memory=True
+# Define CPU/MEM (per process) thresholds in %
+# Default values if not defined: 50/70/90
+cpu_careful=50
+cpu_warning=70
+cpu_critical=90
+mem_careful=50
+mem_warning=70
+mem_critical=90
+#
+# Nice priorities range from -20 to 19.
+# Configure nice levels using a comma-separated list.
+#
+# Nice: Example 1, non-zero is warning (default behavior)
+nice_warning=-20,-19,-18,-17,-16,-15,-14,-13,-12,-11,-10,-9,-8,-7,-6,-5,-4,-3,-2,-1,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19
+#
+# Nice: Example 2, low priority processes escalate from careful to critical
+#nice_ok=O
+#nice_careful=1,2,3,4,5,6,7,8,9
+#nice_warning=10,11,12,13,14
+#nice_critical=15,16,17,18,19
+#
+# Status: define threshold regarding the process status (first letter of process status)
+# R: Running, S: Sleeping, Z: Zombie (complete list here https://psutil.readthedocs.io/en/latest/#process-status-constants)
+status_ok=R,W,P,I
+status_critical=Z,D
+# Define the list of processes to export using:
+# a comma-separated list of Glances filter
+#export=.*firefox.*,pid:1234
+# Define a list of process to focus on (comma-separated list of Glances filter)
+#focus=.*firefox.*,.*python.*
+
+[ports]
+disable=False
+# Interval in second between two scans
+# Ports scanner plugin configuration
+refresh=30
+# Set the default timeout (in second) for a scan (can be overwritten in the scan list)
+timeout=3
+# If port_default_gateway is True, add the default gateway on top of the scan list
+port_default_gateway=False
+#
+# Define the scan list (1 < x < 255)
+# port_x_host (name or IP) is mandatory
+# port_x_port (TCP port number) is optional (if not set, use ICMP)
+# port_x_description is optional (if not set, define to host:port)
+# port_x_timeout is optional and overwrite the default timeout value
+# port_x_rtt_warning is optional and defines the warning threshold in ms
+#
+#port_1_host=192.168.0.1
+#port_1_port=80
+#port_1_description=Home Box
+#port_1_timeout=1
+#port_2_host=www.free.fr
+#port_2_description=My ISP
+#port_3_host=www.google.com
+#port_3_description=Internet ICMP
+#port_3_rtt_warning=1000
+#port_4_description=Internet Web
+#port_4_host=www.google.com
+#port_4_port=80
+#port_4_rtt_warning=1000
+#
+# Define Web (URL) monitoring list (1 < x < 255)
+# web_x_url is the URL to monitor (example: http://my.site.com/folder)
+# web_x_description is optional (if not set, define to URL)
+# web_x_timeout is optional and overwrite the default timeout value
+# web_x_rtt_warning is optional and defines the warning respond time in ms (approximately)
+#
+#web_1_url=https://blog.nicolargo.com
+#web_1_description=My Blog
+#web_1_rtt_warning=3000
+#web_2_url=https://github.com
+#web_3_url=http://www.google.fr
+#web_3_description=Google Fr
+#web_4_url=https://blog.nicolargo.com/nonexist
+#web_4_description=Intranet
+
+[vms]
+disable=True
+# Define the maximum VMs size name (default is 20 chars)
+max_name_size=20
+# By default, Glances only display running VMs with states:
+# 'Running', 'Paused', 'Starting' or 'Restarting'
+# Set the following key to True to display all VMs regarding their states
+all=False
+
+[containers]
+disable=False
+# Only show specific containers (comma-separated list of container name or regular expression)
+# Comment this line to display all containers (default configuration)
+; show=telegraf
+# Hide some containers (comma-separated list of container name or regular expression)
+# Comment this line to display all containers (default configuration)
+; hide=telegraf
+# Define the maximum docker size name (default is 20 chars)
+max_name_size=20
+# List of stats to disable (not display)
+# Following stats can be disabled: name,status,uptime,cpu,mem,diskio,networkio,ports,command
+disable_stats=command
+# Thresholds for CPU and MEM (in %)
+; cpu_careful=50
+; cpu_warning=70
+; cpu_critical=90
+; mem_careful=20
+; mem_warning=50
+; mem_critical=70
+#
+# Per container thresholds
+; containername_cpu_careful=10
+; containername_cpu_warning=20
+; containername_cpu_critical=30
+#
+# By default, Glances only display running containers
+# Set the following key to True to display all containers
+all=False
+# Define Podman sock
+; podman_sock=unix:///run/user/1000/podman/podman.sock
+
+[amps]
+# AMPs configuration are defined in the bottom of this file
+disable=False
+
+[alert]
+disable=False
+# Maximum number of events to display (default is 10 events)
+;max_events=10
+# Minimum duration for an event to be taken into account (default is 6 seconds)
+;min_duration=6
+# Minimum time between two events of the same type (default is 6 seconds)
+# This is used to avoid too many alerts for the same event
+# Events will be merged
+;min_interval=6
+
+##############################################################################
+# Browser mode - Static servers definition
+##############################################################################
+
+[serverlist]
+# Define columns (comma separated list of <plugin>:<field>:(<key>)) to grab/display
+# Default is: system:hr_name,load:min5,cpu:total,mem:percent
+# You can also add stats with key, like sensors:value:Ambient (key is case sensitive)
+#columns=system:hr_name,load:min5,cpu:total,mem:percent,memswap:percent,sensors:value:Ambient,sensors:value:Composite
+# Define the static servers list
+# _protocol can be: rpc (default if not defined) or rest
+# List is limited to 256 servers max (1 to 256)
+#server_1_name=localhost
+#server_1_alias=Local WebUI
+#server_1_port=61266
+#server_1_protocol=rest
+#server_2_name=localhost
+#server_2_alias=My local PC
+#server_2_port=61209
+#server_2_protocol=rpc
+#server_3_name=192.168.0.17
+#server_3_alias=Another PC on my network
+#server_3_port=61209
+#server_1_protocol=rpc
+#server_4_name=notagooddefinition
+#server_4_port=61237
+
+[passwords]
+# Define the passwords list related to the [serverlist] section
+# Syntax: host=password
+# Where: host is the hostname
+#        password is the clear password
+# Additionally (and optionally) a default password could be defined
+#localhost=abc
+#default=defaultpassword
+#
+# Define the path of the local '.pwd' file (default is system one)
+#local_password_path=~/.config/glances
+
+##############################################################################
+# Exports
+##############################################################################
+
+[export]
+# Common section for all exporters
+# Do not export following fields (comma separated list of regex)
+#exclude_fields=.*_critical,.*_careful,.*_warning,.*\.key$
+
+[graph]
+# Configuration for the --export graph option
+# Set the path where the graph (.svg files) will be created
+# Can be overwrite by the --graph-path command line option
+path=/tmp/glances
+# It is possible to generate the graphs automatically by setting the
+# generate_every to a non zero value corresponding to the seconds between
+# two generation. Set it to 0 to disable graph auto generation.
+generate_every=0
+# See following configuration keys definitions in the Pygal lib documentation
+# http://pygal.org/en/stable/documentation/index.html
+width=800
+height=600
+style=DarkStyle
+
+[influxdb]
+# !!!
+# Will be DEPRECATED in future release.
+# Please have a look on the new influxdb3 export module
+# !!!
+# Configuration for the --export influxdb option
+# https://influxdb.com/
+host=localhost
+port=8086
+protocol=http
+user=root
+password=root
+db=glances
+# Prefix will be added for all measurement name
+# Ex: prefix=foo
+#     => foo.cpu
+#     => foo.mem
+# You can also use dynamic values
+#prefix=foo
+# Following tags will be added for all measurements
+# You can also use dynamic values.
+# Note: hostname and name (for process) are always added as a tag
+#tags=foo:bar,spam:eggs,domain:`domainname`
+
+[influxdb2]
+# Configuration for the --export influxdb2 option
+# https://influxdb.com/
+host=localhost
+port=8086
+protocol=http
+org=nicolargo
+bucket=glances
+token=PUT_YOUR_INFLUXDB2_TOKEN_HERE
+# Set the interval between two exports (in seconds)
+# If the interval is set to 0, the Glances refresh time is used (default behavor)
+#interval=0
+# Prefix will be added for all measurement name
+# Ex: prefix=foo
+#     => foo.cpu
+#     => foo.mem
+# You can also use dynamic values
+#prefix=foo
+# Following tags will be added for all measurements
+# You can also use dynamic values.
+# Note: hostname and name (for process) are always added as a tag
+#tags=foo:bar,spam:eggs,domain:`domainname`
+
+[influxdb3]
+# Configuration for the --export influxdb3 option
+# https://influxdb.com/
+host=http://localhost:8181
+org=nicolargo
+database=glances
+token=PUT_YOUR_INFLUXDB3_TOKEN_HERE
+# Set the interval between two exports (in seconds)
+# If the interval is set to 0, the Glances refresh time is used (default behavor)
+#interval=0
+# Prefix will be added for all measurement name
+# Ex: prefix=foo
+#     => foo.cpu
+#     => foo.mem
+# You can also use dynamic values
+#prefix=foo
+# Following tags will be added for all measurements
+# You can also use dynamic values.
+# Note: hostname and name (for process) are always added as a tag
+#tags=foo:bar,spam:eggs,domain:`domainname`
+
+[cassandra]
+# Configuration for the --export cassandra option
+# Also works for the ScyllaDB
+# https://influxdb.com/ or http://www.scylladb.com/
+host=localhost
+port=9042
+protocol_version=3
+keyspace=glances
+replication_factor=2
+# If not define, table name is set to host key
+table=localhost
+# If not define, username and password will not be used
+#username=cassandra
+#password=password
+
+[opentsdb]
+# Configuration for the --export opentsdb option
+# http://opentsdb.net/
+host=localhost
+port=4242
+#prefix=glances
+#tags=foo:bar,spam:eggs
+
+[statsd]
+# Configuration for the --export statsd option
+# https://github.com/etsy/statsd
+host=localhost
+port=8125
+#prefix=glances
+
+[elasticsearch]
+# Configuration for the --export elasticsearch option
+# Data are available via the ES RESTful API. ex: URL/<index>/cpu
+# https://www.elastic.co
+scheme=http
+host=localhost
+port=9200
+index=glances
+
+[riemann]
+# Configuration for the --export riemann option
+# http://riemann.io
+host=localhost
+port=5555
+
+[rabbitmq]
+# Configuration for the --export rabbitmq option
+host=localhost
+port=5672
+user=guest
+password=guest
+queue=glances_queue
+#protocol=amqps
+
+[mqtt]
+# Configuration for the --export mqtt option
+host=localhost
+# Overwrite device name in the topic
+#devicename=localhost
+port=8883
+tls=false
+user=guest
+password=guest
+topic=glances
+topic_structure=per-metric
+callback_api_version=2
+
+[couchdb]
+# Configuration for the --export couchdb option
+# https://www.couchdb.org
+host=localhost
+port=5984
+db=glances
+user=admin
+password=admin
+
+[mongodb]
+# Configuration for the --export mongodb option
+# https://www.mongodb.com
+host=localhost
+port=27017
+db=glances
+user=root
+password=example
+
+[kafka]
+# Configuration for the --export kafka option
+# http://kafka.apache.org/
+host=localhost
+port=9092
+topic=glances
+#compression=gzip
+# Tags will be added for all events
+#tags=foo:bar,spam:eggs
+# You can also use dynamic values
+#tags=hostname:`hostname -f`
+
+[zeromq]
+# Configuration for the --export zeromq option
+# http://www.zeromq.org
+# Use * to bind on all interfaces
+host=*
+port=5678
+# Glances envelopes the stats in a publish message with two frames:
+# - First frame containing the following prefix (STRING)
+# - Second frame with the Glances plugin name (STRING)
+# - Third frame with the Glances plugin stats (JSON)
+prefix=G
+
+[prometheus]
+# Configuration for the --export prometheus option
+# https://prometheus.io
+# Create a Prometheus exporter listening on localhost:9091 (default configuration)
+# Metric are exporter using the following name:
+#   <prefix>_<plugin>_<stats>{labelkey:labelvalue}
+# Note: You should add this exporter to your Prometheus server configuration:
+#   scrape_configs:
+#    - job_name: 'glances_exporter'
+#      scrape_interval: 5s
+#      static_configs:
+#        - targets: ['localhost:9091']
+#
+# Labels will be added for all measurements (default is src:glances)
+#  labels=foo:bar,spam:eggs
+# You can also use dynamic values
+#  labels=system:`uname -s`
+#
+host=localhost
+port=9091
+#prefix=glances
+labels=src:glances
+
+[restful]
+# Configuration for the --export restful option
+# Example, export to http://localhost:6789/
+host=localhost
+port=6789
+protocol=http
+path=/
+
+[graphite]
+# Configuration for the --export graphite option
+# https://graphiteapp.org/
+host=localhost
+port=2003
+# Prefix will be added for all measurement name
+prefix=glances
+# System name added between the prefix and the stats
+# By default, system_name = FQDN
+#system_name=mycomputer
+
+[timescaledb]
+# Configuration for the --export timescaledb option
+# https://www.timescale.com/
+host=localhost
+port=5432
+db=glances
+user=postgres
+password=password
+# Overwrite device name (default is the FQDN)
+# Most of the time, you should not overwrite this value
+#hostname=mycomputer
+
+[nats]
+# Configuration for the --export nats option
+# https://nats.io/
+# Host is a separated list of NATS nodes
+host=nats://localhost:4222
+# Prefix for the subjects (default is 'glances')
+prefix=glances
+
+##############################################################################
+# AMPS
+# * enable: Enable (true) or disable (false) the AMP
+# * regex: Regular expression to filter the process(es)
+# * refresh: The AMP is executed every refresh seconds
+# * one_line: (optional) Force (if true) the AMP to be displayed in one line
+# * command: (optional) command to execute when the process is detected (thk to the regex)
+# * countmin: (optional) minimal number of processes
+#             A warning will be displayed if number of process < count
+# * countmax: (optional) maximum number of processes
+#             A warning will be displayed if number of process > count
+# * <foo>: Others variables can be defined and used in the AMP script
+##############################################################################
+
+[amp_dropbox]
+# Use the default AMP (no dedicated AMP Python script)
+# Check if the Dropbox daemon is running
+# Every 3 seconds, display the 'dropbox status' command line
+enable=false
+regex=.*dropbox.*
+refresh=3
+one_line=false
+command=dropbox status
+countmin=1
+
+[amp_python]
+# Use the default AMP (no dedicated AMP Python script)
+# Monitor all the Python scripts
+# Alert if more than 20 Python scripts are running
+enable=false
+regex=.*python.*
+refresh=3
+countmax=20
+
+[amp_conntrack]
+# Use && separator for multiple commands
+# If the regex key is not defined, the AMP will be executed every refresh second
+# and the process count will not be displayed (countmin and countmax will be ignore)
+enable=false
+refresh=30
+one_line=false
+command=sysctl net.netfilter.nf_conntrack_count && sysctl net.netfilter.nf_conntrack_max
+
+[amp_nginx]
+# Use the NGinx AMP
+# Nginx status page should be enable (https://easyengine.io/tutorials/nginx/status-page/)
+enable=false
+regex=\/usr\/sbin\/nginx
+refresh=60
+one_line=false
+status_url=http://localhost/nginx_status
+
+[amp_systemd]
+# Use the Systemd AMP
+enable=false
+regex=\/lib\/systemd\/systemd
+refresh=30
+one_line=true
+systemctl_cmd=/bin/systemctl --plain
+
+[amp_systemv]
+# Use the Systemv AMP
+enable=false
+regex=\/sbin\/init
+refresh=30
+one_line=true
+service_cmd=/usr/bin/service --status-all

docker-files/README.md

@@ -0,0 +1,11 @@
+# Dockerfiles
+
+```bash
+make docker
+```
+
+Then test the image with:
+
+```bash
+make run-docker-alpine-dev
+```

docker-files/alpine.Dockerfile

@@ -0,0 +1,149 @@
+#
+# Glances Dockerfile (based on Alpine)
+#
+# https://github.com/nicolargo/glances
+#
+
+# Note: ENV is for future running containers. ARG for building your Docker image.
+
+# WARNING: the Alpine image version and Python version should be set.
+# Alpine 3.18 tag is a link to the latest 3.18.x version.
+# Be aware that if you change the Alpine version, you may have to change the Python version.
+ARG IMAGE_VERSION=3.23
+ARG PYTHON_VERSION=3.12
+
+##############################################################################
+# Base layer to be used for building dependencies and the release images
+FROM alpine:${IMAGE_VERSION} AS base
+
+# Upgrade the system
+RUN apk update \
+  && apk upgrade --no-cache
+
+# Install the minimal set of packages
+RUN apk add --no-cache \
+  python3 \
+  curl \
+  lm-sensors \
+  wireless-tools \
+  smartmontools \
+  iputils \
+  tzdata
+
+##############################################################################
+# BUILD Stages
+##############################################################################
+# BUILD: Base image shared by all build images
+FROM base AS build
+ARG PYTHON_VERSION
+
+RUN apk add --no-cache \
+  python3-dev \
+  py3-pip \
+  py3-wheel \
+  musl-dev \
+  linux-headers \
+  build-base \
+  libzmq \
+  zeromq-dev \
+  # Required for 'cryptography' dependency of optional requirement 'cassandra-driver' \
+  # Refer: https://cryptography.io/en/latest/installation/#alpine \
+  # `git` required to clone cargo crates (dependencies)
+  git \
+  gcc \
+  cargo \
+  pkgconfig \
+  libffi-dev \
+  openssl-dev \
+  cmake
+  # for cmake: Issue:  https://github.com/nicolargo/glances/issues/2735
+
+RUN python${PYTHON_VERSION} -m venv venv-build
+RUN /venv-build/bin/python${PYTHON_VERSION} -m pip install --upgrade pip
+
+RUN python${PYTHON_VERSION} -m venv --without-pip venv
+
+COPY pyproject.toml docker-requirements.txt all-requirements.txt ./
+
+##############################################################################
+# BUILD: Install the minimal image deps
+FROM build AS buildminimal
+ARG PYTHON_VERSION
+
+RUN /venv-build/bin/python${PYTHON_VERSION} -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \
+    -r docker-requirements.txt
+
+##############################################################################
+# BUILD: Install all the deps
+FROM build AS buildfull
+ARG PYTHON_VERSION
+
+# Required for optional dependency cassandra-driver
+ARG CASS_DRIVER_NO_CYTHON=1
+# See issue 2368
+ARG CARGO_NET_GIT_FETCH_WITH_CLI=true
+
+RUN /venv-build/bin/python${PYTHON_VERSION} -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \
+    -r all-requirements.txt
+
+##############################################################################
+# RELEASE Stages
+##############################################################################
+# Base image shared by all releases
+FROM base AS release
+ARG PYTHON_VERSION
+
+# Copy source code and config file
+COPY ./docker-compose/glances.conf /etc/glances/glances.conf
+COPY ./glances/. /app/glances/
+
+# Copy binary and update PATH
+COPY docker-bin.sh /usr/local/bin/glances
+RUN chmod a+x /usr/local/bin/glances
+ENV PATH="/venv/bin:$PATH"
+
+# EXPOSE PORT (XMLRPC / WebUI)
+EXPOSE 61209 61208
+
+# Add glances user
+# RUN addgroup -g 1000 glances && \
+#     adduser -D -u 1000 -G glances glances && \
+#     chown -R glances:glances /app
+
+# Define default command.
+WORKDIR /app
+ENV PYTHON_VERSION=${PYTHON_VERSION}
+CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"]
+
+################################################################################
+# RELEASE: minimal
+FROM release AS minimal
+
+COPY --from=buildminimal /venv /venv
+
+# USER glances
+
+################################################################################
+# RELEASE: full
+FROM release AS full
+
+RUN apk add --no-cache libzmq
+
+COPY --from=buildfull /venv /venv
+
+# USER glances
+
+################################################################################
+# RELEASE: dev - to be compatible with CI
+FROM full AS dev
+
+# Add the specific logger configuration file for Docker dev
+# All logs will be forwarded to stdout
+COPY ./docker-files/docker-logger.json /app
+ENV LOG_CFG=/app/docker-logger.json
+
+# USER glances
+
+WORKDIR /app
+ENV PYTHON_VERSION=${PYTHON_VERSION}
+CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"]

docker-files/docker-logger.json

@@ -0,0 +1,24 @@
+{
+	"version": 1,
+	"disable_existing_loggers": "False",
+	"root": { "level": "INFO", "handlers": ["console"] },
+	"formatters": {
+		"standard": { "format": "%(asctime)s -- %(levelname)s -- %(message)s" },
+		"short": { "format": "%(levelname)s -- %(message)s" },
+		"long": {
+			"format": "%(asctime)s -- %(levelname)s -- %(message)s (%(funcName)s in %(filename)s)"
+		},
+		"free": { "format": "%(message)s" }
+	},
+	"handlers": {
+		"console": { "class": "logging.StreamHandler", "formatter": "standard" }
+	},
+	"loggers": {
+		"debug": { "handlers": ["console"], "level": "DEBUG" },
+		"verbose": { "handlers": ["console"], "level": "INFO" },
+		"standard": { "handlers": ["console"], "level": "INFO" },
+		"requests": { "handlers": ["console"], "level": "ERROR" },
+		"elasticsearch": { "handlers": ["console"], "level": "ERROR" },
+		"elasticsearch.trace": { "handlers": ["console"], "level": "ERROR" }
+	}
+}

docker-files/ubuntu.Dockerfile

@@ -0,0 +1,145 @@
+#
+# Glances Dockerfile (based on Ubuntu)
+#
+# https://github.com/nicolargo/glances
+#
+
+# WARNING: the versions should be set.
+# Ex: Python 3.12 for Ubuntu 24.04
+# Note: ENV is for future running containers. ARG for building your Docker image.
+
+ARG IMAGE_VERSION=24.04
+ARG PYTHON_VERSION=3.12
+
+##############################################################################
+# Base layer to be used for building dependencies and the release images
+FROM ubuntu:${IMAGE_VERSION} AS base
+ARG DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends \
+    python3 \
+    curl \
+    lm-sensors \
+    wireless-tools \
+    smartmontools \
+    net-tools \
+    tzdata \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+##############################################################################
+# BUILD Stages
+##############################################################################
+# BUILD: Base image shared by all build images
+FROM base AS build
+ARG PYTHON_VERSION
+ARG DEBIAN_FRONTEND=noninteractive
+
+# Upgrade the system
+RUN apt-get update \
+  && apt-get upgrade -y
+
+# Install build-time dependencies
+RUN apt-get install -y --no-install-recommends \
+    python3-dev \
+    python3-venv \
+    python3-pip \
+    python3-wheel \
+    libzmq5 \
+    musl-dev \
+    build-essential
+
+RUN apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+RUN python3 -m venv --without-pip venv
+
+COPY pyproject.toml docker-requirements.txt all-requirements.txt ./
+
+##############################################################################
+# BUILD: Install the minimal image deps
+FROM build AS buildminimal
+ARG PYTHON_VERSION
+
+RUN python3 -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \
+    -r docker-requirements.txt
+
+##############################################################################
+# BUILD: Install all the deps
+FROM build AS buildfull
+ARG PYTHON_VERSION
+
+RUN python3 -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \
+    -r all-requirements.txt
+
+##############################################################################
+# RELEASE Stages
+##############################################################################
+# Base image shared by all releases
+FROM base AS release
+ARG PYTHON_VERSION
+
+# Copy Glances source code and config file
+COPY ./docker-compose/glances.conf /etc/glances/glances.conf
+COPY ./glances/. /app/glances/
+
+# Copy binary and update PATH
+COPY docker-bin.sh /usr/local/bin/glances
+RUN chmod a+x /usr/local/bin/glances
+ENV PATH="/venv/bin:$PATH"
+
+# EXPOSE PORT (XMLRPC / WebUI)
+EXPOSE 61209 61208
+
+# Add glances user
+# NOTE: If used, the Glances Docker plugin do not work...
+# UID and GUID 1000 are already configured for the ubuntu user
+# Create anew one with UID and GUID 1001
+# RUN groupadd -g 1001 glances && \
+#     useradd -u 1001 -g glances glances && \
+#     chown -R glances:glances /app
+
+# Define default command.
+WORKDIR /app
+ENV PYTHON_VERSION=${PYTHON_VERSION}
+CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"]
+
+################################################################################
+# RELEASE: minimal
+FROM release AS minimal
+ARG PYTHON_VERSION
+
+COPY --from=buildMinimal /venv /venv
+
+# USER glances
+
+################################################################################
+# RELEASE: full
+FROM release AS full
+ARG PYTHON_VERSION
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends libzmq5 \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+COPY --from=buildfull /venv /venv
+
+# USER glances
+
+################################################################################
+# RELEASE: dev - to be compatible with CI
+FROM full AS dev
+ARG PYTHON_VERSION
+
+# Add the specific logger configuration file for Docker dev
+# All logs will be forwarded to stdout
+COPY ./docker-files/docker-logger.json /app
+ENV LOG_CFG=/app/docker-logger.json
+
+# USER glances
+
+WORKDIR /app
+ENV PYTHON_VERSION=${PYTHON_VERSION}
+CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"]

docker-requirements.txt

@@ -0,0 +1,83 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --no-emit-workspace --no-hashes --no-group dev --extra containers --extra web --output-file docker-requirements.txt
+annotated-doc==0.0.4
+    # via fastapi
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.12.0
+    # via starlette
+certifi==2025.11.12
+    # via requests
+charset-normalizer==3.4.4
+    # via requests
+click==8.1.8
+    # via uvicorn
+colorama==0.4.6 ; sys_platform == 'win32'
+    # via click
+defusedxml==0.7.1
+    # via glances
+docker==7.1.0
+    # via glances
+exceptiongroup==1.2.2 ; python_full_version < '3.11'
+    # via anyio
+fastapi==0.128.0
+    # via glances
+h11==0.16.0
+    # via uvicorn
+idna==3.11
+    # via
+    #   anyio
+    #   requests
+jinja2==3.1.6
+    # via glances
+markupsafe==3.0.3
+    # via jinja2
+packaging==25.0
+    # via glances
+podman==5.6.0
+    # via glances
+psutil==7.2.1
+    # via glances
+pydantic==2.12.5
+    # via fastapi
+pydantic-core==2.41.5
+    # via pydantic
+python-dateutil==2.9.0.post0
+    # via glances
+pywin32==311 ; sys_platform == 'win32'
+    # via docker
+requests==2.32.5
+    # via
+    #   docker
+    #   glances
+    #   podman
+shtab==1.8.0 ; sys_platform != 'win32'
+    # via glances
+six==1.17.0
+    # via
+    #   glances
+    #   python-dateutil
+starlette==0.50.0
+    # via fastapi
+tomli==2.0.2 ; python_full_version < '3.11'
+    # via podman
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   fastapi
+    #   pydantic
+    #   pydantic-core
+    #   starlette
+    #   typing-inspection
+    #   uvicorn
+typing-inspection==0.4.2
+    # via pydantic
+urllib3==2.6.2
+    # via
+    #   docker
+    #   podman
+    #   requests
+uvicorn==0.40.0
+    # via glances
+windows-curses==2.4.1 ; sys_platform == 'win32'
+    # via glances

docs/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line.
 SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
+SPHINXBUILD   = ../.venv/bin/sphinx-build
 PAPER         =
 BUILDDIR      = _build
 

docs/README.txt

@@ -1,13 +1,13 @@
 Building the docs
 =================
 
-First install Sphinx:
+First install Sphinx and the RTD theme:
 
-    pip install sphinx
+    make venv
 
 or update it if already installed:
 
-    pip install --upgrade sphinx
+    make venv-upgrade
 
 Go to the docs folder:
 

docs/_static/Glances Logo dark.svg

@@ -0,0 +1,8 @@
+<svg width="466" height="513" viewBox="0 0 466 513" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M255.158 74.6719C210.447 74.6719 169.577 90.8033 137.94 117.597L101.314 74.351C142.801 39.2144 196.539 18 255.158 18C313.777 18 367.514 39.2144 409.002 74.351L372.375 117.597C340.739 90.8033 299.869 74.6719 255.158 74.6719Z" fill="#57CB6A"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M69.724 269.786C78.8585 239.798 93.6848 213.11 114.202 189.72C109.215 190.339 104.374 191.744 99.6848 193.934C99.4507 193.778 99.2179 193.622 98.9852 193.466C98.7524 193.31 98.5197 193.153 98.2856 192.997C115.671 167.026 137.51 145.644 163.821 128.851C148.064 102.5 139.949 73.9389 139.475 43.1663C175.368 48.9377 205.645 65.0133 230.302 91.3932C274.053 98.9935 313.69 115.849 349.218 141.961C357.984 148.228 364.694 156.188 369.349 165.841C371.421 173.282 373.29 180.773 374.963 188.315C378.06 195.163 382.598 200.939 388.553 205.639C396.216 212.36 404.635 217.979 413.827 222.496C425.428 226.146 437.299 228.487 449.419 229.519C450.036 238.808 447.687 247.236 442.388 254.803C422.562 269.701 400.243 275.475 375.436 272.127C354.959 268.606 334.526 265.016 314.115 261.358C298.373 261.798 289.313 269.913 286.953 285.706C285.479 298.85 288.291 311.024 295.383 322.227C298.898 327.698 302.636 333.004 306.612 338.146C317.576 350.517 329.288 362.067 341.732 372.795C335.351 374.599 328.801 375.692 322.073 376.072C329.039 380.163 337.274 385.383 345.878 390.837C360.519 400.118 376.227 410.074 388.553 416.286C337.769 445.709 282.887 477.418 169.436 434.6C120.749 416.226 83.0894 382.995 69.724 348.786C58.1736 319.223 60.5895 299.774 69.724 269.786ZM293.571 177.683C316.621 190.99 343.292 187.948 343.292 187.948C343.292 187.948 333.852 161.145 310.802 147.837C287.753 134.529 259.821 139.756 259.821 139.756C259.821 139.756 270.521 164.375 293.571 177.683Z" fill="#494949"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M296.872 356.751C291.496 356.475 286.193 356.007 280.958 355.347C300.379 370.178 315.357 388.594 325.89 410.591C321.407 409.082 316.726 407.989 311.849 407.314C315.577 416.3 319.321 425.351 323.082 434.468C261.493 452.42 204.235 443.369 151.309 407.314C150.685 402.008 150.685 396.702 151.309 391.396C152.52 380.056 154.079 368.82 155.99 357.688C146.778 368.801 139.913 381.286 135.396 395.141C133.367 393.112 131.34 391.084 129.311 389.055C131.985 368.86 138.225 349.821 148.033 331.938C145.902 332.304 143.718 332.304 141.48 331.938C142.614 332.774 142.614 333.554 141.48 334.279C137.084 337.409 132.716 340.53 128.375 343.643C140.699 316.793 158.484 294.164 181.732 275.758C188.213 271.424 195.078 267.834 202.326 264.99C204.288 277.522 207.565 289.694 212.155 301.507C212.731 303.02 213.667 304.268 214.964 305.252C224.041 288.216 235.118 272.61 248.195 258.435C247.883 258.123 247.57 257.811 247.259 257.499C236.51 263.412 226.992 270.903 218.708 279.971C214.966 269.684 212.781 259.072 212.155 248.135C211.792 247.267 211.168 246.642 210.283 246.263C195.64 251.401 181.911 258.268 169.095 266.862C174.297 249.902 182.254 234.297 192.965 220.045C191.167 218.977 189.295 218.82 187.349 219.577C181.431 221.394 175.503 223.112 169.563 224.727C169.563 224.415 169.563 224.102 169.563 223.791C186.845 203.591 208.688 191.107 235.089 186.337C228.102 183.226 220.925 180.573 213.559 178.378C232.751 178.16 251.16 181.905 268.789 189.614C293.076 201.759 316.79 214.868 339.932 228.94C364.586 243.299 391.108 249.229 419.5 246.731C424.816 244.085 429.496 244.865 433.541 249.072C417.681 261.779 399.582 266.617 379.248 263.585C362.612 260.632 346.075 257.198 329.635 253.285C289.901 244.644 271.023 260.717 273.001 301.507C274.036 311.264 276.532 320.627 280.49 329.597C285.501 339.011 290.961 348.063 296.872 356.751Z" fill="#656565"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M196.71 87.0847C188.449 82.7977 180.024 78.7402 171.436 74.9123C171.124 75.2244 170.811 75.5365 170.5 75.8486C174.6 82.3323 178.344 89.0428 181.733 95.98C178.363 95.004 175.243 93.2874 172.372 90.8301C172.06 91.1422 171.747 91.4544 171.436 91.7665C172.803 97.9843 174.052 104.227 175.18 110.493C164.477 95.9365 157.3 79.7065 153.65 61.8035C170.36 66.374 184.714 74.8011 196.71 87.0847Z" fill="#656565"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M137.94 117.597C98.5802 150.932 73.6684 200.623 73.6684 256.161C73.6684 356.395 154.924 437.65 255.158 437.65C292.62 437.65 327.376 426.327 356.267 406.904V308.015H412.939V435.092L402.098 443.601C361.629 475.365 310.568 494.322 255.158 494.322C123.625 494.322 16.9966 387.694 16.9966 256.161C16.9966 183.263 49.7834 117.993 101.314 74.3508L137.94 117.597Z" fill="#57CB6A"/>
+<path d="M298.832 173.943V157.86C298.411 158.251 297.894 158.641 297.28 159.032C296.682 159.407 296.052 159.765 295.389 160.106C294.726 160.432 294.071 160.733 293.425 161.01C292.778 161.27 292.213 161.474 291.728 161.62V156.81C292.277 156.582 292.908 156.24 293.619 155.785C294.346 155.329 295.049 154.849 295.728 154.344C296.407 153.823 297.021 153.326 297.571 152.854C298.12 152.382 298.492 152.016 298.686 151.756H303.899V173.943H298.832Z" fill="#57CB6A"/>
+</svg>

docs/_static/Glances Logo.svg

@@ -0,0 +1,8 @@
+<svg width="466" height="513" viewBox="0 0 466 513" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M254.919 74.6719C210.209 74.6719 169.338 90.8033 137.702 117.597L101.076 74.351C142.563 39.2144 196.3 18 254.919 18C313.539 18 367.276 39.2144 408.763 74.351L372.137 117.597C340.501 90.8033 299.63 74.6719 254.919 74.6719Z" fill="#57CB6A"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M69.4858 269.786C78.6202 239.798 93.4465 213.11 113.963 189.72C108.977 190.339 104.136 191.744 99.4465 193.934C99.2124 193.778 98.9797 193.622 98.7469 193.466C98.5141 193.31 98.2814 193.153 98.0473 192.997C115.432 167.026 137.272 145.644 163.583 128.851C147.826 102.5 139.711 73.9389 139.237 43.1663C175.13 48.9377 205.406 65.0133 230.063 91.3932C273.815 98.9935 313.452 115.849 348.979 141.961C357.746 148.228 364.456 156.188 369.111 165.841C371.183 173.282 373.052 180.773 374.725 188.315C377.822 195.163 382.36 200.939 388.315 205.639C395.978 212.36 404.397 217.979 413.588 222.496C425.19 226.146 437.061 228.487 449.181 229.519C449.798 238.808 447.449 247.236 442.15 254.803C422.323 269.701 400.004 275.475 375.197 272.127C354.721 268.606 334.288 265.016 313.877 261.358C298.135 261.798 289.075 269.913 286.714 285.706C285.24 298.85 288.053 311.024 295.145 322.227C298.66 327.698 302.398 333.004 306.373 338.146C317.338 350.517 329.049 362.067 341.494 372.795C335.112 374.599 328.562 375.692 321.835 376.072C328.8 380.163 337.036 385.383 345.639 390.837C360.281 400.118 375.988 410.074 388.315 416.286C337.531 445.709 282.649 477.418 169.198 434.6C120.511 416.226 82.8511 382.995 69.4857 348.786C57.9354 319.223 60.3512 299.774 69.4858 269.786ZM293.333 177.683C316.383 190.99 343.053 187.948 343.053 187.948C343.053 187.948 333.614 161.145 310.564 147.837C287.514 134.529 259.583 139.756 259.583 139.756C259.583 139.756 270.283 164.375 293.333 177.683Z" fill="#EBEBEB"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M296.633 356.751C291.258 356.475 285.954 356.007 280.72 355.347C300.141 370.178 315.118 388.594 325.652 410.591C321.168 409.082 316.488 407.989 311.611 407.314C315.338 416.3 319.083 425.351 322.844 434.468C261.255 452.42 203.997 443.369 151.071 407.314C150.447 402.008 150.447 396.702 151.071 391.396C152.281 380.056 153.841 368.82 155.751 357.688C146.539 368.801 139.675 381.286 135.157 395.141C133.129 393.112 131.101 391.084 129.073 389.055C131.746 368.86 137.986 349.821 147.795 331.938C145.664 332.304 143.48 332.304 141.242 331.938C142.376 332.774 142.376 333.554 141.242 334.279C136.846 337.409 132.477 340.53 128.137 343.643C140.46 316.793 158.246 294.164 181.494 275.758C187.975 271.424 194.84 267.834 202.088 264.99C204.05 277.522 207.326 289.694 211.917 301.507C212.493 303.02 213.429 304.268 214.725 305.252C223.803 288.216 234.879 272.61 247.956 258.435C247.645 258.123 247.332 257.811 247.02 257.499C236.271 263.412 226.754 270.903 218.47 279.971C214.728 269.684 212.543 259.072 211.917 248.135C211.554 247.267 210.929 246.642 210.045 246.263C195.401 251.401 181.673 258.268 168.857 266.862C174.059 249.902 182.015 234.297 192.727 220.045C190.929 218.977 189.057 218.82 187.111 219.577C181.193 221.394 175.264 223.112 169.325 224.727C169.325 224.415 169.325 224.102 169.325 223.791C186.607 203.591 208.45 191.107 234.851 186.337C227.864 183.226 220.687 180.573 213.321 178.378C232.513 178.16 250.922 181.905 268.551 189.614C292.837 201.759 316.551 214.868 339.693 228.94C364.347 243.299 390.87 249.229 419.261 246.731C424.577 244.085 429.258 244.865 433.303 249.072C417.442 261.779 399.344 266.617 379.009 263.585C362.374 260.632 345.837 257.198 329.396 253.285C289.663 244.644 270.785 260.717 272.763 301.507C273.797 311.264 276.294 320.627 280.252 329.597C285.263 339.011 290.723 348.063 296.633 356.751Z" fill="#C1C1C1"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M196.472 87.0847C188.211 82.7977 179.786 78.7402 171.197 74.9123C170.886 75.2244 170.573 75.5365 170.261 75.8486C174.361 82.3323 178.106 89.0428 181.494 95.98C178.124 95.004 175.004 93.2874 172.133 90.8301C171.822 91.1422 171.509 91.4544 171.197 91.7665C172.565 97.9843 173.814 104.227 174.942 110.493C164.238 95.9365 157.061 79.7065 153.412 61.8035C170.122 66.374 184.476 74.8011 196.472 87.0847Z" fill="#C1C1C1"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M137.702 117.597C98.3419 150.932 73.4302 200.623 73.4302 256.161C73.4302 356.395 154.686 437.65 254.92 437.65C292.382 437.65 327.138 426.327 356.029 406.904V308.015H412.701V435.092L401.86 443.601C361.391 475.365 310.33 494.322 254.92 494.322C123.387 494.322 16.7583 387.694 16.7583 256.161C16.7583 183.263 49.5451 117.993 101.076 74.3508L137.702 117.597Z" fill="#57CB6A"/>
+<path d="M298.593 173.943V157.86C298.173 158.251 297.656 158.641 297.041 159.032C296.443 159.407 295.813 159.765 295.15 160.106C294.488 160.432 293.833 160.733 293.186 161.01C292.54 161.27 291.974 161.474 291.489 161.62V156.81C292.039 156.582 292.669 156.24 293.38 155.785C294.108 155.329 294.811 154.849 295.49 154.344C296.169 153.823 296.783 153.326 297.332 152.854C297.882 152.382 298.254 152.016 298.448 151.756H303.66V173.943H298.593Z" fill="#57CB6A"/>
+</svg>

docs/_static/Glances Text Logo dark.svg

@@ -0,0 +1,15 @@
+<svg width="680" height="728" viewBox="0 0 680 728" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M119.501 582.227C117.131 587.757 115.551 592.496 113.181 598.026C104.492 593.286 95.012 590.916 85.5325 590.126C62.6238 588.546 46.0347 598.816 39.715 620.935C34.9753 637.524 34.9753 654.113 42.0849 669.912C48.4045 684.131 58.674 692.031 74.4731 693.611C83.9526 694.401 92.6421 693.611 102.122 692.031C102.122 684.131 102.122 675.442 102.122 667.542C102.122 659.643 102.122 651.743 102.122 643.843C108.441 643.843 113.971 643.843 119.501 643.843C119.501 664.382 119.501 684.131 119.501 705.46C113.971 706.25 108.441 707.83 102.912 708.62C94.2221 709.41 85.5325 710.99 76.843 710.99C42.8748 710.99 20.756 688.871 16.8062 656.483C15.2263 643.054 15.2263 628.834 19.9661 615.405C28.6556 589.336 50.7744 573.537 78.4229 572.747C89.4823 572.747 99.7518 574.327 109.231 577.487C113.181 579.067 116.341 580.647 119.501 582.227Z" fill="#494949"/>
+<path d="M576.096 663.595C553.187 663.595 531.068 663.595 508.159 663.595C509.739 668.335 509.739 673.074 511.319 677.814C515.269 688.084 523.169 692.823 533.438 694.403C543.707 695.983 553.977 695.193 564.246 691.243C565.036 691.243 566.616 690.453 567.406 690.453C568.196 695.193 568.986 699.933 569.776 705.463C562.666 707.043 556.347 708.622 550.027 709.412C537.388 710.992 524.748 710.202 512.899 703.883C502.63 698.353 495.52 690.453 492.36 679.394C487.62 662.805 487.62 646.216 495.52 630.417C504.999 611.458 525.538 602.768 546.077 607.508C561.086 611.458 568.986 620.937 572.936 635.946C576.096 644.636 576.886 653.325 576.096 663.595ZM508.949 648.586C525.538 648.586 541.338 648.586 557.927 648.586C557.927 632.787 550.027 622.517 536.598 621.727C521.589 620.937 510.529 632.787 508.949 648.586Z" fill="#494949"/>
+<path d="M268.802 706.25C249.843 708.62 231.674 712.569 213.505 707.04C200.076 703.09 193.756 692.82 193.756 678.601C193.756 665.172 200.866 654.903 213.505 650.953C224.565 647.003 236.414 647.003 248.263 649.373C249.843 649.373 250.633 650.163 252.213 650.163C253.793 634.364 248.263 624.094 234.044 622.514C224.565 621.724 215.875 623.304 206.396 625.674C205.606 620.934 204.816 616.195 204.026 611.455C209.556 608.295 215.875 608.295 222.195 607.505C232.464 606.715 241.944 606.715 251.423 610.665C259.323 613.825 264.853 620.144 267.222 628.044C268.012 631.204 269.592 635.154 269.592 638.313C268.802 660.432 268.802 683.341 268.802 706.25ZM251.423 663.592C241.154 661.222 230.094 660.432 220.615 664.382C214.295 666.752 211.135 672.282 211.135 678.601C211.135 686.501 215.085 690.451 222.195 692.82C231.674 695.98 241.944 694.4 251.423 693.61C251.423 683.341 251.423 673.861 251.423 663.592Z" fill="#494949"/>
+<path d="M298.826 612.249C304.356 611.459 309.886 609.879 316.205 609.089C326.475 608.299 337.534 607.509 347.804 608.299C364.393 609.879 374.662 620.938 377.032 638.317C377.822 643.847 377.822 648.587 377.822 654.116C377.822 670.706 377.822 686.505 377.822 703.094C377.822 704.674 377.822 706.254 377.822 707.834C371.502 707.834 365.973 707.834 359.653 707.834C359.653 706.254 359.653 704.674 359.653 703.094C359.653 688.085 359.653 673.075 359.653 658.066C359.653 650.957 358.863 643.847 357.283 636.737C355.703 628.838 350.173 624.888 343.064 624.098C334.374 622.518 325.685 624.098 316.995 625.678C316.995 653.326 316.995 680.975 316.995 708.623C310.676 708.623 305.146 708.623 299.616 708.623C298.826 676.235 298.826 644.637 298.826 612.249Z" fill="#494949"/>
+<path d="M657.454 610.664C656.664 616.193 655.084 620.933 654.294 624.883C647.184 623.303 640.865 621.723 633.755 621.723C629.805 621.723 625.066 622.513 621.116 623.303C613.216 626.463 610.846 635.152 617.166 641.472C619.536 643.842 623.486 646.212 627.436 647.792C633.755 650.952 640.075 652.531 646.394 655.691C653.504 658.851 659.824 663.591 662.194 672.28C666.143 688.869 660.614 703.879 639.285 707.828C625.066 710.988 610.846 710.198 597.417 704.669C596.627 704.669 595.837 703.879 595.047 703.879L594.257 703.089C595.047 698.349 596.627 693.609 597.417 688.869C604.527 690.449 610.846 692.819 617.956 693.609C624.276 694.399 631.385 693.609 637.705 692.029C646.395 689.659 648.764 680.18 642.445 673.86C640.075 671.49 636.915 669.121 633.755 668.331C627.436 665.171 621.906 662.801 615.586 660.431C608.477 657.271 602.157 653.321 598.997 645.422C592.677 629.623 601.367 613.034 618.746 608.294C628.225 605.134 645.605 605.924 657.454 610.664Z" fill="#494949"/>
+<path d="M474.178 690.45C474.968 695.19 475.758 699.929 476.548 704.669C474.968 705.459 474.178 706.249 473.388 706.249C459.958 710.199 446.529 710.989 433.1 707.039C418.881 702.299 408.611 692.82 404.661 678.6C399.922 662.801 399.922 647.002 407.821 631.203C414.931 616.194 427.57 607.504 444.159 605.924C454.429 605.134 464.698 605.924 474.968 610.664C473.388 615.404 472.598 620.144 471.018 624.883C465.488 624.093 460.748 622.513 456.009 621.723C446.529 620.934 436.26 621.723 429.15 629.623C425.99 632.783 423.62 637.523 422.04 641.472C418.881 653.322 418.881 665.171 422.83 676.231C426.78 686.5 433.89 691.24 444.159 692.82C452.849 694.4 462.328 693.61 471.018 690.45C471.808 691.24 472.598 691.24 474.178 690.45Z" fill="#494949"/>
+<path d="M181.11 694.401C180.32 699.141 179.53 703.88 178.74 708.62C162.151 711.78 147.932 701.511 147.932 684.132C147.932 646.214 147.932 608.296 147.932 571.168C147.932 568.798 147.932 566.428 147.932 564.058C154.252 563.268 159.781 561.688 166.101 560.898C166.101 563.268 166.101 564.848 166.101 566.428C166.101 602.766 166.101 639.104 166.101 675.442C166.101 677.812 166.101 680.182 166.101 681.762C166.891 688.871 169.261 692.031 177.161 693.611C177.95 693.611 178.74 694.401 181.11 694.401Z" fill="#494949"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M363.176 77.9551C315.086 77.9551 271.127 95.3057 237.099 124.124L197.705 77.6099C242.328 39.8177 300.127 17 363.176 17C426.226 17 484.025 39.8177 528.647 77.6099L489.253 124.124C455.226 95.3057 411.266 77.9551 363.176 77.9551Z" fill="#57CB6A"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M163.728 287.816C173.553 255.562 189.499 226.856 211.567 201.698C206.204 202.364 200.997 203.875 195.953 206.231C195.701 206.063 195.451 205.895 195.2 205.727C194.95 205.559 194.7 205.391 194.448 205.224C213.147 177.289 236.637 154.292 264.937 136.229C247.989 107.887 239.26 77.1667 238.751 44.0684C277.357 50.276 309.921 67.5666 336.442 95.9402C383.5 104.115 426.133 122.245 464.345 150.33C473.774 157.07 480.992 165.632 485.998 176.014C488.227 184.018 490.237 192.075 492.037 200.188C495.367 207.553 500.249 213.765 506.654 218.821C514.896 226.05 523.951 232.093 533.837 236.951C546.316 240.877 559.084 243.395 572.12 244.505C572.784 254.497 570.257 263.562 564.558 271.7C543.233 287.724 519.227 293.935 492.545 290.334C470.521 286.547 448.544 282.685 426.589 278.751C409.658 279.224 399.913 287.953 397.374 304.939C395.789 319.077 398.814 332.171 406.442 344.22C410.222 350.104 414.243 355.812 418.519 361.343C430.312 374.648 442.909 387.071 456.294 398.61C449.43 400.551 442.385 401.726 435.149 402.135C442.641 406.535 451.499 412.15 460.753 418.015C476.501 427.998 493.395 438.707 506.654 445.388C452.031 477.035 393.002 511.14 270.976 465.087C218.61 445.323 178.103 409.581 163.728 372.787C151.304 340.989 153.903 320.07 163.728 287.816ZM404.493 188.751C429.285 203.065 457.971 199.792 457.971 199.792C457.971 199.792 447.819 170.964 423.027 156.65C398.235 142.336 368.192 147.958 368.192 147.958C368.192 147.958 379.701 174.438 404.493 188.751Z" fill="#494949"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M408.043 381.354C402.262 381.057 396.557 380.553 390.927 379.843C411.816 395.796 427.925 415.603 439.255 439.263C434.432 437.639 429.398 436.464 424.152 435.738C428.162 445.403 432.189 455.138 436.234 464.944C369.99 484.253 308.405 474.518 251.479 435.738C250.808 430.031 250.808 424.324 251.479 418.617C252.781 406.42 254.458 394.335 256.513 382.361C246.605 394.314 239.222 407.743 234.363 422.645C232.181 420.463 230 418.282 227.818 416.099C230.694 394.378 237.406 373.9 247.955 354.665C245.664 355.059 243.315 355.059 240.907 354.665C242.127 355.565 242.127 356.404 240.907 357.183C236.179 360.55 231.48 363.907 226.812 367.254C240.067 338.375 259.197 314.037 284.201 294.239C291.172 289.578 298.556 285.717 306.352 282.657C308.462 296.136 311.986 309.229 316.924 321.934C317.543 323.562 318.55 324.904 319.944 325.963C329.708 307.638 341.622 290.853 355.687 275.607C355.352 275.272 355.016 274.935 354.68 274.6C343.119 280.96 332.882 289.017 323.972 298.771C319.947 287.706 317.597 276.292 316.924 264.529C316.533 263.594 315.862 262.923 314.91 262.515C299.16 268.042 284.394 275.427 270.609 284.671C276.204 266.429 284.762 249.645 296.284 234.316C294.349 233.167 292.336 232.998 290.242 233.812C283.877 235.767 277.501 237.614 271.113 239.351C271.113 239.016 271.113 238.679 271.113 238.344C289.701 216.618 313.194 203.19 341.591 198.06C334.076 194.714 326.357 191.86 318.434 189.499C339.076 189.265 358.877 193.293 377.838 201.585C403.96 214.648 429.466 228.747 454.358 243.883C480.875 259.327 509.402 265.705 539.939 263.018C545.657 260.172 550.691 261.011 555.042 265.536C537.983 279.204 518.516 284.407 496.645 281.146C478.752 277.97 460.965 274.277 443.282 270.068C400.546 260.773 380.241 278.062 382.368 321.934C383.481 332.428 386.166 342.5 390.423 352.148C395.813 362.273 401.686 372.009 408.043 381.354Z" fill="#666666"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M300.311 91.306C291.426 86.695 282.364 82.3308 273.127 78.2136C272.791 78.5492 272.455 78.885 272.12 79.2207C276.53 86.1944 280.557 93.4121 284.202 100.874C280.577 99.8239 277.221 97.9775 274.133 95.3345C273.798 95.6701 273.462 96.0059 273.127 96.3416C274.598 103.029 275.941 109.744 277.154 116.484C265.642 100.827 257.922 83.3702 253.997 64.114C271.97 69.03 287.409 78.094 300.311 91.306Z" fill="#666666"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M237.1 124.124C194.765 159.979 167.97 213.426 167.97 273.161C167.97 380.971 255.367 468.367 363.176 468.367C403.47 468.367 440.853 456.188 471.927 435.297V328.934H532.882V465.615L521.222 474.767C477.695 508.932 422.774 529.322 363.176 529.322C221.702 529.322 107.015 414.635 107.015 273.161C107.015 194.753 142.28 124.551 197.705 77.6099L237.1 124.124Z" fill="#57CB6A"/>
+<path d="M410.151 184.729V167.431C409.699 167.851 409.143 168.271 408.482 168.691C407.839 169.094 407.161 169.479 406.448 169.847C405.735 170.197 405.031 170.521 404.336 170.819C403.64 171.099 403.032 171.318 402.51 171.475V166.301C403.101 166.056 403.779 165.688 404.544 165.198C405.327 164.708 406.083 164.191 406.813 163.649C407.543 163.088 408.204 162.554 408.795 162.047C409.386 161.539 409.786 161.145 409.995 160.865H415.601V184.729H410.151Z" fill="#57CB6A"/>
+</svg>

docs/_static/Glances Text Logo.svg

@@ -0,0 +1,15 @@
+<svg width="680" height="728" viewBox="0 0 680 728" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M120.262 582.227C117.893 587.757 116.313 592.496 113.943 598.026C105.253 593.286 95.7737 590.916 86.2942 590.126C63.3855 588.546 46.7964 598.816 40.4767 620.935C35.737 637.524 35.737 654.113 42.8466 669.912C49.1663 684.131 59.4357 692.031 75.2348 693.611C84.7143 694.401 93.4039 693.611 102.883 692.031C102.883 684.131 102.883 675.442 102.883 667.542C102.883 659.643 102.883 651.743 102.883 643.843C109.203 643.843 114.733 643.843 120.262 643.843C120.262 664.382 120.262 684.131 120.262 705.46C114.733 706.25 109.203 707.83 103.673 708.62C94.9838 709.41 86.2943 710.99 77.6047 710.99C43.6366 710.99 21.5177 688.871 17.568 656.483C15.988 643.054 15.988 628.834 20.7278 615.405C29.4173 589.336 51.5361 573.537 79.1846 572.747C90.244 572.747 100.513 574.327 109.993 577.487C113.943 579.067 117.103 580.647 120.262 582.227Z" fill="#C8C8C8"/>
+<path d="M576.857 663.595C553.949 663.595 531.83 663.595 508.921 663.595C510.501 668.335 510.501 673.075 512.081 677.814C516.031 688.084 523.93 692.824 534.2 694.403C544.469 695.983 554.739 695.193 565.008 691.244C565.798 691.244 567.378 690.454 568.168 690.454C568.958 695.193 569.748 699.933 570.538 705.463C563.428 707.043 557.108 708.623 550.789 709.413C538.149 710.993 525.51 710.203 513.661 703.883C503.391 698.353 496.282 690.454 493.122 679.394C488.382 662.805 488.382 646.216 496.282 630.417C505.761 611.458 526.3 602.768 546.839 607.508C561.848 611.458 569.748 620.937 573.698 635.947C576.857 644.636 577.647 653.326 576.857 663.595ZM509.711 648.586C526.3 648.586 542.099 648.586 558.688 648.586C558.688 632.787 550.789 622.517 537.36 621.727C522.35 620.937 511.291 632.787 509.711 648.586Z" fill="#C8C8C8"/>
+<path d="M269.564 706.25C250.605 708.62 232.436 712.569 214.267 707.04C200.838 703.09 194.518 692.82 194.518 678.601C194.518 665.172 201.628 654.903 214.267 650.953C225.326 647.003 237.176 647.003 249.025 649.373C250.605 649.373 251.395 650.163 252.975 650.163C254.555 634.364 249.025 624.094 234.806 622.514C225.326 621.724 216.637 623.304 207.157 625.674C206.367 620.934 205.577 616.195 204.788 611.455C210.317 608.295 216.637 608.295 222.957 607.505C233.226 606.715 242.705 606.715 252.185 610.665C260.085 613.825 265.614 620.144 267.984 628.044C268.774 631.204 270.354 635.154 270.354 638.313C269.564 660.432 269.564 683.341 269.564 706.25ZM252.185 663.592C241.916 661.222 230.856 660.432 221.377 664.382C215.057 666.752 211.897 672.282 211.897 678.601C211.897 686.501 215.847 690.451 222.957 692.82C232.436 695.98 242.705 694.4 252.185 693.61C252.185 683.341 252.185 673.861 252.185 663.592Z" fill="#C8C8C8"/>
+<path d="M299.588 612.249C305.118 611.459 310.648 609.879 316.967 609.089C327.237 608.299 338.296 607.509 348.566 608.299C365.155 609.879 375.424 620.938 377.794 638.317C378.584 643.847 378.584 648.587 378.584 654.116C378.584 670.706 378.584 686.505 378.584 703.094C378.584 704.674 378.584 706.254 378.584 707.834C372.264 707.834 366.735 707.834 360.415 707.834C360.415 706.254 360.415 704.674 360.415 703.094C360.415 688.085 360.415 673.075 360.415 658.066C360.415 650.957 359.625 643.847 358.045 636.737C356.465 628.838 350.936 624.888 343.826 624.098C335.136 622.518 326.447 624.098 317.757 625.678C317.757 653.326 317.757 680.975 317.757 708.623C311.438 708.623 305.908 708.623 300.378 708.623C299.588 676.235 299.588 644.637 299.588 612.249Z" fill="#C8C8C8"/>
+<path d="M658.216 610.664C657.426 616.193 655.846 620.933 655.056 624.883C647.947 623.303 641.627 621.723 634.517 621.723C630.568 621.723 625.828 622.513 621.878 623.303C613.979 626.463 611.609 635.152 617.928 641.472C620.298 643.842 624.248 646.212 628.198 647.792C634.517 650.952 640.837 652.531 647.157 655.691C654.266 658.851 660.586 663.591 662.956 672.28C666.906 688.869 661.376 703.879 640.047 707.828C625.828 710.988 611.609 710.198 598.179 704.669C597.389 704.669 596.599 703.879 595.809 703.879L595.02 703.089C595.809 698.349 597.389 693.609 598.179 688.869C605.289 690.449 611.609 692.819 618.718 693.609C625.038 694.399 632.148 693.609 638.467 692.029C647.157 689.659 649.527 680.18 643.207 673.86C640.837 671.49 637.677 669.121 634.517 668.331C628.198 665.171 622.668 662.801 616.348 660.431C609.239 657.271 602.919 653.321 599.759 645.422C593.44 629.623 602.129 613.034 619.508 608.294C628.988 605.134 646.367 605.924 658.216 610.664Z" fill="#C8C8C8"/>
+<path d="M474.939 690.45C475.729 695.19 476.519 699.929 477.309 704.669C475.729 705.459 474.939 706.249 474.149 706.249C460.72 710.199 447.291 710.989 433.862 707.039C419.642 702.299 409.373 692.82 405.423 678.6C400.683 662.801 400.683 647.002 408.583 631.203C415.693 616.194 428.332 607.504 444.921 605.924C455.19 605.134 465.46 605.924 475.729 610.664C474.149 615.404 473.359 620.144 471.78 624.883C466.25 624.093 461.51 622.513 456.77 621.723C447.291 620.934 437.021 621.723 429.912 629.623C426.752 632.783 424.382 637.523 422.802 641.472C419.642 653.322 419.642 665.171 423.592 676.231C427.542 686.5 434.652 691.24 444.921 692.82C453.611 694.4 463.09 693.61 471.78 690.45C472.57 691.24 473.36 691.24 474.939 690.45Z" fill="#C8C8C8"/>
+<path d="M181.872 694.401C181.082 699.141 180.292 703.88 179.502 708.62C162.913 711.78 148.694 701.511 148.694 684.132C148.694 646.214 148.694 608.296 148.694 571.168C148.694 568.798 148.694 566.428 148.694 564.058C155.014 563.268 160.543 561.688 166.863 560.898C166.863 563.268 166.863 564.848 166.863 566.428C166.863 602.766 166.863 639.104 166.863 675.442C166.863 677.812 166.863 680.182 166.863 681.762C167.653 688.871 170.023 692.031 177.922 693.611C178.712 693.611 179.502 694.401 181.872 694.401Z" fill="#C8C8C8"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M363.938 77.9551C315.848 77.9551 271.889 95.3057 237.861 124.124L198.467 77.6099C243.09 39.8177 300.888 17 363.938 17C426.988 17 484.786 39.8177 529.409 77.6099L490.015 124.124C455.987 95.3057 412.028 77.9551 363.938 77.9551Z" fill="#57CB6A"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M164.49 287.816C174.314 255.562 190.261 226.856 212.329 201.698C206.966 202.364 201.759 203.875 196.715 206.231C196.463 206.063 196.213 205.895 195.962 205.727C195.712 205.559 195.461 205.391 195.21 205.224C213.909 177.289 237.398 154.292 265.699 136.229C248.751 107.887 240.022 77.1667 239.512 44.0684C278.118 50.276 310.683 67.5666 337.204 95.9402C384.261 104.115 426.895 122.245 465.107 150.33C474.536 157.07 481.753 165.632 486.76 176.014C488.989 184.018 490.999 192.075 492.799 200.188C496.129 207.553 501.01 213.765 507.416 218.821C515.658 226.05 524.713 232.093 534.599 236.951C547.077 240.877 559.845 243.395 572.882 244.505C573.545 254.497 571.019 263.562 565.319 271.7C543.994 287.724 519.988 293.935 493.306 290.334C471.283 286.547 449.305 282.685 427.351 278.751C410.419 279.224 400.675 287.953 398.136 304.939C396.551 319.077 399.575 332.171 407.203 344.22C410.984 350.104 415.005 355.812 419.281 361.343C431.074 374.648 443.671 387.071 457.055 398.61C450.192 400.551 443.147 401.726 435.911 402.135C443.403 406.535 452.261 412.15 461.515 418.015C477.263 427.998 494.157 438.707 507.416 445.388C452.793 477.035 393.764 511.14 271.737 465.087C219.371 445.323 178.865 409.581 164.49 372.787C152.066 340.989 154.665 320.07 164.49 287.816ZM405.255 188.751C430.047 203.065 458.733 199.792 458.733 199.792C458.733 199.792 448.58 170.964 423.788 156.65C398.997 142.336 368.954 147.958 368.954 147.958C368.954 147.958 380.463 174.438 405.255 188.751Z" fill="#EBEBEB"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M408.805 381.354C403.023 381.057 397.319 380.553 391.688 379.843C412.577 395.796 428.687 415.603 440.017 439.263C435.194 437.639 430.16 436.464 424.914 435.738C428.923 445.403 432.951 455.138 436.996 464.944C370.752 484.253 309.167 474.518 252.241 435.738C251.569 430.031 251.569 424.324 252.241 418.617C253.543 406.42 255.22 394.335 257.275 382.361C247.367 394.314 239.984 407.743 235.125 422.645C232.943 420.463 230.762 418.282 228.58 416.099C231.456 394.378 238.167 373.9 248.717 354.665C246.425 355.059 244.076 355.059 241.669 354.665C242.888 355.565 242.888 356.404 241.669 357.183C236.941 360.55 232.242 363.907 227.573 367.254C240.828 338.375 259.958 314.037 284.963 294.239C291.934 289.578 299.318 285.717 307.114 282.657C309.224 296.136 312.748 309.229 317.685 321.934C318.305 323.562 319.312 324.904 320.706 325.963C330.469 307.638 342.383 290.853 356.449 275.607C356.114 275.272 355.777 274.935 355.442 274.6C343.88 280.96 333.644 289.017 324.733 298.771C320.709 287.706 318.359 276.292 317.685 264.529C317.295 263.594 316.623 262.923 315.672 262.515C299.922 268.042 285.155 275.427 271.371 284.671C276.966 266.429 285.524 249.645 297.045 234.316C295.111 233.167 293.097 232.998 291.004 233.812C284.639 235.767 278.263 237.614 271.874 239.351C271.874 239.016 271.874 238.679 271.874 238.344C290.463 216.618 313.956 203.19 342.353 198.06C334.838 194.714 327.119 191.86 319.196 189.499C339.838 189.265 359.639 193.293 378.599 201.585C404.722 214.648 430.228 228.747 455.119 243.883C481.636 259.327 510.163 265.705 540.701 263.018C546.419 260.172 551.453 261.011 555.803 265.536C538.744 279.204 519.278 284.407 497.407 281.146C479.514 277.97 461.727 274.277 444.044 270.068C401.308 260.773 381.003 278.062 383.13 321.934C384.243 332.428 386.928 342.5 391.185 352.148C396.574 362.273 402.447 372.009 408.805 381.354Z" fill="#C1C1C1"/>
+<path opacity="0.976" fill-rule="evenodd" clip-rule="evenodd" d="M301.073 91.306C292.188 86.695 283.126 82.3308 273.888 78.2136C273.553 78.5492 273.217 78.885 272.881 79.2207C277.291 86.1944 281.319 93.4121 284.964 100.874C281.339 99.8239 277.983 97.9775 274.895 95.3345C274.56 95.6701 274.224 96.0059 273.888 96.3416C275.359 103.029 276.702 109.744 277.916 116.484C266.403 100.827 258.684 83.3702 254.758 64.114C272.731 69.03 288.17 78.094 301.073 91.306Z" fill="#C1C1C1"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M237.861 124.124C195.527 159.979 168.732 213.426 168.732 273.161C168.732 380.971 256.129 468.367 363.938 468.367C404.232 468.367 441.614 456.188 472.689 435.297V328.934H533.644V465.615L521.984 474.767C478.457 508.932 423.536 529.322 363.938 529.322C222.464 529.322 107.777 414.635 107.777 273.161C107.777 194.753 143.042 124.551 198.467 77.6099L237.861 124.124Z" fill="#57CB6A"/>
+<path d="M410.913 184.729V167.431C410.461 167.851 409.904 168.271 409.244 168.691C408.601 169.094 407.922 169.479 407.21 169.847C406.497 170.197 405.793 170.521 405.097 170.819C404.402 171.099 403.794 171.318 403.272 171.475V166.301C403.863 166.056 404.541 165.688 405.306 165.198C406.088 164.708 406.845 164.191 407.575 163.649C408.305 163.088 408.966 162.554 409.557 162.047C410.148 161.539 410.548 161.145 410.756 160.865H416.363V184.729H410.913Z" fill="#57CB6A"/>
+</svg>