Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
blank_issues_enabled: false
contact_links:
- name: Support questions and install help
url: https://www.shadowfetch.com/downloads#shadowfetch-linux
url: https://www.shadowfetchlinux.org/docs
about: Start with the FAQ, or email linux@shadowfetchlinux.org. Use the hardware report form for install results on specific machines.
- name: Verification guide
url: https://www.shadowfetch.com/downloads#shadowfetch-linux
url: https://www.shadowfetchlinux.org/verify
about: Verify the ISO checksum, detached signature, and signing key before installing.
- name: Security model
url: https://www.shadowfetch.com/downloads#shadowfetch-linux
url: https://www.shadowfetchlinux.org/security
about: Read the Shadowfetch Linux security model and reporting guidance.
10 changes: 9 additions & 1 deletion .github/workflows/build-iso.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,10 +31,18 @@ jobs:
# behaviour.
- name: Fetch v4.0.0 for phoenix regression proofs
run: git fetch --depth=1 origin tag v4.0.0
# Ubuntu 24.04 ships the SVG image plugin in libqt6svg6 (Debian
# testing splits it into qt6-svg-plugins, used by the distro package).
- name: Install source and package test dependencies
run: |
sudo apt-get update
sudo apt-get install -y build-essential debhelper dh-python devscripts fakeroot python3 python3-yaml python3-pyqt6 python3-dbus python3-psutil shellcheck desktop-file-utils bubblewrap ffmpeg podman dbus-user-session qemu-utils qemu-system-x86 slirp4netns
sudo apt-get install -y build-essential debhelper dh-python devscripts fakeroot python3 python3-yaml python3-pyqt6 libqt6svg6 python3-dbus python3-psutil shellcheck desktop-file-utils bubblewrap ffmpeg podman dbus-user-session qemu-utils qemu-system-x86 slirp4netns
- name: Verify SVG support for Welcome indicators
run: |
python3 - <<'PY'
from PyQt6.QtGui import QImageReader
assert b"svg" in [bytes(fmt) for fmt in QImageReader.supportedImageFormats()], "Qt SVG image plugin is missing"
PY
# ubuntu-24.04 sets kernel.apparmor_restrict_unprivileged_userns=1.
# bubblewrap can still create a user+net namespace, but configuring
# loopback inside it fails with RTM_NEWADDR EPERM, so every empirical
Expand Down
20 changes: 11 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,28 +14,28 @@ ShadowCode 1.0 explains itself: every approval card says what the action does, h

Nothing is connected until you sign in. Welcome's last step opens ShadowCode so you can connect what you have. 5.0 also **changes behaviour that 4.1 setups depend on**: Fire and Ice are gone, several commands are removed, and the Fire/Ice network switch is now a separate setting. Read the [release notes](RELEASE-5.0.0.md) before upgrading.

