chore: major docs update, image migration, and site modernization

.github/workflows/pr-checks.yml

@@ -133,5 +133,6 @@ jobs:
           args: >-
             --offline
             --include-fragments
+            --root-dir ./public
             public/**/*.html
           fail: true

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "themes/hextra"]
-	path = themes/hextra
-	url = https://github.com/imfing/hextra.git

CONTRIBUTING.md

@@ -1,5 +1,9 @@
 # Contributing
 
+Also own a ROG Zephyrus device and are running Linux? And want to contribute or give opinions and/or tips? Issues and Pull Requests are welcome!
+
+---
+
 ## Commit messages
 
 This project uses [Conventional Commits](https://www.conventionalcommits.org/).

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Sten Tijhuis
+Copyright (c) 2026 Stensel8
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -2,18 +2,18 @@
 
 English | [Nederlands](README.nl.md)
 
-Fedora 43 on the ASUS ROG Zephyrus G16 GA605WV (2024). My personal setup log — documenting what worked, what didn't, and how I fixed it.
+CachyOS on the ASUS ROG Zephyrus G16 GA605WV (2024). My personal setup log — documenting what worked, what didn't, and how I fixed it.
 
-**Browse the full documentation site: [zephyrus-linux.stentijhuis.nl](https://zephyrus-linux.stentijhuis.nl/)**
+**Browse the full documentation site: [zephyrus-linux.stensel.nl](https://zephyrus-linux.stensel.nl/)**
 
 
 ## About this project
 
-This is my personal setup log for running Fedora Linux on this laptop. I'm not a software engineer or developer — just someone who switched to Linux and ran into a lot of things that didn't work out of the box. I figured I'd write it all down so others don't have to go through the same trial and error I did.
+This is my personal setup log for running CachyOS on this laptop. I'm not a software engineer or developer — just someone who switched to Linux and ran into a lot of things that didn't work out of the box. I figured I'd write it all down so others don't have to go through the same trial and error I did.
 
 I'm still actively testing and experimenting — things may change, break, or turn out to be wrong. Everything here is based on my own experience and should be taken as-is, at your own risk.
 
-I am not affiliated with, endorsed by, or acting on behalf of ASUS, NVIDIA, Microsoft, Fedora, or any other company or project mentioned here.
+I am not affiliated with, endorsed by, or acting on behalf of ASUS, NVIDIA, Microsoft, CachyOS, or any other company or project mentioned here.
 
 
 ## System specs
@@ -24,8 +24,8 @@ I am not affiliated with, endorsed by, or acting on behalf of ASUS, NVIDIA, Micr
 | **CPU** | AMD Ryzen AI 9 HX 370 |
 | **iGPU** | AMD Radeon 890M |
 | **dGPU** | NVIDIA GeForce RTX 4060 Laptop (Max-Q) |
-| **OS** | Fedora 43 |
-| **Kernel** | 6.18+ |
+| **OS** | CachyOS |
+| **Kernel** | 6.19.3-2-cachyos |
 | **Desktop** | GNOME 49 / Wayland |
 | **Secure Boot** | Enabled |
 
@@ -35,8 +35,14 @@ I am not affiliated with, endorsed by, or acting on behalf of ASUS, NVIDIA, Micr
 This documentation site is built with [Hugo](https://gohugo.io/) using the [Hextra](https://imfing.github.io/hextra/) theme. The theme is included as a git submodule.
 
 **Prerequisites:**
-- [Hugo extended](https://gohugo.io/installation/) (v0.152.2 or later)
+- [Hugo extended](https://gohugo.io/installation/) v0.156.0 (built with this version)
 - Git
+- Visual Studio Code
+
+On Arch Linux / CachyOS:
+```bash
+sudo pacman -S hugo
+```
 
 **Clone with submodules:**
 ```bash
@@ -64,13 +70,33 @@ hugo --gc --minify
 The output is written to `./public/`. On push to `main`, GitHub Actions builds and deploys to GitHub Pages automatically.
 
 
+## Image assets
+
+All images in this repository use the [AVIF](https://en.wikipedia.org/wiki/AVIF) format — open, royalty-free, and more efficient than PNG or JPEG at equivalent quality. AVIF is the modern standard for web images.
+
+To convert PNG screenshots to AVIF, install `avifenc` from the `libavif` package:
+
+```bash
+sudo pacman -S libavif
+```
+
+Batch convert all PNGs in `static/images/` (converts and removes originals):
+
+```bash
+cd static/images
+for f in *.png; do avifenc -q 80 -s 6 "$f" "${f%.png}.avif" && rm "$f"; done
+```
+
+- `-q 80` — 80% quality (0–100 scale, 100 = lossless)
+- `-s 6` — encoder speed (0 = best compression, 10 = fastest)
+
+
 ## Credits & resources
 
 This project wouldn't exist without the work of these people and communities:
 
-- **[Luke Jones](https://asus-linux.org/)** — Creator of `asusctl`, `rog-control-center`, and the `asus-armoury` kernel driver. The ASUS Linux project is the reason modern ASUS laptops work well on Linux at all.
-- **[RPM Fusion](https://rpmfusion.org/)** — Provides the packaged NVIDIA proprietary drivers for Fedora, making installation and Secure Boot enrollment straightforward.
-- **[Fedora Project](https://fedoraproject.org/)** — The distribution itself, with excellent hardware support and a fast release cycle.
+- **[Luke Jones](https://asus-linux.org/)** — Creator of `asusctl`, `rog-control-center`, and the `asus-armoury` kernel driver. The ASUS Linux project is the reason modern ASUS laptops work well on Linux at all. His patches have been merged into CachyOS, making it the best supported distribution for ASUS ROG hardware.
+- **[CachyOS](https://cachyos.org/)** — The distribution powering this setup. CachyOS is an Arch-based distro with extensive hardware-specific optimizations: an improved scheduler (BORE/EEVDF), better power management, dynamic refresh rate support, and built-in drivers for both the AMD iGPU and NVIDIA dGPU — including integrated GPU switching. Of all the distributions I tested (including Fedora, which came close), CachyOS is by far the strongest on this device.
 - **[lz42/libinput-config](https://github.com/lz42/libinput-config)** — Third-party workaround for GNOME/Wayland's missing scroll speed setting.
 - **[Looking Glass](https://looking-glass.io/)** — Low-latency VM display project. Didn't work on this hardware, but the project and documentation are excellent.
 - **[Mastermindzh/tidal-hifi](https://github.com/Mastermindzh/tidal-hifi)** — Community Electron client for Tidal on Linux.

README.nl.md

@@ -2,18 +2,18 @@
 
 Nederlands | [English](README.md)
 
-Fedora 43 op de ASUS ROG Zephyrus G16 GA605WV (2024). Mijn persoonlijke setup-log — wat werkte, wat niet, en hoe ik het heb opgelost.
+CachyOS op de ASUS ROG Zephyrus G16 GA605WV (2024). Mijn persoonlijke setup-log — wat werkte, wat niet, en hoe ik het heb opgelost.
 
-**Bekijk de volledige documentatiesite: [zephyrus-linux.stentijhuis.nl](https://zephyrus-linux.stentijhuis.nl/nl/)**
+**Bekijk de volledige documentatiesite: [zephyrus-linux.stensel.nl](https://zephyrus-linux.stensel.nl/nl/)**
 
 
 ## Over dit project
 
-Dit is mijn persoonlijke setup-log voor Fedora Linux op deze laptop. Ik ben geen software-engineer of developer — gewoon iemand die naar Linux is overgestapt en daarna tegen van alles aanliep wat niet meteen werkte. Ik heb alles opgeschreven zodat anderen niet hetzelfde hoeven uitzoeken als ik.
+Dit is mijn persoonlijke setup-log voor CachyOS op deze laptop. Ik ben geen software-engineer of developer — gewoon iemand die naar Linux is overgestapt en daarna tegen van alles aanliep wat niet meteen werkte. Ik heb alles opgeschreven zodat anderen niet hetzelfde hoeven uitzoeken als ik.
 
 Ik ben nog actief aan het testen en experimenteren — dingen kunnen veranderen, kapot gaan of achteraf onjuist blijken. Alles wat hier staat is gebaseerd op mijn eigen ervaring en is op eigen risico.
 
-Ik ben niet gelieerd aan, goedgekeurd door, of handelend namens ASUS, NVIDIA, Microsoft, Fedora, of enig ander bedrijf of project dat hier wordt genoemd.
+Ik ben niet gelieerd aan, goedgekeurd door, of handelend namens ASUS, NVIDIA, Microsoft, CachyOS, of enig ander bedrijf of project dat hier wordt genoemd.
 
 
 ## Systeemspecificaties
@@ -24,8 +24,8 @@ Ik ben niet gelieerd aan, goedgekeurd door, of handelend namens ASUS, NVIDIA, Mi
 | **CPU** | AMD Ryzen AI 9 HX 370 |
 | **iGPU** | AMD Radeon 890M |
 | **dGPU** | NVIDIA GeForce RTX 4060 Laptop (Max-Q) |
-| **OS** | Fedora 43 |
-| **Kernel** | 6.18+ |
+| **OS** | CachyOS |
+| **Kernel** | 6.19.3-2-cachyos |
 | **Desktop** | GNOME 49 / Wayland |
 | **Secure Boot** | Ingeschakeld |
 
@@ -35,9 +35,14 @@ Ik ben niet gelieerd aan, goedgekeurd door, of handelend namens ASUS, NVIDIA, Mi
 Deze documentatiesite is gebouwd met [Hugo](https://gohugo.io/) en het [Hextra](https://imfing.github.io/hextra/)-thema. Het thema is opgenomen als git submodule.
 
 **Vereisten:**
-- [Hugo extended](https://gohugo.io/installation/) (v0.152.2 of later)
+- [Hugo extended](https://gohugo.io/installation/) v0.156.0 (gebouwd met deze versie)
 - Git
 
+Op Arch Linux / CachyOS:
+```bash
+sudo pacman -S hugo
+```
+
 **Clone met submodules:**
 ```bash
 git clone --recurse-submodules https://github.com/Stensel8/Zephyrus-Linux.git
@@ -64,13 +69,33 @@ hugo --gc --minify
 De output wordt geschreven naar `./public/`. Bij een push naar `main` bouwt GitHub Actions de site automatisch en deployt naar GitHub Pages.
 
 
+## Afbeeldingen
+
+Alle afbeeldingen in deze repository gebruiken het [AVIF](https://nl.wikipedia.org/wiki/AVIF)-formaat — open, royaltyvrij en efficiënter dan PNG of JPEG bij vergelijkbare kwaliteit. AVIF is de moderne standaard voor webafbeeldingen.
+
+Installeer `avifenc` uit het `libavif`-pakket om PNG-screenshots om te zetten naar AVIF:
+
+```bash
+sudo pacman -S libavif
+```
+
+Batch-conversie van alle PNGs in `static/images/` (converteert en verwijdert de originelen):
+
+```bash
+cd static/images
+for f in *.png; do avifenc -q 80 -s 6 "$f" "${f%.png}.avif" && rm "$f"; done
+```
+
+- `-q 80` — 80% kwaliteit (schaal 0–100, 100 = verliesvrij)
+- `-s 6` — encodersnelheid (0 = beste compressie, 10 = snelst)
+
+
 ## Credits & bronnen
 
 Dit project zou niet bestaan zonder het werk van deze mensen en communities:
 
-- **[Luke Jones](https://asus-linux.org/)** — Maker van `asusctl`, `rog-control-center` en de `asus-armoury` kernel driver. Het ASUS Linux project is de reden dat moderne ASUS laptops goed werken op Linux.
-- **[RPM Fusion](https://rpmfusion.org/)** — Levert de verpakte NVIDIA proprietary drivers voor Fedora, waardoor installatie en Secure Boot enrollment eenvoudig zijn.
-- **[Fedora Project](https://fedoraproject.org/)** — De distributie zelf, met uitstekende hardware-ondersteuning en een snelle release-cyclus.
+- **[Luke Jones](https://asus-linux.org/)** — Maker van `asusctl`, `rog-control-center` en de `asus-armoury` kernel driver. Het ASUS Linux project is de reden dat moderne ASUS laptops goed werken op Linux. Zijn patches zijn gemerged in CachyOS, waardoor dit de best ondersteunde distributie is voor ASUS ROG hardware.
+- **[CachyOS](https://cachyos.org/)** — De distributie die deze setup aandrijft. CachyOS is een op Arch gebaseerde distro met uitgebreide hardware-specifieke optimalisaties: een verbeterde scheduler (BORE/EEVDF), beter energiebeheer, ondersteuning voor dynamische verversingsfrequentie, en ingebouwde drivers voor zowel de AMD iGPU als de NVIDIA dGPU — inclusief geïntegreerde GPU-switching. Van alle distributies die ik getest heb (waaronder Fedora, dat dicht in de buurt kwam), is CachyOS veruit de sterkste op dit apparaat.
 - **[lz42/libinput-config](https://github.com/lz42/libinput-config)** — Third-party workaround voor de ontbrekende scroll speed-instelling in GNOME/Wayland.
 - **[Looking Glass](https://looking-glass.io/)** — Low-latency VM display project. Werkt niet op deze hardware, maar het project en de documentatie zijn uitstekend.
 - **[Mastermindzh/tidal-hifi](https://github.com/Mastermindzh/tidal-hifi)** — Community Electron-client voor Tidal op Linux.

content/_index.md

@@ -11,7 +11,7 @@ toc: false
 
 <div class="hx-mb-12">
 {{< hextra/hero-subtitle >}}
-  What I learned running Fedora 43 on my Zephyrus — and what I wish someone had told me
+  Personal Linux setup and configuration notes for the ROG Zephyrus G16
 {{< /hextra/hero-subtitle >}}
 </div>
 
@@ -25,29 +25,9 @@ toc: false
 <div class="hx-mt-6"></div>
 
 {{< callout type="info" >}}
-**Personal documentation.** I'm not a developer or Linux expert — just someone who switched to Linux on this laptop and figured things out along the way. I share what worked for me so others don't have to start from scratch. Everything here is at your own risk. Feel free to reach out if something doesn't work; I'm happy to think along. Requires kernel 6.18+.
+**Personal documentation.** I'm not a developer or Linux expert — just someone who switched to Linux on this laptop and figured things out along the way. I share what worked for me so others don't have to start from scratch. Everything here is at your own risk. Feel free to reach out if something doesn't work; I'm happy to think along. Running kernel 6.19.3-2 on CachyOS (Arch).
 {{< /callout >}}
 
-## News
-
-### Kernel 7.0: ASUS laptop quirks + newer AMDGPU enablement
-
-Linus confirmed the next kernel will be 7.0, with the merge window now open and a stable release expected mid-April 2026. For this ASUS ROG G16, the headline is better graphics driver coverage: the DRM updates bring AMDGPU enablement for newer RDNA 3.5-class IP blocks (GFX11.5.4) plus ongoing NVIDIA Nova/Nouveau work, which should translate into better handling of both the iGPU and dGPU. Early expectations are that the Radeon 890M could see around a 20% uplift moving from kernel 6.18 to 7.0. Not a drop-in upgrade for Fedora 43 yet, but a good sign for upcoming releases.
-
-**Sources:** [Linus confirms Linux 7.0](https://www.phoronix.com/news/Linux-7.0-Is-Next) · [HID laptop quirks for ASUS ROG models](https://www.phoronix.com/news/Linux-7.0-HID) · [Linux 7.0 DRM/AMDGPU updates](https://www.phoronix.com/news/Linux-7.0-Graphics-Drivers)
-
-### Kernel 6.19: asus-armoury driver lands in mainline
-
-The `asus-armoury` driver has been [merged into Linux 6.19](https://www.phoronix.com/news/ASUS-Armoury-Driver-Linux-6.19). This new `platform/x86` driver replaces parts of the older `asus-wmi` with a cleaner sysfs-based API, enabling panel mode switching, APU memory allocation, PPT tuning, and more directly from the kernel. The driver is entirely community-developed by [Luke Jones](https://asus-linux.org/) (ASUS Linux project), with no involvement from ASUS themselves. It's not just for handhelds like the ROG Ally; any recent ASUS gaming laptop benefits, including features in ROG Control Center like power limit adjustments.
-
-Currently on kernel 6.18, the driver is not yet available:
-
-![ROG Control showing asus-armoury driver not loaded](/images/rog-control-armoury.avif)
-
-Fedora 44 is expected to ship with kernel 6.19, bringing native asus-armoury support.
-
-**Sources:** [Phoronix article](https://www.phoronix.com/news/ASUS-Armoury-Driver-Linux-6.19) · [Community discussion](https://www.phoronix.com/forums/forum/software/linux-gaming/1593500-asus-armoury-driver-set-to-be-introduced-in-linux-6-19) · [Patch series (lore.kernel.org)](https://lore.kernel.org/all/20251102215319.3126879-1-denis.benato@linux.dev/)
-
 ## Current System Configuration
 
 | Component | Specification |
@@ -56,66 +36,99 @@ Fedora 44 is expected to ship with kernel 6.19, bringing native asus-armoury sup
 | **CPU** | AMD Ryzen AI 9 HX 370 |
 | **iGPU** | AMD Radeon 890M |
 | **dGPU** | NVIDIA GeForce RTX 4060 Laptop (Max-Q) |
-| **OS** | Fedora 43 |
-| **Kernel** | 6.18.10-200.fc43.x86_64 |
+| **OS** | CachyOS (Arch) |
+| **Kernel** | 6.19.3-2 |
 | **Display Server** | Wayland (GNOME 49) |
+| **CPU Scheduler** | scx_lavd (sched_ext) |
 | **Secure Boot** | Enabled |
 
 ## Getting Started
 
 {{< hextra/feature-grid >}}
   {{< hextra/feature-card
     title="Getting Started"
-    subtitle="From fresh Fedora install to fully configured system"
+    subtitle="From fresh CachyOS install to fully configured system"
     icon="play"
     link="docs/getting-started"
   >}}
 {{< /hextra/feature-grid >}}
 
-## Reference Guides
+## Hardware & Drivers
 
 {{< hextra/feature-grid >}}
   {{< hextra/feature-card
     title="NVIDIA Driver Installation"
-    subtitle="Proprietary NVIDIA drivers with Secure Boot on Fedora 43"
+    subtitle="Proprietary NVIDIA drivers with Secure Boot on CachyOS"
     icon="chip"
-    link="docs/nvidia-driver-installation"
+    link="docs/hardware/nvidia-driver-installation"
   >}}
   {{< hextra/feature-card
-    title="Windows 11 VM Setup"
-    subtitle="KVM/QEMU VM with VirtIO and SPICE GL"
-    icon="desktop-computer"
-    link="docs/vm-setup"
+    title="Secure Boot"
+    subtitle="Custom signing keys with sbctl, HSI:3 to HSI:4"
+    icon="shield-check"
+    link="docs/hardware/secure-boot"
   >}}
   {{< hextra/feature-card
-    title="GDM Autologin"
-    subtitle="Skip GDM login after LUKS unlock"
-    icon="lock-open"
-    link="docs/autologin"
+    title="asusctl & ROG Control Center"
+    subtitle="Fan curves, performance profiles, GPU switching, Slash LED"
+    icon="adjustments"
+    link="docs/hardware/asusctl-rog-control"
   >}}
+{{< /hextra/feature-grid >}}
+
+## Security & Privacy
+
+{{< hextra/feature-grid >}}
   {{< hextra/feature-card
     title="YubiKey 5C NFC"
     subtitle="FIDO2 LUKS unlock and what currently works"
     icon="key"
-    link="docs/yubikey"
+    link="docs/security/yubikey"
   >}}
   {{< hextra/feature-card
-    title="Looking Glass Attempt"
-    subtitle="GPU passthrough attempt, not working on this hardware"
-    icon="eye"
-    link="docs/looking-glass-attempt"
+    title="GDM Autologin"
+    subtitle="Skip GDM login after LUKS unlock"
+    icon="lock-open"
+    link="docs/security/autologin"
   >}}
+{{< /hextra/feature-grid >}}
+
+## Applications
+
+{{< hextra/feature-grid >}}
   {{< hextra/feature-card
-    title="asusctl & ROG Control Center"
-    subtitle="Fan curves, performance profiles, GPU switching, Slash LED"
-    icon="adjustments"
-    link="docs/asusctl-rog-control"
+    title="Applications"
+    subtitle="Browser, communication, development tools, and system configuration"
+    icon="collection"
+    link="docs/applications"
   >}}
+{{< /hextra/feature-grid >}}
+
+## Networking
+
+{{< hextra/feature-grid >}}
   {{< hextra/feature-card
     title="eduroam Network Installation"
     subtitle="PEAP/MSCHAPv2 setup that actually works on Linux"
     icon="wifi"
-    link="docs/eduroam-network-installation"
+    link="docs/networking/eduroam-network-installation"
+  >}}
+{{< /hextra/feature-grid >}}
+
+## Virtualization
+
+{{< hextra/feature-grid >}}
+  {{< hextra/feature-card
+    title="Windows 11 VM Setup"
+    subtitle="KVM/QEMU VM with VirtIO and SPICE GL"
+    icon="desktop-computer"
+    link="docs/virtualization/vm-setup"
+  >}}
+  {{< hextra/feature-card
+    title="Looking Glass Attempt"
+    subtitle="GPU passthrough attempt, not working on this hardware"
+    icon="eye"
+    link="docs/virtualization/looking-glass-attempt"
   >}}
 {{< /hextra/feature-grid >}}