Skip to content

Commit dcdebf6

Browse files
Stensel8CopilotCopilot
authored
docs: Add VMWare Workstation 25H2 docs, chore: restructure content (#41)
## Summary Global restructuring and additions of content. Solved a few bugs, added a new section about running VMWare Workstation 25H2 on Linux. Corrected some typo's, moved content. etc. ## Type of change <!-- Check all that apply --> - [x] `fix` — bug fix (broken link, incorrect command, layout issue) - [x] `content` — update or improve existing content - [x] `docs` — changes to CONTRIBUTING, README, or meta documentation - [x] `chore` — maintenance (dependencies, config, CI/CD) > [PR title and commit types must follow these standards — view the contributing guide](https://github.com/Stensel8/Zephyrus-Linux/blob/main/CONTRIBUTING.md#commit-messages) ## Checklist - [x] PR title follows the commit convention (e.g. `fix: correct nmcli command in eduroam guide`) - [x] Both EN and NL versions updated (if applicable) - [x] Media is in AVIF format (not PNG/JPG) - [x] No broken image references (`/images/*.avif` all exist in `static/images/`) - [x] Tested locally with `hugo server` --------- Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
1 parent cbde412 commit dcdebf6

42 files changed

Lines changed: 1452 additions & 1202 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/pr-checks.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ jobs:
1515
name: Conventional commit title
1616
runs-on: ubuntu-latest
1717
steps:
18-
- uses: amannn/action-semantic-pull-request@v6
18+
- uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6
1919
env:
2020
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
2121
with:
@@ -35,7 +35,7 @@ jobs:
3535
runs-on: ubuntu-latest
3636
steps:
3737
- uses: actions/checkout@v6
38-
- uses: DavidAnson/markdownlint-cli2-action@v22
38+
- uses: DavidAnson/markdownlint-cli2-action@07035fd053f7be764496c0f8d8f9f41f98305101 # v22
3939
with:
4040
globs: "content/**/*.md"
4141

@@ -187,7 +187,7 @@ jobs:
187187
name: hugo-public
188188
path: public/
189189
- name: Check internal links
190-
uses: lycheeverse/lychee-action@v2
190+
uses: lycheeverse/lychee-action@8646ba30535128ac92d33dfc9133794bfdd9b411 # v2
191191
with:
192192
args: >-
193193
--offline

assets/css/custom.css

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -103,12 +103,6 @@
103103
margin-top: 3.5rem !important;
104104
}
105105

106-
/* Terminal screenshots are transparent — give them a dark background in light mode
107-
so anti-aliased text renders correctly regardless of theme */
108-
html:not(.dark) .content img[src*="system-info"] {
109-
background-color: #1c1b20;
110-
border-radius: 6px;
111-
}
112106

