v2.2.2

revisions

fix: boost url function and install function

boost: url was improperly formed when using beta.

install: needed to be updated to newer root/sudo methods

Now supports custom destinations.

Update qbt-nox-static.bash

merge scripts

script emulation

Update changelog.md

Update buildinfo-build-help.astro

docs

Author: userdocs

.github/copilot-instructions.md

@@ -1,3 +1,104 @@
+# AI Coding Guide for This Repo
+
+Purpose: Make AI contributions precise, minimal, and correct. Follow these rules strictly. Do not expand scope beyond the prompt.
+
+## Bash scripting (applies to all repos)
+
+Do
+- Use `#!/bin/bash` as the shebang for Bash scripts.
+- Use the `.bash` extension for Bash; use `.sh` only for POSIX-only scripts.
+- Prefer `$BASH_SOURCE` over `$0` for script path detection.
+- Use `printf '%s'` for plain strings and `printf '%b'` for escape sequences. Avoid `echo`.
+- Keep changes simple, modular, and scoped to the exact prompt.
+- Write readable code; add concise comments explaining intent and non-obvious logic.
+- Handle errors explicitly (per function is acceptable); return helpful, actionable messages.
+- Structure changes in small stages; keep functions focused.
+- Format using Google’s Shell Style Guide: https://google.github.io/styleguide/shellguide.html
+- For Bash references, consult: https://mywiki.wooledge.org and https://mywiki.wooledge.org/BashFAQ and include a source link when possible. Do not invent links.
+
+Avoid
+- Global “set -euo pipefail”; prefer targeted checks and explicit error handling.
+- Uppercase variable names for general scripting (reserve UPPERCASE for Docker/env settings).
+- Clever one-liners that harm clarity.
+- Generalized or speculative changes not asked for in the prompt.
+- Over-engineering; keep it stable, concise, and C-like in mindset.
+
+Scope and behavior
+- Only implement what the prompt requests.
+- Keep solutions minimal and modular; do not add placeholders or future-proofing unless required.
+- When giving Bash/shell answers, add a relevant wooledge link if helpful; never fabricate links.
+
+## GitHub Workflows (all repos)
+
+- In reusable workflows, any job that uses outputs from another job must declare that job in `needs` to avoid null outputs.
+- Do not use outdated Actions. Check for current recommended versions before editing.
+- The `gh` CLI cannot fetch the ID of a workflow run it just started via `gh run workflow`. List runs afterward and extract the ID.
+
+## If repo name matches `*-musl-cross-make`
+
+Toolchain specifics
+- Use both `-static` and `--static` to produce static toolchain binaries. Using only `-static` can miss POSIX threads.
+- When using `../config.mak`, always load options from both `../gcc-configure-options.md` and `../gcc-configure-options-recursive.md`.
+- The binutils gold linker is deprecated. Use `ld=default` and `--disable-gold`.
+
+Fully static toolchains with musl
+- Do not use LTO: avoid `-flto` and `-fuse-linker-plugin`.
+- Do not add any LTO-related settings.
+- Only set linker options such as `LDFLAGS` at link time, not during library builds.
+- GNU libtool redefines `-static`; to ensure static linking, use `--static` or `-Wl,-static` (optionally with `-static`) in `LDFLAGS`.
+- For static OpenSSL: do not use `openssl -static` (it disables threads/PIE/PIC). For `-static-pie` with musl/Alpine, use the correct flags and approach.
+- Do not use glibc-only flags or glibcisms for musl toolchains.
+
+## Debugging with QEMU
+
+- Start the target under QEMU with gdbstub, then attach with gdb:
+  - `qemu -g <port> <binary>` (e.g., `qemu -g 1234 ./qbt-nox-static`)
+  - In another terminal: `gdb ./qbt-nox-static` and `target remote :1234`
+
+## If repo name matches `*qbittorrent-nox-static`
+
+`qi.bash` script goals
+- Simple installer that verifies installation and binaries.
+- Shebang must be `#!/bin/bash`.
+
+OS detection
+- `source /etc/os-release`.
+- Supported: `ID=alpine`, `ID=debian`, or `ID_LIKE` contains `debian`. Otherwise exit with a clear reason.
+
+Transfer tools
+- Prefer `curl` if present; use `wget` if present and `curl` is not; exit if neither is available.
+- Detect presence of `gh` CLI and use it when available, but it is not required.
+
+Architecture detection
+- Alpine: `apk --print-arch`.
+- Debian-like: `dpkg --print-architecture`.
+- Architectures are the same across distros except `armhf`: Debian uses `armv7`, Alpine uses `armv6`.
+- If architecture is not valid/supported, exit with a reason.
+
+Download function
+- Build the download URL from the detected architecture.
+- Create and store the download’s SHA-256 sum.
+
+Attestation (optional)
+- When `gh` CLI is available and usable, verify downloaded binaries:
+  - `gh attestation verify <INSTALL_PATH> --repo <REPO> 2> /dev/null`
+
+Error handling
+- Provide a helper that checks command exit codes and exits with a concise, helpful message on failure.
+
+Output formatting
+- Provide a print helper that supports:
+  - `[INFO]` (blue), `[WARNING]` (yellow), `[ERROR]` (red), `[SUCCESS]` (green), `[FAILURE]` (magenta)
+- Use `printf '%s'` and `printf '%b'`; do not use `echo`.
+- Keep messages succinct. Be verbose only on errors to aid troubleshooting.
+
+---
+
+Meta for AI contributors
+- Be conservative: do only what the prompt requests. No broad refactors.
+- Prefer small, well-named functions and staged changes.
+- Preserve existing public behavior and style unless the prompt requires changes.
+- If something cannot be done with available context/tools, state why and propose the smallest viable alternative.
 # Bash Scripting - All repos
 
 - use $BASH_SOURCE instead of $0
