docs: specifies the offline new workaround (#282)

* docs: specifies the offline new workaround

* docs: add joaozinho to the authors of the pyproject and update changelog

* fix:depandabot cve/21

refs #21

* chore: apply qlrd pr suggestions about lint in .md

Co-authored-by: qlrd <106913782+qlrd@users.noreply.github.com>

---------

Co-authored-by: qlrd <106913782+qlrd@users.noreply.github.com>

Author: joaozinhom

CHANGELOG.md

@@ -1,5 +1,13 @@
 # CHANGELOG
 
+## Unreleased
+
+- Removed the entire runtime download pipeline left over from the online workflow, now that firmware is embedded at build time:
+  - download screens (`base_download_screen`, `download_stable_zip_screen`, `download_beta_screen`), version selection screens (`select_version_screen`, `select_old_version_screen`) and the `warning_beta` / `warning_already_downloaded` / `unzip_stable` screens`;
+  - `downloader`, `selector` and `unzip` utils, plus the `check_verifyer`;
+  - the associated unit and E2E tests and their orphaned i18n strings;
+- With this cleanup the installer makes **no network calls at runtime** and no longer checks the internet connection on startup — the user flow is now just: open the installer, select a device and flash.
+
 ## 0.0.23
 
 - Replace `requests` with `curl` in the firmware fetch step, eliminating the

README.md

@@ -10,31 +10,52 @@
 Krux Installer is a GUI based tool to flash [Krux](https://github.com/selfcustody/krux)
 without typing any command in terminal for [flash the firmware onto the device](https://selfcustody.github.io/krux/getting-started/installing/#flash-the-firmware-onto-the-device).
 
+## Works offline
+
+Since `v0.0.22`, Krux Installer runs **fully offline**. The Krux firmware binaries are bundled inside the installer at build time, so it no longer contacts GitHub at runtime — no internet connection is required to flash your device.
+
+### What changed
+
+Earlier versions fetched the firmware over the network: the installer queried GitHub for the available releases, let you pick a version, then downloaded, verified and unzipped the assets before flashing. All of that runtime networking has been removed. The installer no longer:
+
+- checks your internet connection on startup;
+- queries GitHub for the list of available firmware versions;
+- downloads, verifies or unzips firmware assets on your machine.
+
+Instead, each release ships with a single firmware version already embedded, verified and unpacked inside the binary. The user flow is now simply: **open the installer → select your device → flash**.
+
+### Choosing a firmware version
+
+Each release ships with a fixed firmware version embedded in the binary
+(the current one is `v26.03.0`). To flash a different firmware version,
+download the installer release that bundles it, or build from source with
+your desired version (see [Firmware embedding (for developers)](/#firmware-embedding-for-developers)).
+
 ## Installing
 
 [<img src="img/badge_github.png" alt="github releases page" width="186">](https://github.com/selfcustody/krux-installer/releases)
 
 Available for:
 
-* Linux:
-  * Debian-like;
-  * Fedora-like;
-  * In the experimental phase, we have a nix flake for development.
-* Windows;
-* MacOS:
-  * intel processors;
-  * arm64 processors (M1/M2/M3/M4).
+- Linux:
+  - Debian-like;
+  - Fedora-like;
+  - In the experimental phase, we have a nix flake for development.
+- Windows;
+- MacOS:
+  - intel processors;
+  - arm64 processors (M1/M2/M3/M4).
 
 ## Build from source
 
-* [System setup](/#system-setup)
-  * [Linux](/#linux)
-  * [Windows](/#windows)
-  * [MacOS](/#macos)
-  * [Install UV](/#install-UV)
-* [Download sources](/#download-sources)
-* [Update code](/#update-code)
-* [Developing](/#developing)
+- [System setup](/#system-setup)
+  - [Linux](/#linux)
+  - [Windows](/#windows)
+  - [MacOS](/#macos)
+  - [Install UV](/#install-UV)
+- [Download sources](/#download-sources)
+- [Update code](/#update-code)
+- [Developing](/#developing)
 
 ## System setup
 
@@ -211,9 +232,9 @@ uv run poe build-win
 It will export all project in a
 [`one-file`](https://pyinstaller.org/en/stable/usage.html#cmdoption-F) binary:
 
-* linux: `./dist/krux-installer`
-* macOS: `./dist/krux-installer.app/Contents/MacOS/krux-installer`
-* windows: `./dist/krux-installer.exe`
+- linux: `./dist/krux-installer`
+- macOS: `./dist/krux-installer.app/Contents/MacOS/krux-installer`
+- windows: `./dist/krux-installer.exe`
 
 To more options see [.ci/create-spec.py](./.ci/create-spec.py) against the PyInstaller
 [options](https://pyinstaller.org).

pyproject.toml

@@ -3,7 +3,8 @@ name = "krux-installer"
 version = "0.0.22"
 description = "A GUI based application to flash Krux firmware on K210 based devices"
 authors = [
-    {name = "qlrd", email = "qlrddev@gmail.com"}
+    {name = "qlrd", email = "qlrddev@gmail.com"},
+    {name = "joaozinhom", email = "joaomcr@proton.me"}
 ]
 license = {text = "MIT"}
 readme = "README.md"