![ShadowCode 1.0 on the Shadowfetch Linux 5.0 desktop](https://www.shadowfetch.com/downloadslinux-assets/linux-5.0.0-shadowcode.webp)
![ShadowCode 1.0 on the Shadowfetch Linux 5.0 desktop](https://www.shadowfetchlinux.org/linux-assets/linux-5.0.0-shadowcode.webp)

![Shadowfetch Linux 5.0 Welcome, with Open ShadowCode first](https://www.shadowfetch.com/downloadslinux-assets/linux-5.0.0-welcome.webp)
![Shadowfetch Linux 5.0 Welcome, with Open ShadowCode first](https://www.shadowfetchlinux.org/linux-assets/linux-5.0.0-welcome.webp)

![Mission Control 5.0 with ShadowCode, Grok Bot and Hermes & OpenClaw in the sidebar](https://www.shadowfetch.com/downloadslinux-assets/linux-5.0.0-mission-control.webp)
![Mission Control 5.0 with ShadowCode, Grok Bot and Hermes & OpenClaw in the sidebar](https://www.shadowfetchlinux.org/linux-assets/linux-5.0.0-mission-control.webp)

[Download](https://www.shadowfetch.com/downloads) · [Screenshots](https://www.shadowfetch.com/downloadsscreenshots) · [Release notes](RELEASE-5.0.0.md) · [ShadowCode](https://github.com/ShadowfetchStudio/ShadowCode)
[Download](https://www.shadowfetch.com/downloads) · [Screenshots](https://www.shadowfetchlinux.org/screenshots) · [Release notes](RELEASE-5.0.0.md) · [ShadowCode](https://github.com/ShadowfetchStudio/ShadowCode)

## Current release

| Fact | Value |
| --- | --- |
| Version / codename | 5.0.1 / Umbra |
| Edition | ShadowCode — "One Harness. All Models." |
| Publication date / channel | 2026-09-30 / stable |
| Publication date / channel | 5.0.0 ISO 2026-09-30, 5.0.1 APT update 2026-10-01 / stable |
| ISO | shadowfetch-5.0.0-amd64.iso |
| Size | 4085778432 bytes |
| SHA-256 | `2d8a72e044e8061bd616b2b4668425cc4d4ec0480a98975f961c0e58cba95e21` |
| ISO product source commit / tree | `9587a7ca348e817870baffa9d390754acf331266` / `2986e02421fc6af1353ce7e7b7695a390c724acf` |
| Base / desktop | Debian testing snapshot 20260929T000000Z / KDE Plasma 6.7.4 |
| Kernel | Linux 7.2.6 |
| ShadowCode | 1.0.0 (`shadow-code`, republished unmodified from the signed upstream `.deb`) |
| ShadowCode | 1.0.0 on the 5.0.0 ISO; the 5.0.1 update installs 1.0.1 (`shadow-code`, republished unmodified from the signed upstream `.deb`) |
| Architecture / APT suite | amd64 / `umbra` |
| Final boot acceptance | 18 prepublication cases in `qa/5.0.0/acceptance.json`, recorded against this ISO: 12 pass, 6 waived by the release owner with written reasons; `PUB-01` is proven after publication |

Expand Down Expand Up @@ -80,9 +80,9 @@ gpg --verify "$ISO.asc" "$ISO"
sha256sum --check "$ISO.sha256"
```

Continue only after the signature and checksum both verify. A GPG warning about personal key trust differs from a failed signature. Write the verified ISO with a USB image writer, then follow the [installation guide](https://www.shadowfetch.com/downloadsinstall).
Continue only after the signature and checksum both verify. A GPG warning about personal key trust differs from a failed signature. Write the verified ISO with a USB image writer, then follow the [installation guide](https://www.shadowfetchlinux.org/install).

The boot menu offers a normal entry and an "agents offline" entry; the installer carries that choice to the installed system. The live session uses `shadow` / `shadow` with passwordless sudo. The installer creates the chosen user and removes the live account. See the [verification guide](https://www.shadowfetch.com/downloads#shadowfetch-linux), [Secure Boot guide](https://www.shadowfetch.com/downloadssecure-boot) and [known issues](https://www.shadowfetch.com/downloads#shadowfetch-linux).
The boot menu offers a normal entry and an "agents offline" entry; the installer carries that choice to the installed system. The live session uses `shadow` / `shadow` with passwordless sudo. The installer creates the chosen user and removes the live account. See the [verification guide](https://www.shadowfetchlinux.org/verify), [Secure Boot guide](https://www.shadowfetchlinux.org/secure-boot) and [known issues](https://www.shadowfetchlinux.org/known-issues).

**Upgrading from 4.1 or 5.0.0 to 5.0.1:** run `sudo apt update` then `sudo apt full-upgrade` for this update (not `fireproof update`: the Fireproof on 4.1 and 5.0.0 can stop partway when it updates itself). From 5.0.1 on, `fireproof update` is safe again and never removes packages. Read the [release notes](RELEASE-5.0.0.md) first; the upgrade removes `shadowfetch-element`, `shadowfetch-codex` and `shadowfetch-code-agent`, and moves an Ice machine to the offline agent network.

Expand Down Expand Up @@ -139,4 +139,6 @@ Patches to packages, build tools, tests and documentation are welcome. Run `make

The ISO aggregates upstream packages under their respective licenses. Each Shadowfetch package states its license in its `debian/copyright`: Shadowfetch's own packages (and the packaged `grub-btrfs`) are GPL-3.0-or-later, matching this repository's [LICENSE](LICENSE); the Breeze-derived `shadowfetch-themes` is LGPL-2.1-or-later. The DrKonqi pickup helper's own code and packaging use **GPL-3.0-only**; its compiled KDE source retains **GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL**, and its source package includes the upstream archive, signature, release key and downstream patch. ShadowCode is **Apache-2.0** and its bundled components keep their own licenses; its corresponding source is published beside the APT repository under `pool/third-party-source/shadow-code/`. Other upstream source retains its original license notices. Shadowfetch and Umbra names, marks and artwork are reserved under [TRADEMARKS.md](TRADEMARKS.md); rebrand derivative distributions. Optional vendor applications retain their own licenses and terms. Shadowfetch Linux is independent and does not imply Debian or vendor endorsement.

[Docs](https://www.shadowfetch.com/downloads#shadowfetch-linux) · [Security model](https://www.shadowfetch.com/downloads#shadowfetch-linux) · [Release feed](https://www.shadowfetch.com/downloadsreleases.json) · [Previous 4.1 release](RELEASE-4.1.0.md)
Like this project? You can [buy me a coffee](https://www.buymeacoffee.com/shadowfetcu).

[Docs](https://www.shadowfetchlinux.org/docs) · [Security model](https://www.shadowfetchlinux.org/security) · [Release feed](https://www.shadowfetchlinux.org/releases.json) · [Previous 4.1 release](RELEASE-4.1.0.md)
2 changes: 1 addition & 1 deletion next-release/3.6-secure-boot.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Public source of truth today:
Issue #4 still calls it “#1” from the 3.5 known-issues list. A
numbering change is not a claim change. The caveat stays published
until a named Secure-Boot-on test passes.
- [Secure Boot guide](https://www.shadowfetch.com/downloadssecure-boot)
- [Secure Boot guide](https://www.shadowfetchlinux.org/secure-boot)
- Repo README hardware-and-limits line, same claim
- `docs/GITHUB-CLAIM-SOURCES.md` — do not claim Secure Boot support
unless a signed-boot test is added and passes
Expand Down
Loading