@@ -10,10 +111,16 @@
 - Always makes changes in stages, a modular approach.
 - use Google style guide for formatting of bash scripts - https://google.github.io/styleguide/shellguide.html
 - Always use `#!/bin/bash` as the shebang.
+- Always use the extensions `bash` for bash script and `sh` only for posix shell scripts
 - Use `printf '%s'` for printing strings and `printf '%b'` for escape sequences. **Avoid using `echo`.**
 - Comment code to explain changes and logic.
 - always prefer readability of code over complex one lines. Unless that foramt is promoted by the style guide.
 - For Bash/shell questions, consult [mywiki.wooledge.org](https://mywiki.wooledge.org) or [BashFAQ](https://mywiki.wooledge.org/BashFAQ) first. **Provide a source link when possible.**
+- Don't hallucinate <mywiki.wooledge.org> links in comments
+- think like a c developer not a javascript developer. stable, concise, elegant and thoughtful. Not edgy and bleeding edge for the sake of it.
+- when providing a solution to a prompt don't provide solutions outside the scope of the prompt nor add loads checks and fallbacks that quickly become redundant in following prompts.
+- it makes me wast premium tokens making you fix the brken things you added or changed that were outside the scope of the prompt to begin with.
+- provide changes specific to the prompt given.
 
 # GitHub Workflows - All repos
 
@@ -80,3 +187,8 @@ ouputs
 - Use `printf '%s'` for printing strings and `printf '%b'` for escape sequences. **Avoid using `echo`.**
 - this function will provide end user information understanding or troubleshooting script outcomes.
 - it should be succinct unless there is an error or failure, then it should be verbose enough to help.
+
+## Astro and Astro starlight template for documentation
+
+- Always use the mcp server https://mcp.docs.astro.build/mcp
+- Always make sure imported mdx components start with an upper case letter.

.github/workflows/ci-alpine-release.yml

@@ -56,18 +56,22 @@ jobs:
         env:
           lt_version: ${{ matrix.qbt_libtorrent_version }}
         run: |
-          revision="$(jq -r .revision ${lt_version}/*-dependency-version.json | sort -nr | head -n1)"
-          boost="$(jq -r .boost ${lt_version}/*-dependency-version.json | head -n1)"
+          shopt -s nullglob
 
-          for dependency_version_json in ${lt_version}/*-dependency-version.json; do
+          revision="$(jq -r .revision "${lt_version}"/*-dependency-version.json | sort -nr | head -n1)"
+          boost="$(jq -r .boost "${lt_version}"/*-dependency-version.json | head -n1)"
+
+          # this need to check both 1.2 and 2.0 folders to merge the libtorrent versions in the dependency-version.json
+          for dependency_version_json in {1.2,2.0}/*-dependency-version.json; do
             if [[ -f ${dependency_version_json} ]]; then
               sed -r 's/"boost": (.*)/BOOST_PLACEHOLDER/g' -i "${dependency_version_json}"
               sed -r 's/"revision": (.*)/REVISION_PLACEHOLDER/g' -i "${dependency_version_json}"
               dependency_version+=("${dependency_version_json}")
             fi
           done
 
-          for release_md in ${lt_version}/*-release.md; do
+          # This file only needs to merge info specific to the libtorrent matrix running it.
+          for release_md in "${lt_version}"/*-release.md; do
             if [[ -f ${release_md} ]]; then
               sed -r 's/^\|(.*)revision(.*)\|(.*)\|$/REVISION_PLACEHOLDER/g' -i "${release_md}"
               release_md+=("${release_md}")

README.md

@@ -57,10 +57,10 @@ You can now run it using this command:
 
 ### What You Get
 
-✅ **No installation hassles** - Single static binary
-✅ **Latest versions** - Always up-to-date dependencies
-✅ **Universal compatibility** - Runs on any Linux distro
-✅ **Multiple architectures** - Support for ARM devices too
+- ✅ **No installation hassles** - Single static binary
+- ✅ **Latest versions** - Always up-to-date dependencies
+- ✅ **Universal compatibility** - Runs on any Linux distro
+- ✅ **Multiple architectures** - Support for ARM devices too
 
 ## 📋 Table of Contents
 

changelog.md

@@ -1,4 +1,18 @@
-### v2.2.1 / v2.0.21 - 13/08/2025
+### v2.2.2 - 17/08/2025
+
+`qbt-nox-static.bash` was fully merged into `qbittorrent-nox-static.sh` so that the scripts no longer have significantly different code approaches to the same outcomes.
+
+To maintain expected behavior I only needed to make a small adjustment to the script to make it behave the same way without having to support two versions fo the same script.
+
+This essentially completes the transition from the legacy script to the current without any breaking changes.
+
+fixed:
+    - install binary function was not working correctly and has been updated.
+    - fixed building glibc in debug mode due to incorrect flags
+    - fix alpine version check properly compare versions.
+    - fixed boost version check that was creating a malformed url for github and beta releases.
+
+### v2.2.1 - 13/08/2025
 
 Debian support bumped to trixie
 
@@ -14,7 +28,7 @@ This not be an issue since `trixie` `cmake` is `3.31` or newer and `ninja-build`
 
 This makes the `qbt-cmake-ninja-crossbuilds` and `qbt-ninja-build` redundant as the script no longer depends on them.
 
-### v2.2.0 / v2.0.20 - 26/07/2025
+### v2.2.0 - 26/07/2025
 
 Context: As the qbt-musl-cross-make toolchains were being revised to properly apply `-static-pie` patches, some issues needed to be resolved that resulted in a rework of some things.
 
@@ -44,13 +58,13 @@ More consistent use if build flags and when the are applied.
 More consistent debug triggering so all parts are built in debug mode.
 caching behavior tweaked - use workflow files when it can.
 
-### v2.1.3 / v2.0.19 - 29/06/2025
+### v2.1.3 - 29/06/2025
 
 problem: when the `-lt` flag was used with libtorrent `v1.2` like `-lt v1.2.20` boost was not being defaulted to `boost-1.86.0` as it does when setting the env equivalent, causing a build error when libtorrent was built.
 
 fix: the flag now properly checks and sets boost to `boost-1.86.0` when libtorrent `v1.2` is being built via [e11d7d5](https://github.com/userdocs/qbittorrent-nox-static/commit/e11d7d51b5a0a6a99fcac6ae44c4603286e9a598)
 
-### v2.1.2 / v2.0.18 - 18/05/2025
+### v2.1.2 - 18/05/2025
 
 fix: `double_conversion` all versions - apply patch for increasing cmake bounds in `CMakeLists.txt` via this [patch](https://github.com/google/double-conversion/commit/0604b4c18815aadcf7f4b78dfa6bfcb91a634ed7)
 

docs/astro.config.mjs

@@ -1,14 +1,15 @@
 import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
 import starlightImageZoom from "starlight-image-zoom";
+import starlightGitHubAlerts from 'starlight-github-alerts'
 
 // https://astro.build/config
 export default defineConfig({
 	site: "https://userdocs.github.io",
 	base: "/qbittorrent-nox-static",
 	integrations: [
 		starlight({
-			plugins: [starlightImageZoom()],
+			plugins: [starlightImageZoom(), starlightGitHubAlerts()],
 			title: "qbittorrent-nox-static",
 			logo: {
 				src: "./public/logo-static.svg",

docs/package-lock.json

@@ -14,6 +14,7 @@
     "@expressive-code/plugin-collapsible-sections": "^0.41.3",
     "astro": "^5.6.1",
     "sharp": "^0.34.2",
+    "starlight-github-alerts": "^0.1.0",
     "starlight-image-zoom": "^0.13.0"
   },
   "devDependencies": {

docs/package.json

@@ -0,0 +1,85 @@
+<!doctype html><html lang="en"><head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Aura Output</title>
+<style>
+/* ===== Aura Dark (Soft Text) ===== */
+:root {
+  --bg: #15141b;           /* editor.background */
+  --fg: #bdbdbd;           /* editor.foreground */
+  --black: #15141b;        --red: #c55858;        --green: #54c59f;
+  --yellow: #c7a06f;       --blue: #8464c6;       --magenta: #54c59f;
+  --cyan: #8464c6;         --white: #b4b4b4;
+  --bblack: #2d2d2d;       --bred: #c7a06f;       --bgreen: #8464c6;
+  --byellow: #c7a06f;      --bblue: #8464c6;      --bmagenta: #54c59f;
+  --bcyan: #54c59f;        --bwhite: #bdbdbd;
+}
+
+/* ===== Light mode placeholder palette ===== */
+[data-theme="light"] {
+  --bg: #fdfdfd;
+  --fg: #1e1e1e;
+  --black: #000000;        --red: #c01c28;        --green: #26a269;
+  --yellow: #a2734c;       --blue: #12488b;       --magenta: #a347ba;
+  --cyan: #2aa1b3;         --white: #d0cfcc;
+  --bblack: #555753;       --bred: #f66151;       --bgreen: #33d17a;
+  --byellow: #e9ad0c;      --bblue: #3584e4;      --bmagenta: #c061cb;
+  --bcyan: #33c7de;        --bwhite: #ffffff;
+}
+
+.aura-terminal {
+  background: var(--bg);
+  color: var(--fg);
+  font-family: monospace;
+  padding: 1rem;
+  overflow-x: auto;
+  white-space: pre;
+}
+.aura-terminal span { all: unset; }
+</style>
+</head><body>
+<div class="aura-terminal">
+ <span style="filter: contrast(70%) brightness(140%);color:blue;">⬤</span> <span style="font-weight:bold;">Checking: </span><span style="font-weight:bold;filter: contrast(70%) brightness(140%);color:red;">available privileges</span>
+
+ <span style="color:green;">⬤</span> <span style="filter: contrast(70%) brightness(140%);color:red;">root</span>
+ <span style="color:red;">⬤</span> <span style="filter: contrast(70%) brightness(140%);color:red;">sudo</span>
+
+ <span style="filter: contrast(70%) brightness(140%);color:blue;">⬤</span> <span style="font-weight:bold;">Checking: </span><span style="font-weight:bold;color:olive;">test</span>
+
+ <span style="color:green;">⬤</span> <span style="color:olive;">bash</span>
+ <span style="color:red;">⬤</span> <span style="color:olive;">curl</span>
+ <span style="color:red;">⬤</span> <span style="color:olive;">git</span>
+
+ <span style="filter: contrast(70%) brightness(140%);color:blue;">⬤</span> <span style="font-weight:bold;">Checking: </span><span style="font-weight:bold;color:purple;">core</span>
+
+ <span style="color:red;">⬤</span> <span style="color:purple;">autoconf</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">automake</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">build-base</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">cmake</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">curl</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">git</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">graphviz</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">libtool</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">linux-headers</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">ninja-build</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">ninja-is-really-ninja</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">perl</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">pkgconf</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">py3-numpy</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">py3-numpy-dev</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">python3</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">python3-dev</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">re2c</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">ttf-freefont</span>
+ <span style="color:red;">⬤</span> <span style="color:purple;">xz</span>
+
+ <span style="color:blue;">⬤</span> <span style="color:blue;">Info:</span> /workspace/qbt-nox-static.bash
+
+ <span style="color:blue;">⬤</span> <span style="filter: contrast(70%) brightness(140%);color:blue;">qbt-nox-static.bash</span> <span style="color:olive;">install_test</span> ------ installs minimum required tools to run tests
+ <span style="color:blue;">⬤</span> <span style="filter: contrast(70%) brightness(140%);color:blue;">qbt-nox-static.bash</span> <span style="color:purple;">install_core</span> ------ installs required build tools to use script
+ <span style="color:blue;">⬤</span> <span style="filter: contrast(70%) brightness(140%);color:blue;">qbt-nox-static.bash</span> <span style="filter: contrast(70%) brightness(140%);color:green;">bootstrap_deps</span> ---- <span style="color:olive;">install_test</span> + <span style="color:purple;">install_core</span>
+
+ <span style="color:red;">⬤</span> <span style="color:olive;">Warning:</span> Missing required <span style="color:purple;">test_tools</span>
+
+ <span style="color:red;">⬤</span> <span style="color:olive;">Warning:</span> Missing required components of <span style="color:purple;">install_core</span>
+
+</div></body></html>