113107
/* Language/theme controls live in the navbar — hide sidebar and footer duplicates */
114108
.hextra-sidebar-container > [data-toggle-animation="show"] {

content/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ toc: false
3838
| **iGPU** | AMD Radeon 890M |
3939
| **dGPU** | NVIDIA GeForce RTX 4060 Laptop (Max-Q) |
4040
| **OS** | CachyOS (Arch) |
41-
| **Kernel** | 6.19.4-2 |
41+
| **Kernel** | 6.19.8-1-cachyos |
4242
| **Display Server** | Wayland (GNOME 49) |
4343
| **CPU Scheduler** | scx_lavd (sched_ext) |
4444
| **Secure Boot** | Enabled |

content/_index.nl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ toc: false
3838
| **iGPU** | AMD Radeon 890M |
3939
| **dGPU** | NVIDIA GeForce RTX 4060 Laptop (Max-Q) |
4040
| **OS** | CachyOS (Arch) |
41-
| **Kernel** | 6.19.4-2 |
41+
| **Kernel** | 6.19.8-1-cachyos |
4242
| **Display Server** | Wayland (GNOME 49) |
4343
| **CPU Scheduler** | scx_lavd (sched_ext) |
4444
| **Secure Boot** | Ingeschakeld |

content/docs/applications.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,7 @@ Password manager. Available via Flathub and works well.
185185

186186
### Signal Messenger
187187

188-
Signal is my main messaging app. The [CachyOS extra repository](https://packages.cachyos.org/package/extra/x86_64/signal-desktop) ships a native package, which is what I use and it works better than the Flatpak.
188+
Signal is my main messaging app. The [CachyOS extra repository](https://packages.cachyos.org/package/extra/x86_64/signal-desktop) ships a native package, which is what I use; it works better than the Flatpak.
189189

190190
**CachyOS / Arch (recommended):**
191191

@@ -444,7 +444,7 @@ flatpak install flathub com.usebottles.bottles
444444

445445
Alternatively, open GNOME Software Center, search for "Bottles", and make sure to select the **Flathub** source.
446446

447-
For anything that doesn't work under Wine (like Microsoft 365), I use a Windows VM instead. See [Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}}).
447+
For anything that doesn't work under Wine (like Microsoft 365), I use a Windows VM instead. See [Virt-Manager / KVM]({{< relref "/docs/virtualization/vm-setup" >}}).
448448

449449
![Bottles in the Flathub store](/images/bottles-flathub.avif)
450450

content/docs/applications.nl.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ gsettings set org.gnome.desktop.wm.preferences button-layout 'appmenu:minimize,m
4949

5050
### GNOME-sneltoetsen: meer als Windows
5151

52-
Als je vanuit Windows komt, voelt een paar dingen meteen anders zonder de juiste sneltoetsen. Dit zijn de sneltoetsen die ik heb ingesteld.
52+
Als je vanuit Windows komt, voelen een paar dingen meteen anders zonder de juiste sneltoetsen. Dit zijn de sneltoetsen die ik heb ingesteld.
5353

5454
**Ingebouwde sneltoetsen (via Settings > Keyboard > Keyboard Shortcuts):**
5555

@@ -185,7 +185,7 @@ Wachtwoordbeheerder. Beschikbaar via Flathub en werkt goed.
185185

186186
### Signal Messenger
187187

188-
Signal is mijn belangrijkste berichtenapp. De [CachyOS extra-repository](https://packages.cachyos.org/package/extra/x86_64/signal-desktop) levert een native pakket, wat ik gebruik en het werkt beter dan de Flatpak.
188+
Signal is mijn belangrijkste berichtenapp. De [CachyOS extra-repository](https://packages.cachyos.org/package/extra/x86_64/signal-desktop) levert een native pakket dat ik gebruik; het werkt beter dan de Flatpak.
189189

190190
**CachyOS / Arch (aanbevolen):**
191191

@@ -271,7 +271,7 @@ sudo pacman -S libreoffice-fresh
271271

272272
**APA-verwijzingen: ingebouwd**
273273

274-
Anders dan OnlyOffice heeft LibreOffice een ingebouwde bibliografiedatabase en referentie-invoeg functie. Je kunt je bronnen beheren en citaten in APA-stijl invoegen direct vanuit de menu's:
274+
Anders dan OnlyOffice heeft LibreOffice een ingebouwde bibliografiedatabase en referentie-invoegfunctie. Je kunt je bronnen beheren en citaten in APA-stijl invoegen direct vanuit de menu's:
275275

276276
![LibreOffice bibliografiebeheerder](/images/libreoffice-bibliograpy.avif)
277277

@@ -315,7 +315,7 @@ Beschikbaar in de [CachyOS extra-repository](https://packages.cachyos.org/packag
315315

316316
Ik onderteken mijn Git commits en tags met een GPG-sleutel. Kleopatra maakt het aanmaken en beheren van sleutels makkelijk via een GUI.
317317

318-
Na het installeren van VS Code en Git, installeer Kleopatra en maak je sleutels daarin aan. Daarna Git configureren:
318+
Na het installeren van VS Code en Git, installeer Kleopatra en maak je sleutels daarin aan. Daarna configureer je Git:
319319

320320
```bash
321321
git config --global user.name "JOUW_NAAM"
@@ -444,7 +444,7 @@ flatpak install flathub com.usebottles.bottles
444444

445445
Je kunt ook GNOME Software Center openen, zoeken naar "Bottles" en er zeker van zijn dat je de **Flathub** bron selecteert.
446446

447-
Voor wat niet werkt onder Wine (zoals Microsoft 365), gebruik ik een Windows VM. Zie [Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}}).
447+
Voor wat niet werkt onder Wine (zoals Microsoft 365), gebruik ik een Windows VM. Zie [Virt-Manager / KVM]({{< relref "/docs/virtualization/vm-setup" >}}).
448448

449449
![Bottles in de Flathub store](/images/bottles-flathub.avif)
450450

content/docs/getting-started.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ After testing multiple distributions, I settled on CachyOS (Arch) as my daily dr
1818
- **Built-in iGPU and dGPU drivers**: the AMD Radeon 890M and NVIDIA RTX 4060 work correctly from a fresh install, including GPU switching via `asusctl armoury`
1919
- **ASUS Linux patches**: part of [Luke Jones'](https://asus-linux.org/) work has been merged into the Linux kernel mainline (the `asus-armoury` driver since 6.19), while additional ROG-specific patches and `asusctl` tooling improvements are carried by CachyOS. Both `asusctl` and `rog-control-center` are available directly from the CachyOS repos; install two packages and you're done, no deep system configuration required. CachyOS currently ships the most complete set of optimizations for this hardware
2020

21-
Fedora is a strong second, a solid option if you prefer a more stable release cycle over rolling, and you're in good shape as long as you're on kernel 6.19 (already available on Fedora, but make sure to update). That said, CachyOS still feels more polished for this hardware: the CPU scheduler tuning (BORE/EEVDF), pre-configured NVIDIA driver support, and tighter integration with `asusctl` make day-to-day use more seamless out of the box.
21+
Fedora is a strong second, a solid option if you prefer a more stable release cycle over rolling. You're in good shape as long as you're on kernel 6.19 (already available on Fedora, but make sure to update). That said, CachyOS still feels more polished for this hardware: the CPU scheduler tuning (BORE/EEVDF), pre-configured NVIDIA driver support, and tighter integration with `asusctl` make day-to-day use more seamless out of the box.
2222

2323
## CachyOS Kernel Manager
2424

@@ -46,10 +46,10 @@ Install NVIDIA drivers, set up Secure Boot with your own signing keys, and confi
4646

4747
### Security & Privacy
4848

49-
Set up hardware-backed LUKS unlock with a YubiKey, and optionally configure GDM to skip the login screen after disk unlock.
49+
Optionally configure GDM to skip the login screen after disk unlock. Set up the YubiKey for `sudo` and the GNOME lock screen via pam-u2f.
5050

51-
[YubiKey 5C NFC]({{< relref "/docs/security/yubikey" >}})
5251
[GDM Autologin]({{< relref "/docs/security/autologin" >}})
52+
[YubiKey]({{< relref "/docs/security/yubikey" >}})
5353

5454
### Applications
5555

@@ -65,8 +65,9 @@ Get eduroam working. The official installers don't work on Linux; a manual PEAP/
6565

6666
### Virtualization
6767

68-
Set up a Windows 11 VM for software that doesn't run on Linux (Microsoft 365, etc.).
68+
Set up a Windows 11 VM for software that doesn't run on Linux (Microsoft 365, etc.), or run VMware Workstation for more advanced virtualization needs.
6969

70-
[Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}})
70+
[Virt-Manager / KVM]({{< relref "/docs/virtualization/vm-setup" >}})
71+
[VMware Workstation]({{< relref "/docs/virtualization/vmware-workstation" >}})
7172

7273
{{% /steps %}}

content/docs/getting-started.nl.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Na het testen van meerdere distributies ben ik overgestapt op CachyOS (Arch) als
1818
- **Ingebouwde iGPU- en dGPU-drivers**: de AMD Radeon 890M en NVIDIA RTX 4060 werken correct vanaf een verse installatie, inclusief GPU-switching via `asusctl armoury`
1919
- **ASUS Linux-patches**: een deel van het werk van [Luke Jones](https://asus-linux.org/) is gemerged in de Linux kernel zelf (de `asus-armoury`-driver vanaf 6.19), terwijl aanvullende ROG-specifieke patches en `asusctl`-verbeteringen via CachyOS worden meegeleverd. Zowel `asusctl` als `rog-control-center` zijn direct beschikbaar vanuit de CachyOS repos; twee packages installeren en je bent klaar, zonder diepe systeemconfiguratie. CachyOS bevat op dit moment de meest volledige set aan optimalisaties voor deze hardware
2020

21-
Fedora is een sterke tweede, een solide keuze als je de voorkeur geeft aan een stabielere releasecyclus boven rolling. Je zit goed zolang je op kernel 6.19 draait, die al beschikbaar is op Fedora, maar je moet wel even updaten. Dat gezegd hebbende voelt CachyOS nog altijd beter aan voor deze hardware: de CPU-scheduler tuning (BORE/EEVDF), vooraf geconfigureerde NVIDIA-driver ondersteuning en nauwere integratie met `asusctl` maken het dagelijks gebruik soepeler, zonder extra configuratie.
21+
Fedora is een sterke tweede, een solide keuze als je de voorkeur geeft aan een stabielere releasecyclus boven rolling. Je zit goed zolang je op kernel 6.19 draait, die al beschikbaar is op Fedora, maar je moet wel even updaten. CachyOS voelt echter nog altijd beter aan voor deze hardware: de CPU-scheduler tuning (BORE/EEVDF), vooraf geconfigureerde NVIDIA-driverondersteuning en nauwere integratie met `asusctl` maken het dagelijks gebruik soepeler, zonder extra configuratie.
2222

2323
## CachyOS Kernel Manager
2424

@@ -46,10 +46,10 @@ Installeer NVIDIA-drivers, stel Secure Boot in met je eigen ondertekeningssleute
4646

4747
### Beveiliging & Privacy
4848

49-
Stel hardware-gebaseerde LUKS-ontgrendeling in met een YubiKey, en configureer optioneel GDM om het inlogscherm over te slaan na schijfontsluiting.
49+
Configureer optioneel GDM om het inlogscherm over te slaan na schijfontsluiting. Stel de YubiKey in voor `sudo` en de GNOME-schermvergrendeling via pam-u2f.
5050

51-
[YubiKey 5C NFC]({{< relref "/docs/security/yubikey" >}})
5251
[GDM Autologin]({{< relref "/docs/security/autologin" >}})
52+
[YubiKey]({{< relref "/docs/security/yubikey" >}})
5353

5454
### Applicaties
5555

@@ -65,8 +65,9 @@ eduroam werkend krijgen. De officiële installers werken niet op Linux; een hand
6565

6666
### Virtualisatie
6767

68-
Windows 11 VM opzetten voor software die niet op Linux draait (Microsoft 365, etc.).
68+
Windows 11 VM opzetten voor software die niet op Linux draait (Microsoft 365, etc.), of VMware Workstation gebruiken voor meer geavanceerde virtualisatiebehoeften.
6969

70-
[Windows 11 VM Setup]({{< relref "/docs/virtualization/vm-setup" >}})
70+
[Virt-Manager / KVM]({{< relref "/docs/virtualization/vm-setup" >}})
71+
[VMware Workstation]({{< relref "/docs/virtualization/vmware-workstation" >}})
7172

7273
{{% /steps %}}

content/docs/hardware/asusctl-rog-control.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ This installs:
2828
- `asusctl`: CLI frontend that communicates with asusd
2929
- `rog-control-center`: graphical frontend that communicates with asusd
3030

31-
On CachyOS this is all you need; both packages are available directly from the repos and everything works out of the box. No kernel patching or deep system configuration required.
31+
On CachyOS, this is all you need; both packages are available directly from the repos and everything works out of the box. No kernel patching or deep system configuration required.
3232

3333
### Enable services
3434

@@ -161,19 +161,25 @@ asusctl profile
161161
162162
{{% /details %}}
163163

164-
{{% details title="GPU mode switching (asusctl armoury)" closed="true" %}}
164+
{{% details title="GPU mode switching (ROG Control Center / asusctl armoury)" closed="true" %}}
165165

166166
The GA605WV has a hybrid GPU setup: the AMD Radeon 890M (iGPU) drives the internal display, and the NVIDIA RTX 4060 (dGPU) handles GPU workloads.
167167

168-
GPU switching is managed via `asusctl armoury`, which interfaces directly with the `asus-armoury` kernel driver (available since kernel 6.19).
169-
170-
> **Note:** `supergfxctl` was previously used for GPU switching but is now deprecated. Use `asusctl armoury` instead.
168+
GPU switching is managed via ROG Control Center (GUI) or `asusctl armoury` (CLI), both of which interface directly with the `asus-armoury` kernel driver (available since kernel 6.19).
171169

172170
| Mode | Description |
173171
|------|-------------|
174172
| Hybrid (`dgpu_disable 0`) | Both GPUs active. NVIDIA handles GPU workloads, AMD drives the display. Best for gaming. |
175173
| Integrated (`dgpu_disable 1`) | Only AMD iGPU. Lower power consumption, no NVIDIA. Good for battery. |
176174

175+
**Switch via GUI (ROG Control Center):**
176+
177+
Open ROG Control Center (`rog-control-center`) and navigate to the GPU switching section to toggle between Hybrid and Integrated mode.
178+
179+
![ROG Control Center - GPU switching](/images/rog-control-gpu-switching.avif)
180+
181+
**Switch via CLI (asusctl armoury):**
182+
177183
**Check current dGPU state:**
178184
```bash
179185
asusctl armoury get dgpu_disable
@@ -298,7 +304,7 @@ Known issues and troubleshooting for asusctl & ROG Control Center are documented
298304

299305
### Kernel 6.19: asus-armoury driver lands in mainline
300306

301-
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 the [asus-linux team](https://asus-linux.org/), with no involvement from ASUS themselves. CachyOS ships kernel 6.19.4-2 which includes this driver and additional ASUS-specific patches.
307+
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 the [asus-linux team](https://asus-linux.org/), with no involvement from ASUS themselves. CachyOS ships kernel 6.19.8-1-cachyos which includes this driver and additional ASUS-specific patches.
302308

303309
**Before**: basic asusctl controls without Armoury settings:
304310

0 commit comments

Comments
 (0)