diff --git a/README.md b/README.md
index 705740b..f930301 100644
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@
 - **Gaming compatibility** - tested games, settings, FPS data
 - **Driver setup** - RADV configuration, environment variables
 - **Community cases catalogue** - 145 case/enclosure designs, searchable and filterable
-- **System configuration** - GPU governor (cyan-skillfish-governor-tt default, oberon-governor alternative), sensors, power management
+- **System configuration** - GPU governor (cyan-skillfish-governor-smu recommended), sensors, power management
 
 ## Building Locally
 
diff --git a/docs/bios/overclocking.md b/docs/bios/overclocking.md
index 8dfe424..d3bd628 100644
--- a/docs/bios/overclocking.md
+++ b/docs/bios/overclocking.md
@@ -137,11 +137,11 @@ If GPU remains at 1500 MHz after installing patched kernel:
 
 2. **Update governor configuration:**
    ```bash
-   # For cyan-skillfish-governor-tt:
-   sudo nano /etc/cyan-skillfish-governor-tt/config.toml
+   # For cyan-skillfish-governor-smu:
+   sudo nano /etc/cyan-skillfish-governor-smu/config.toml
    # Update safe-points to include extended range frequencies
 
-   sudo systemctl restart cyan-skillfish-governor-tt
+   sudo systemctl restart cyan-skillfish-governor-smu
    ```
 
 ### Recommended Settings
@@ -243,11 +243,21 @@ A community-developed SMU (System Management Unit) tool enables CPU overclocking
 
 ## Safe Overclocking Limits
 
-Start at 2000 MHz @ 1000 mV and work up. Stability varies by board (silicon lottery). General guidance:
+Start at 2000 MHz @ 1000 mV and work up. Stability varies by board (silicon lottery). Maximum achievable frequency depends on your cooling solution:
+
+**Air Cooled (conservative):**
 
 - **2000 MHz @ 1000 mV** — safe starting point for most boards
 - **2100-2175 MHz @ 1025-1050 mV** — works on many boards, test thoroughly
-- **2230 MHz @ 1035-1060 mV** — maximum hardware limit, requires good cooling
+- **2230 MHz @ 1060 mV** — conservative air-cooled maximum
+
+**Good Air Cooling (Arctic P12 Max or better):**
+
+- **2300 MHz @ 1075 mV** — achievable with high static pressure fans and good case airflow
+
+**Liquid Cooling:**
+
+- **2400 MHz @ 1125 mV** — per NexGen3D testing with liquid cooling setup
 
 ## Manual Overclocking
 
@@ -280,7 +290,7 @@ cat /sys/class/drm/card1/device/pp_od_clk_voltage
 
 **Edit config:**
 ```bash
-sudo nano /etc/cyan-skillfish-governor-tt/config.toml
+sudo nano /etc/cyan-skillfish-governor-smu/config.toml
 ```
 
 **Multi-voltage point configuration:**
@@ -291,12 +301,13 @@ safe-points = [
     [2000, 1000],  # 2000 MHz @ 1000 mV
     [2100, 1025],  # 2100 MHz @ 1025 mV
     [2175, 1050],  # 2175 MHz @ 1050 mV (overclock)
+    [2300, 1075],  # 2300 MHz @ 1075 mV (good air cooling)
 ]
 ```
 
 **Restart governor:**
 ```bash
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 ## Testing Stability
@@ -428,11 +439,11 @@ Higher clocks mean more heat and power draw. Keep GPU below 85°C under load. Se
 **Check:**
 ```bash
 # Verify governor running (use whichever you installed)
-systemctl status cyan-skillfish-governor-tt
-# Or: systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
+# Or: systemctl status cyan-skillfish-governor-tt
 
 # Restart governor
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 
 # Check applied settings
 cat /sys/class/drm/card1/device/pp_od_clk_voltage
@@ -477,7 +488,7 @@ echo "c" | sudo tee /sys/class/drm/card1/device/pp_od_clk_voltage
 - [GPU Governor Setup](../system/governor.md) — start here
 - [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor/tree/smu) — SMU governor (no kernel patch needed)
 - [PS5GPU-BC250](https://github.com/ZEROAESQUERDA/PS5GPU-BC250) — GUI GPU controller
-- [NexGen3D SteamMachine Scripts](https://github.com/NexGen-3D-Printing/SteamMachine) — automated setup for Bazzite
+- [NexGen3D SteamMachine Scripts](https://github.com/NexGen-3D-Printing/SteamMachine) — automated Bazzite setup; links to this documentation as the main guide
 - [DeathStalker Grimoire](https://github.com/DeathStalker471/bc250theGrimoire) — community step-by-step guide
 - [Cooling Solutions](../hardware/cooling.md)
 - [Power Requirements](../hardware/power.md)
diff --git a/docs/drivers/radv.md b/docs/drivers/radv.md
index a6a2262..fd78097 100644
--- a/docs/drivers/radv.md
+++ b/docs/drivers/radv.md
@@ -735,7 +735,7 @@ cat /sys/class/drm/card1/device/pp_dpm_sclk
 # 2: 2000Mhz
 
 # If stuck at 1500MHz, governor is not working
-systemctl status cyan-skillfish-governor-tt
+systemctl status cyan-skillfish-governor-smu
 ```
 
 **Solution:** Install and configure GPU governor (see [System Configuration](../system/governor.md) guide).
diff --git a/docs/getting-started/quick-start.md b/docs/getting-started/quick-start.md
index 21ae3b9..e903699 100644
--- a/docs/getting-started/quick-start.md
+++ b/docs/getting-started/quick-start.md
@@ -62,14 +62,14 @@ Run the automated setup script:
 # Mesa 25.x is included in Fedora 43 repos - no additional setup needed
 sudo dnf update
 
-# Install governor from COPR (updated Dec 2025)
+# Install governor from COPR
 sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-tt
-sudo systemctl enable --now cyan-skillfish-governor-tt.service
+sudo dnf install cyan-skillfish-governor-smu
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 ```
 
-!!!info "SMU Governor Alternative (No Kernel Patch Needed)"
-    The `cyan-skillfish-governor-smu` bypasses kernel patches entirely via SMU firmware calls. Best option for CachyOS/Arch. Install via AUR: `yay -S cyan-skillfish-governor-smu`
+!!!info "TT Governor Alternative"
+    The `cyan-skillfish-governor-tt` is also available from the same COPR. It requires the kernel frequency range patch (pre-included in Bazzite).
 
 !!!success "ACPI Fix — Recommended"
     The [bc250-collective/bc250-acpi-fix](https://github.com/bc250-collective/bc250-acpi-fix) enables CPU C-States (idle power savings) and P-States (CPU frequency scaling 800-3200 MHz). Loaded via initrd override. See the [Governor page](../system/governor.md) for installation instructions.
@@ -135,8 +135,8 @@ vulkaninfo | grep deviceName
 # Should show: AMD Radeon Graphics (RADV GFX1013)
 
 # Check governor running (use whichever you installed)
-systemctl status cyan-skillfish-governor-tt
-# Or: systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
+# Or: systemctl status cyan-skillfish-governor-tt
 # Should show: active (running)
 
 # Check GPU frequency
@@ -188,7 +188,7 @@ This fixes graphical glitches in some games.
 **Problem:** Games running at 15-20 FPS
 **Solution:**
 
-1. Check governor is running: `systemctl status cyan-skillfish-governor-tt`
+1. Check governor is running: `systemctl status cyan-skillfish-governor-smu`
 2. Check GPU frequency: `cat /sys/class/drm/card1/device/pp_dpm_sclk`
 3. Should NOT be stuck at 1500MHz
 
diff --git a/docs/linux/arch.md b/docs/linux/arch.md
index 45cdc11..6b9f89a 100644
--- a/docs/linux/arch.md
+++ b/docs/linux/arch.md
@@ -168,7 +168,7 @@ sudo ./bc520-manjaro.sh
 
 1. **Package Installation**
    - Installs base-devel, git, cmake, lm_sensors
-   - Installs build tools for Oberon governor
+   - Installs build tools for GPU governor
 
 2. **RADV Environment Configuration**
    - Creates `/etc/environment.d/99-radv-bc250.conf`:
@@ -189,9 +189,9 @@ sudo ./bc520-manjaro.sh
    - Creates `/etc/modules-load.d/nct6683-bc250.conf`
    - Enables temperature monitoring
 
-5. **Oberon Governor**
-   - Clones and compiles governor
-   - Enables dynamic frequency scaling (1000MHz-2000MHz+)
+5. **GPU Governor**
+   - Installs cyan-skillfish-governor-smu from AUR
+   - Enables dynamic frequency scaling (1000MHz-2300MHz+)
    - Without this, GPU is locked at 1500MHz
 
 6. **Initramfs Regeneration**
@@ -289,9 +289,9 @@ nvtop      # Real-time GPU monitoring
 
 ```bash
 # Use whichever governor you installed:
-systemctl status cyan-skillfish-governor-tt   # TT variant (recommended)
-systemctl status cyan-skillfish-governor-smu  # SMU variant
-systemctl status oberon-governor              # legacy
+systemctl status cyan-skillfish-governor-smu  # SMU variant (recommended)
+systemctl status cyan-skillfish-governor-tt   # TT variant (alternative)
+systemctl status oberon-governor              # legacy (migrate to SMU)
 ```
 
 ### Check Frequency Scaling
@@ -317,7 +317,7 @@ The `*` moves between frequencies based on load.
 
 **Manual start:**
 ```bash
-sudo systemctl restart cyan-skillfish-governor-tt  # or oberon-governor
+sudo systemctl restart cyan-skillfish-governor-smu  # or cyan-skillfish-governor-tt
 ```
 
 ---
@@ -455,8 +455,8 @@ IgnorePkg = linux
 - [pnbarbeito/bc250-arch](https://github.com/pnbarbeito/bc250-arch)
 
 **Governor projects:**
-- [Cyan Skillfish Governor TT/SMU](https://github.com/filippor/cyan-skillfish-governor) (AUR, recommended)
-- [Oberon Governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)
+- [Cyan Skillfish Governor SMU](https://github.com/filippor/cyan-skillfish-governor/tree/smu) (AUR, recommended)
+- [Cyan Skillfish Governor TT](https://github.com/filippor/cyan-skillfish-governor) (AUR, alternative)
 
 ---
 
@@ -473,7 +473,7 @@ nvtop
 cat /sys/class/drm/card1/device/pp_dpm_sclk
 
 # Check governor (use whichever you installed)
-systemctl status cyan-skillfish-governor-tt
+systemctl status cyan-skillfish-governor-smu
 
 # Check temps
 sensors
diff --git a/docs/linux/bazzite.md b/docs/linux/bazzite.md
index 363952b..3441330 100644
--- a/docs/linux/bazzite.md
+++ b/docs/linux/bazzite.md
@@ -87,25 +87,25 @@ See [BIOS Flashing Guide](../bios/flashing.md) for details.
 # Add COPR repository
 sudo dnf copr enable filippor/bazzite
 
-# Install governor (use cyan-skillfish-governor-tt)
-rpm-ostree install cyan-skillfish-governor-tt
+# Install governor (SMU variant — recommended, no kernel patch needed)
+rpm-ostree install cyan-skillfish-governor-smu
 
 # Reboot to apply
 systemctl reboot
 
 # Enable service after reboot
-sudo systemctl enable --now cyan-skillfish-governor-tt.service
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 ```
 
-!!!info "SMU Governor Alternative (No Kernel Patch Needed)"
-    The `cyan-skillfish-governor-smu` bypasses kernel patches entirely via SMU firmware calls. Available on AUR, COPR (`filippor/bazzite`), .deb, .rpm, and Nix.
+!!!info "TT Governor Alternative"
+    The `cyan-skillfish-governor-tt` is also available via the same COPR. It requires the kernel frequency range patch (pre-included in Bazzite). Use `rpm-ostree install cyan-skillfish-governor-tt` if you prefer the TT variant.
 
 !!!warning "GPU Card Naming Issue"
     The governor may target incorrect device (card0 vs card1). Verify correct device assignment in governor configuration if frequency scaling doesn't work.
 
 ### Voltage Configuration
 
-Default configuration (`/etc/cyan-skillfish-governor-tt/config.toml`):
+Default configuration (`/etc/cyan-skillfish-governor-smu/config.toml`):
 
 ```yaml
 voltage:
@@ -138,7 +138,7 @@ Some boards are unstable at lower voltages. The script defaults to 1000mV to pre
 
 ### Prerequisites
 
-If you already have Bazzite installed with an older governor:
+If you already have Bazzite installed with an older governor (oberon), migrate first:
 
 ```bash
 # Remove existing oberon installation (if applicable)
@@ -181,7 +181,7 @@ After rebase:
 
 ```bash
 systemctl reboot
-systemctl status cyan-skillfish-governor-tt  # Verify running
+systemctl status cyan-skillfish-governor-smu  # Verify running
 ```
 
 !!!warning "WiFi May Be Killed by Performance Setup (Issue #10)"
@@ -195,7 +195,7 @@ Performance patch increases power draw and temperatures:
 - **Cooling:** High static pressure fans required
 - **Temps:** Expect 85-95°C under full load (normal for this board)
 
-To reduce power consumption, edit `/etc/cyan-skillfish-governor-tt/config.toml`:
+To reduce power consumption, edit `/etc/cyan-skillfish-governor-smu/config.toml`:
 
 ```yaml
 voltage:
@@ -205,7 +205,7 @@ frequency:
   - max: 1800  # Reduced from 2230
 ```
 
-Then restart: `sudo systemctl restart cyan-skillfish-governor-tt`
+Then restart: `sudo systemctl restart cyan-skillfish-governor-smu`
 
 ### Disable CPU Mitigations (Optional)
 
@@ -311,13 +311,13 @@ systemctl reboot
 **Solution:**
 
 ```bash
-sudo nano /etc/cyan-skillfish-governor-tt/config.toml
+sudo nano /etc/cyan-skillfish-governor-smu/config.toml
 
 # Increase voltage if unstable:
 # min_voltage = 1000
 # max_voltage = 1000
 
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 ### Flatpak Apps Don't See GPU
@@ -334,14 +334,14 @@ sudo systemctl restart cyan-skillfish-governor-tt
 
 ```bash
 # Check governor status (use whichever you installed)
-systemctl status cyan-skillfish-governor-tt
-# Or: systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
+# Or: systemctl status cyan-skillfish-governor-tt
 
 # If not running:
-sudo systemctl enable --now cyan-skillfish-governor-tt.service
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 
 # Restart if running:
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 
 # Verify frequency scaling
 cat /sys/class/drm/card1/device/pp_dpm_sclk
@@ -420,7 +420,7 @@ watch -n 1 cat /sys/class/drm/card1/device/pp_dpm_sclk
 ujust update
 
 # Check governor
-systemctl status cyan-skillfish-governor-tt
+systemctl status cyan-skillfish-governor-smu
 
 # Check GPU frequency
 cat /sys/class/drm/card1/device/pp_dpm_sclk
@@ -442,7 +442,7 @@ rpm-ostree rebase ostree-image-signed:docker://ghcr.io/vietsman/bazzite-gnome-pa
 - **Bazzite Official:** [bazzite.gg](https://bazzite.gg)
 - **Setup script:** [vietsman/bc250-documentation](https://github.com/vietsman/bc250-documentation)
 - **Patched images:** [vietsman/bazzite-patched](https://github.com/vietsman/bazzite-patched)
-- **GPU Governor:** [cyan-skillfish-governor-tt](https://github.com/filippor/cyan-skillfish-governor) (recommended) or [oberon-governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)
+- **GPU Governor:** [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor/tree/smu) (recommended) or [cyan-skillfish-governor-tt](https://github.com/filippor/cyan-skillfish-governor) (alternative)
 
 ---
 
diff --git a/docs/linux/cachyos.md b/docs/linux/cachyos.md
index 78af7c7..3d50dbf 100644
--- a/docs/linux/cachyos.md
+++ b/docs/linux/cachyos.md
@@ -153,7 +153,7 @@ sudo systemctl enable --now cyan-skillfish-governor-smu.service
 systemctl status cyan-skillfish-governor-smu
 ```
 
-**Method 2: TT Governor from AUR (Requires Kernel Patch)**
+**Method 2: TT Governor from AUR (Alternative — Requires Kernel Patch)**
 ```bash
 # Install cyan-skillfish-governor-tt
 yay -S cyan-skillfish-governor-tt
@@ -165,21 +165,9 @@ sudo systemctl enable --now cyan-skillfish-governor-tt.service
 systemctl status cyan-skillfish-governor-tt
 ```
 
-**Method 3: Build oberon-governor from source (legacy)**
-```bash
-# Install dependencies
-sudo pacman -S base-devel cmake git
+**Method 3: Build from source**
 
-# Clone and build
-git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
-cd oberon-governor
-cmake .
-make -j$(nproc)
-sudo make install
-
-# Enable and start
-sudo systemctl enable --now oberon-governor.service
-```
+See [github.com/Magnap/cyan-skillfish-governor](https://github.com/Magnap/cyan-skillfish-governor) for build instructions. The SMU variant is in the `smu` branch.
 
 **Verify it's working:**
 ```bash
@@ -349,7 +337,7 @@ glxinfo | grep "OpenGL version"  # Expected: Mesa 25.1.x+
 vulkaninfo | grep deviceName  # Expected: AMD Radeon Graphics (RADV GFX1013)
 
 # 4. Check governor (use whichever you installed)
-systemctl status cyan-skillfish-governor-tt  # Expected: active (running)
+systemctl status cyan-skillfish-governor-smu  # Expected: active (running)
 
 # 5. Check GPU frequency
 cat /sys/class/drm/card1/device/pp_dpm_sclk  # Expected: Multiple frequencies
@@ -436,7 +424,7 @@ CachyOS now works well on BC-250 with standard installation. The complex custom
 - **CachyOS Website:** [cachyos.org](https://cachyos.org/)
 - **CachyOS Wiki:** [wiki.cachyos.org](https://wiki.cachyos.org/)
 - **CachyOS GitHub:** [github.com/CachyOS](https://github.com/CachyOS)
-- **GPU Governor:** [cyan-skillfish-governor](https://github.com/filippor/cyan-skillfish-governor) (recommended) or [oberon-governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)
+- **GPU Governor:** [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor/tree/smu) (recommended) or [cyan-skillfish-governor-tt](https://github.com/filippor/cyan-skillfish-governor) (alternative)
 
 ---
 
diff --git a/docs/linux/debian.md b/docs/linux/debian.md
index e647268..3c91bea 100644
--- a/docs/linux/debian.md
+++ b/docs/linux/debian.md
@@ -208,52 +208,19 @@ A GPU governor is required for proper GPU frequency scaling.
 
 **Option 1: Install cyan-skillfish-governor-smu from .deb (recommended)**
 
-The SMU governor is available as a .deb package from [filippor's COPR](https://github.com/filippor/cyan-skillfish-governor). It bypasses kernel patching entirely.
-
-**Option 2: Build oberon-governor from source (legacy)**
+The SMU governor is available as a .deb package from [filippor's releases](https://github.com/Magnap/cyan-skillfish-governor/releases). It bypasses kernel patching entirely.
 
 ```bash
-# Install dependencies
-sudo apt install build-essential cmake git libdrm-dev libyaml-cpp-dev
-
-# Clone and build
-git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
-cd oberon-governor
-cmake .
-make -j$(nproc)
-sudo make install
-
-# Create systemd service
-sudo nano /etc/systemd/system/oberon-governor.service
-```
-
-Add the following content:
-
-```ini
-[Unit]
-Description=Oberon GPU Governor
-After=multi-user.target
-
-[Service]
-Type=simple
-ExecStart=/usr/local/bin/oberon-governor
-Restart=on-failure
-
-[Install]
-WantedBy=multi-user.target
-```
-
-Enable and start:
-
-```bash
-sudo systemctl daemon-reload
-sudo systemctl enable --now oberon-governor.service
+# Download .deb from GitHub releases
+wget https://github.com/Magnap/cyan-skillfish-governor/releases/latest/download/cyan-skillfish-governor-smu_amd64.deb
+sudo dpkg -i cyan-skillfish-governor-smu_amd64.deb
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 ```
 
 Verify:
 
 ```bash
-systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
 cat /sys/class/drm/card1/device/pp_dpm_sclk
 ```
 
@@ -372,7 +339,7 @@ uname -r
 
 ```bash
 # Service status (use whichever you installed)
-systemctl status cyan-skillfish-governor-smu  # or oberon-governor
+systemctl status cyan-skillfish-governor-smu  # or cyan-skillfish-governor-tt
 
 # GPU frequency
 cat /sys/class/drm/card1/device/pp_dpm_sclk
@@ -493,15 +460,14 @@ sudo apt install -t experimental mesa-vulkan-drivers libgl1-mesa-dri --reinstall
 ### Governor Not Working
 
 ```bash
-# Check service (use whichever you installed)
-systemctl status oberon-governor          # legacy
-systemctl status cyan-skillfish-governor-smu  # SMU variant
+# Check service
+systemctl status cyan-skillfish-governor-smu
 
 # Check logs
-journalctl -u oberon-governor -f
+journalctl -u cyan-skillfish-governor-smu -f
 
 # Restart service
-sudo systemctl restart oberon-governor
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 ---
@@ -543,7 +509,7 @@ sudo apt install htop
 - **Debian:** [debian.org](https://www.debian.org/)
 - **PikaOS:** [pikaos.org](https://pikaos.org)
 - **Xanmod Kernel:** [xanmod.org](https://xanmod.org/)
-- **GPU Governor:** [cyan-skillfish-governor](https://github.com/filippor/cyan-skillfish-governor) (recommended) or [oberon-governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)
+- **GPU Governor:** [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor/tree/smu) (recommended) or [cyan-skillfish-governor-tt](https://github.com/filippor/cyan-skillfish-governor) (alternative)
 
 ---
 
@@ -559,8 +525,8 @@ glxinfo | grep "OpenGL version"
 # Check GPU
 vulkaninfo | grep deviceName
 
-# Check governor (use whichever you installed)
-systemctl status cyan-skillfish-governor-smu  # or oberon-governor
+# Check governor
+systemctl status cyan-skillfish-governor-smu
 
 # Check GPU frequency
 cat /sys/class/drm/card1/device/pp_dpm_sclk
diff --git a/docs/linux/distributions.md b/docs/linux/distributions.md
index 893c267..c9292d0 100644
--- a/docs/linux/distributions.md
+++ b/docs/linux/distributions.md
@@ -38,8 +38,8 @@ Choosing the right Linux distribution for your BC-250 is important for a smooth
 - Some users report MTG Arena crashes specifically on Fedora
 - Auto-updates can break things if not careful
 
-!!!info "Governor Installation Command Updated"
-    Use `sudo dnf copr enable filippor/bazzite && sudo dnf install cyan-skillfish-governor-tt` (confirmed Dec 2025).
+!!!info "Governor Installation Command"
+    Use `sudo dnf copr enable filippor/bazzite && sudo dnf install cyan-skillfish-governor-smu` (confirmed Mar 2026).
 
 ### Setup Resources
 
@@ -82,7 +82,10 @@ Choosing the right Linux distribution for your BC-250 is important for a smooth
 
 ```bash
 # After installation, install governor:
-curl -s https://raw.githubusercontent.com/vietsman/bc250-documentation/refs/heads/main/oberon-setup.sh | sudo sh
+sudo dnf copr enable filippor/bazzite
+rpm-ostree install cyan-skillfish-governor-smu
+systemctl reboot
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 
 # Pin working version after successful boot:
 rpm-ostree pin 0
diff --git a/docs/linux/fedora.md b/docs/linux/fedora.md
index cd88639..bd9ccc5 100644
--- a/docs/linux/fedora.md
+++ b/docs/linux/fedora.md
@@ -122,26 +122,14 @@ dnf list mesa-\*
 **Option 1: COPR (Recommended)**
 
 ```bash
-# Use filippor/bazzite COPR with cyan-skillfish-governor-tt
+# Use filippor/bazzite COPR with cyan-skillfish-governor-smu
 sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-tt
-sudo systemctl enable --now cyan-skillfish-governor-tt
+sudo dnf install cyan-skillfish-governor-smu
+sudo systemctl enable --now cyan-skillfish-governor-smu
 ```
 
-!!!info "Governor Package Update"
-    The `filippor/bazzite` COPR now provides `cyan-skillfish-governor-tt` (Skillfish-TT optimized), which is confirmed stable as of Dec 2025. This is now the community default (Jan 2026+).
-
-!!!info "Alternative COPR Option"
-    You can also use `@exotic-soc/oberon-governor` for the original oberon-governor package if preferred.
-
-**Option 2: Build oberon-governor from source (legacy)**
-
-```bash
-git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
-cd oberon-governor
-cmake . && make && sudo make install
-sudo systemctl enable --now oberon-governor.service
-```
+!!!info "Governor Package"
+    The `filippor/bazzite` COPR provides both `cyan-skillfish-governor-smu` (recommended, no kernel patch needed) and `cyan-skillfish-governor-tt` (alternative, requires kernel patch). Confirmed stable as of Mar 2026.
 
 ### Step 5: Configure Sensors
 
@@ -202,7 +190,7 @@ vulkaninfo | grep deviceName
 # Should show: AMD Radeon Graphics (RADV GFX1013)
 
 # Check governor running
-systemctl status cyan-skillfish-governor-tt
+systemctl status cyan-skillfish-governor-smu
 # Should show: active (running)
 
 # Check sensors
@@ -280,13 +268,13 @@ glxinfo | grep -i "opengl renderer"
 
 ```bash
 # Check governor service
-sudo systemctl status cyan-skillfish-governor-tt
+sudo systemctl status cyan-skillfish-governor-smu
 
 # Check logs
-sudo journalctl -u cyan-skillfish-governor-tt
+sudo journalctl -u cyan-skillfish-governor-smu
 
 # Restart service
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 ### Low FPS in Games
@@ -347,7 +335,7 @@ sudo dnf install kernel-6.18.18-200
 sudo nano /etc/sysctl.conf
 
 # Add:
-vm.swappiness=10
+vm.swappiness=180
 vm.vfs_cache_pressure=50
 
 # Apply
diff --git a/docs/linux/kernel.md b/docs/linux/kernel.md
index df6a79c..3e8135a 100644
--- a/docs/linux/kernel.md
+++ b/docs/linux/kernel.md
@@ -213,7 +213,7 @@ The cyan-skillfish-governor tools enable manual GPU frequency and voltage tuning
 **Installation (Fedora/Bazzite):**
 ```bash
 sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-tt
+sudo dnf install cyan-skillfish-governor-smu
 ```
 
 **Important:** After installation, verify the governor is targeting the correct GPU device:
diff --git a/docs/reference/quick-reference.md b/docs/reference/quick-reference.md
index a3a17d4..c48496a 100644
--- a/docs/reference/quick-reference.md
+++ b/docs/reference/quick-reference.md
@@ -119,7 +119,7 @@ amdgpu.sg_display=0
 |-----------|---------|-------------|
 | Mesa | 25.1.0 | 25.3.x+ (25.3.6 on Fedora 43) |
 | Kernel | 6.12.x | 6.18.18 LTS or 6.19.x stable |
-| Governor | Any | cyan-skillfish-governor-tt or -smu |
+| Governor | Any | cyan-skillfish-governor-smu (recommended) |
 
 [Linux setup guide →](../linux/distributions.md)
 
@@ -169,22 +169,25 @@ The governor controls GPU frequency and voltage. **Required for gaming performan
 ### Installation
 
 ```bash
-# Fedora/Bazzite (recommended):
+# Fedora:
 sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-tt
-sudo systemctl enable --now cyan-skillfish-governor-tt.service
+sudo dnf install cyan-skillfish-governor-smu
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 
-# Bazzite (automated script):
-curl -s https://raw.githubusercontent.com/vietsman/bc250-documentation/refs/heads/main/oberon-setup.sh | sudo sh
+# Bazzite (rpm-ostree):
+sudo dnf copr enable filippor/bazzite
+rpm-ostree install cyan-skillfish-governor-smu
+systemctl reboot
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 
-# Arch/CachyOS (SMU - no kernel patch needed):
+# Arch/CachyOS:
 yay -S cyan-skillfish-governor-smu
 sudo systemctl enable --now cyan-skillfish-governor-smu.service
 ```
 
 ### Configuration
 
-Edit `/etc/cyan-skillfish-governor-tt/config.toml`:
+Edit `/etc/cyan-skillfish-governor-smu/config.toml`:
 
 ```toml
 # Safe starting point:
@@ -197,7 +200,7 @@ max_voltage = 1050    # mV
 Restart governor after changes:
 
 ```bash
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 ### Check GPU Frequency
@@ -259,18 +262,18 @@ sudo reboot
 
 ```bash
 # Check status (use whichever you installed)
-systemctl status cyan-skillfish-governor-tt
-# Or: systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
+# Or: systemctl status cyan-skillfish-governor-tt
 
 # Start/stop
-sudo systemctl start cyan-skillfish-governor-tt
-sudo systemctl stop cyan-skillfish-governor-tt
+sudo systemctl start cyan-skillfish-governor-smu
+sudo systemctl stop cyan-skillfish-governor-smu
 
 # Restart after config change
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 
 # View logs
-journalctl -u cyan-skillfish-governor-tt -f
+journalctl -u cyan-skillfish-governor-smu -f
 ```
 
 ---
@@ -322,7 +325,7 @@ RADV_DEBUG=nohiz %command%
 1. Mesa version ≥ 25.1: `glxinfo | grep Mesa`
 2. Kernel ≤ 6.14: `uname -r`
 3. nomodeset removed from GRUB
-4. Governor running: `systemctl status cyan-skillfish-governor-tt`
+4. Governor running: `systemctl status cyan-skillfish-governor-smu`
 
 ### BIOS Settings Don't Stick
 
@@ -373,7 +376,7 @@ RADV_DEBUG=nohiz %command%
 ### Official Documentation
 - **GitHub:** https://github.com/mothenjoyer69/bc250-documentation
 - **BIOS Repo:** https://gitlab.com/TuxThePenguin0/bc250-bios/
-- **Governor:** Multiple forks (Oberon, Cyan Skillfish)
+- **Governor:** [Cyan Skillfish Governor SMU](https://github.com/filippor/cyan-skillfish-governor/tree/smu) (recommended)
 
 ### Community
 - **Discord:** Active community, link in GitHub
@@ -382,7 +385,7 @@ RADV_DEBUG=nohiz %command%
 ### Key Contributors
 - mothenjoyer69 - Setup scripts
 - Average Data Hoarder - Modded BIOS
-- Segfault - Oberon Governor
+- Magnap - Cyan Skillfish Governor
 - FilippoR - COPR packages, Bazzite integration
 
 ---
diff --git a/docs/system/governor.md b/docs/system/governor.md
index c6a4dc2..0411b43 100644
--- a/docs/system/governor.md
+++ b/docs/system/governor.md
@@ -37,7 +37,7 @@ The GPU governor is essential for BC-250 performance, enabling dynamic frequency
 
 ## Governor Options
 
-### Cyan-Skillfish Governor TT (Recommended)
+### Cyan-Skillfish Governor TT (Alternative)
 
 **Developer:** filippor (based on Magnap's work)
 **Type:** Multi-step governor with thermal throttling
@@ -48,7 +48,7 @@ The GPU governor is essential for BC-250 performance, enabling dynamic frequency
 - Multiple frequency steps with thermal throttling
 - Maintains GPU usage in optimal range
 - Available as COPR/RPM, AUR, .deb, Nix
-- Community default for Bazzite/Fedora (Jan 2026+)
+- Requires kernel frequency range patch (pre-included in Bazzite)
 
 **COPR:** `filippor/bazzite`
 **Repository:** [github.com/Magnap/cyan-skillfish-governor](https://github.com/Magnap/cyan-skillfish-governor)
@@ -60,19 +60,22 @@ The GPU governor is essential for BC-250 performance, enabling dynamic frequency
     sudo cp /etc/cyan-skillfish-governor/config.toml /etc/cyan-skillfish-governor-tt/config.toml
     ```
 
-### Cyan-Skillfish Governor SMU (Kernel-Patch Free)
+### Cyan-Skillfish Governor SMU (Recommended)
 
 **Developer:** filippor / Magnap
 **Type:** SMU-based governor — bypasses kernel patches entirely
 **Service name:** `cyan-skillfish-governor-smu`
+**Config:** `/etc/cyan-skillfish-governor-smu/config.toml`
 **Released:** January 18, 2026
 
 **Features:**
 - Manages clock speeds through SMU firmware calls
 - **Does NOT require kernel frequency range patch on any distro**
 - Available on AUR (`cyan-skillfish-governor-smu`), COPR (`filippor/bazzite`), .deb, .rpm, Nix
-- Best option for CachyOS/Arch users who don't want to patch kernels
+- Works on all distros without kernel patching
+- Community recommended default (Mar 2026+)
 
+**COPR:** `filippor/bazzite`
 **Repository:** [github.com/filippor/cyan-skillfish-governor (smu branch)](https://github.com/filippor/cyan-skillfish-governor/tree/smu)
 
 ### Oberon Governor (Legacy — Still Stable)
@@ -93,7 +96,7 @@ The GPU governor is essential for BC-250 performance, enabling dynamic frequency
 
 **Repository:** [github.com/NexGen-3D-Printing/SteamMachine](https://github.com/NexGen-3D-Printing/SteamMachine)
 
-Installs cyan-skillfish-governor-tt + zram + CPU mitigations. De facto standard for Bazzite beginners.
+Automated Bazzite setup script that installs cyan-skillfish-governor-smu, configures swap/zram, and applies CPU mitigations. De facto standard for Bazzite beginners. NexGen3D's script references this documentation as the main guide.
 
 ### PS5GPU-BC250 (GUI Controller — New)
 
@@ -112,40 +115,50 @@ Installs cyan-skillfish-governor-tt + zram + CPU mitigations. De facto standard
 **Repository:** [github.com/ZEROAESQUERDA/PS5GPU-BC250](https://github.com/ZEROAESQUERDA/PS5GPU-BC250)
 
 !!!warning "Disable Other Governors First"
-    You must disable any running GPU governor (oberon, cyan-skillfish) before using PS5GPU-BC250. Running multiple frequency controllers simultaneously will cause conflicts.
+    You must disable any running GPU governor (cyan-skillfish-governor-smu, cyan-skillfish-governor-tt, or oberon) before using PS5GPU-BC250. Running multiple frequency controllers simultaneously will cause conflicts.
 
 ---
 
 ## Installation
 
-### Option 1: COPR (Fedora/Bazzite - Easiest)
+### Option 1: COPR / Package Manager (Easiest)
 
-COPR repositories are available for easy installation on Fedora and Bazzite. This eliminates the need to compile from source.
+Pre-built packages are available for all major distros.
 
-**For Cyan-Skillfish Governor TT (Recommended):**
+**Fedora (dnf):**
 ```bash
-# Add filippor's COPR repository
-sudo dnf copr enable filippor/bazzite
-
-# Install cyan-skillfish-governor-tt (note the -tt suffix)
-sudo dnf install cyan-skillfish-governor-tt
-
-# Enable and start service
-sudo systemctl enable --now cyan-skillfish-governor-tt.service
-```
-
-**For SMU Governor (No Kernel Patch Needed):**
-```bash
-# Fedora/Bazzite:
 sudo dnf copr enable filippor/bazzite
 sudo dnf install cyan-skillfish-governor-smu
 sudo systemctl enable --now cyan-skillfish-governor-smu.service
+```
 
-# Arch/CachyOS:
+**Bazzite (rpm-ostree):**
+```bash
+sudo dnf copr enable filippor/bazzite
+rpm-ostree install cyan-skillfish-governor-smu
+systemctl reboot
+# After reboot:
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
+```
+
+**Arch/CachyOS (AUR):**
+```bash
 yay -S cyan-skillfish-governor-smu
 sudo systemctl enable --now cyan-skillfish-governor-smu.service
 ```
 
+**For TT Governor (Alternative — Requires Kernel Patch):**
+```bash
+# Fedora/Bazzite:
+sudo dnf copr enable filippor/bazzite
+sudo dnf install cyan-skillfish-governor-tt
+sudo systemctl enable --now cyan-skillfish-governor-tt.service
+
+# Arch/CachyOS:
+yay -S cyan-skillfish-governor-tt
+sudo systemctl enable --now cyan-skillfish-governor-tt.service
+```
+
 !!!warning "Important: Verify GPU Device Targeting"
     After installation, verify the governor is targeting the correct GPU device:
 
@@ -157,132 +170,53 @@ sudo systemctl enable --now cyan-skillfish-governor-smu.service
     Using COPR packages means you don't need to manually compile the governor from source. The packages are pre-built and maintained.
 
 !!!info "COPR Package Status"
-    The `filippor/bazzite` COPR provides `cyan-skillfish-governor-tt` which is confirmed working as of Dec 2025–Mar 2026.
+    The `filippor/bazzite` COPR provides both `cyan-skillfish-governor-smu` (recommended) and `cyan-skillfish-governor-tt` (alternative). Confirmed working as of Mar 2026.
 
-    **Use `@exotic-soc/oberon-governor`** for the original Oberon governor - this is the working package that properly handles the BC-250's sysfs interface.
+### Option 2: Debian/Ubuntu (.deb)
 
-### Option 2: Build from Source (All Distros)
-
-**Install Dependencies:**
-
-```bash
-# Fedora
-sudo dnf install -y libdrm-devel cmake make gcc-c++ git
-
-# Arch
-sudo pacman -S base-devel cmake git
-
-# Debian/Ubuntu
-sudo apt install build-essential cmake git libdrm-dev libyaml-cpp-dev
-```
-
-**Clone and Build:**
-
-```bash
-# Clone repository
-git clone https://gitlab.com/mothenjoyer69/oberon-governor.git
-cd oberon-governor
-
-# Build
-cmake . && make
-
-# Install
-sudo make install
-
-# Enable service
-sudo systemctl enable --now oberon-governor.service
-```
-
-### Option 3: Bazzite Automated Script
-
-```bash
-# Download and run setup script
-curl -s https://raw.githubusercontent.com/vietsman/bc250-documentation/refs/heads/main/oberon-setup.sh | sudo sh
-
-# Verify installation
-systemctl status oberon-governor
-```
-
-### Option 4: Cyan-Skillfish Governor (Other Distros)
-
-**Arch/CachyOS:**
-```bash
-# TT version (requires kernel patch or Bazzite):
-yay -S cyan-skillfish-governor-tt
-# SMU version (no kernel patch needed — recommended for Arch/CachyOS):
-yay -S cyan-skillfish-governor-smu
-```
-
-**Debian/Ubuntu:**
 ```bash
 # Download .deb from GitHub releases
 # Check https://github.com/Magnap/cyan-skillfish-governor/releases for latest
-wget https://github.com/Magnap/cyan-skillfish-governor/releases/latest/download/cyan-skillfish-governor-tt_amd64.deb
-sudo dpkg -i cyan-skillfish-governor-tt_amd64.deb
+wget https://github.com/Magnap/cyan-skillfish-governor/releases/latest/download/cyan-skillfish-governor-smu_amd64.deb
+sudo dpkg -i cyan-skillfish-governor-smu_amd64.deb
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 ```
 
+### Option 3: Other Distros / Build from Source
+
+See [github.com/Magnap/cyan-skillfish-governor](https://github.com/Magnap/cyan-skillfish-governor) for build instructions. The SMU variant is in the `smu` branch.
+
 ## Configuration
 
-### Oberon Governor Config
+### Cyan-Skillfish Governor SMU Config (Recommended)
 
-**Config File:** `/etc/oberon-config.yaml`
+**Config File:** `/etc/cyan-skillfish-governor-smu/config.toml`
 
-**Default Configuration:**
-```yaml
-opps:
-  frequency:
-    min: 1000    # Minimum GPU frequency (MHz)
-    max: 2000    # Maximum GPU frequency (MHz)
-  voltage:
-    min: 700     # Minimum voltage (mV)
-    max: 1000    # Maximum voltage (mV)
-```
+**Example Configuration:**
+```toml
+# Define voltage points (frequency MHz, voltage mV)
+safe-points = [
+    [1000, 700],   # 1000 MHz @ 700 mV (idle)
+    [1500, 900],   # 1500 MHz @ 900 mV
+    [2000, 1000],  # 2000 MHz @ 1000 mV (gaming)
+    [2175, 1025],  # 2175 MHz @ 1025 mV (boost)
+    [2300, 1075],  # 2300 MHz @ 1075 mV (OC, good air cooling)
+]
 
-**Safe Overclocking Config:**
-```yaml
-opps:
-  frequency:
-    min: 1000
-    max: 2175    # Slight overclock
-  voltage:
-    min: 700
-    max: 1025    # Slightly higher voltage for stability
+# GPU load target range (70-95%)
+[load_target]
+min = 0.70
+max = 0.95
+
+# Timing configuration
+[timing]
+interval_ms = 50       # Sampling interval
+burst_samples = 20     # Samples before burst to max
 ```
 
 **Restart after changes:**
 ```bash
-sudo systemctl restart oberon-governor
-```
-
-### Filip's Multi-Step Config
-
-**Config File:** `/etc/oberon-config.yaml`
-
-**Advanced Multi-Step Configuration:**
-
-!!!warning "Requires Kernel Patch (or SMU Governor)"
-    The 350 MHz minimum frequency requires either the GPU frequency range kernel patch (pre-included in Bazzite) or the SMU governor. On stock kernels without the patch, the governor will crash with `std::__ios_failure`. Use `min: 1000` on stock kernels, or switch to `cyan-skillfish-governor-smu` which bypasses the patch requirement entirely.
-
-```yaml
-opps:
-  frequency:
-    min: 350     # Requires kernel patch! Use 1000 on stock kernel
-    max: 2175    # Overclocked maximum
-  voltage:
-    min: 700
-    max: 1025
-  steps: 24      # Number of frequency steps (creates 25 levels: 0-24)
-
-governor:
-  polling_delay_ms: 50        # How often to check GPU load
-  up_threshold_high: 85       # Load % to jump to maximum
-  up_threshold_low: 70        # Load % to step up one level
-  down_threshold_high: 45     # Load % to step down one level
-  down_threshold_low: 5       # Load % to drop to minimum
-  gfx_temp_soft_lim: 80       # Temp to step down (°C)
-  gfx_temp_hard_lim: 90       # Temp to drop to minimum (°C)
-  soc_temp_hard_lim: 90       # SoC temp limit (°C)
-  overheat_reset_ms: 10000    # Cool-down time after overheat
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 ### Cyan-Skillfish Governor TT Config
@@ -332,8 +266,8 @@ echo vc 0 2000 1000 > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_cl
 
 ```bash
 # Check service status (use whichever you installed)
-systemctl status cyan-skillfish-governor-tt
-# Or: systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
+# Or: systemctl status cyan-skillfish-governor-tt
 
 # Should show: active (running)
 ```
@@ -398,34 +332,34 @@ mangohud %command%  # Steam launch option
 **Check service:**
 ```bash
 # Check whichever governor you installed:
-sudo systemctl status cyan-skillfish-governor-tt
-# Or: sudo systemctl status oberon-governor
+sudo systemctl status cyan-skillfish-governor-smu
+# Or: sudo systemctl status cyan-skillfish-governor-tt
 
 # Check logs
-sudo journalctl -u cyan-skillfish-governor-tt
-# Or: sudo journalctl -u oberon-governor
+sudo journalctl -u cyan-skillfish-governor-smu
+# Or: sudo journalctl -u cyan-skillfish-governor-tt
 ```
 
 **Solutions:**
 
 **1. Enable service:**
 ```bash
-sudo systemctl enable cyan-skillfish-governor-tt
-# Or: sudo systemctl enable oberon-governor
+sudo systemctl enable cyan-skillfish-governor-smu
+# Or: sudo systemctl enable cyan-skillfish-governor-tt
 ```
 
 **2. Check config file exists:**
 ```bash
-ls -l /etc/cyan-skillfish-governor-tt/config.toml
-# Or: ls -l /etc/oberon-config.yaml
+ls -l /etc/cyan-skillfish-governor-smu/config.toml
+# Or: ls -l /etc/cyan-skillfish-governor-tt/config.toml
 
 # If missing, reinstall governor
 ```
 
 **3. Manual restart:**
 ```bash
-sudo systemctl restart cyan-skillfish-governor-tt
-# Or: sudo systemctl restart oberon-governor
+sudo systemctl restart cyan-skillfish-governor-smu
+# Or: sudo systemctl restart cyan-skillfish-governor-tt
 ```
 
 **Workaround (Arch/CachyOS):**
@@ -440,52 +374,47 @@ Some users report governor doesn't activate until GPU is used:
 1. Governor not running
 2. Config file missing/incorrect
 3. Governor binary not installed
-4. Wrong COPR package installed (filippor vs exotic-soc)
 
 **Debug:**
 ```bash
 # Check governor binary exists (use whichever you installed)
-which cyan-skillfish-governor-tt
-# Or: which oberon-governor
+which cyan-skillfish-governor-smu
+# Or: which cyan-skillfish-governor-tt
 
 # Check config
-cat /etc/cyan-skillfish-governor-tt/config.toml
-# Or: cat /etc/oberon-config.yaml
+cat /etc/cyan-skillfish-governor-smu/config.toml
+# Or: cat /etc/cyan-skillfish-governor-tt/config.toml
 
 # Check for errors in logs
-sudo journalctl -u cyan-skillfish-governor-tt --no-pager -n 20
+sudo journalctl -u cyan-skillfish-governor-smu --no-pager -n 20
 ```
 
-### Governor Crashes with iostream Error
+### Migrating from Oberon Governor
 
-**Symptoms:**
-```
-terminate called after throwing an instance of 'std::__ios_failure'
-  what():  basic_ios::clear: iostream error
-Aborted
-```
+If you're still running the legacy oberon-governor, migrate to cyan-skillfish-governor-smu:
 
-**Cause:** Wrong COPR package. The `filippor:bazzite` oberon-governor package is incompatible with kernel 6.17+.
-
-**Solution:**
 ```bash
-# Remove broken package
-sudo dnf remove oberon-governor
+# Stop and disable oberon
+sudo systemctl stop oberon-governor
+sudo systemctl disable oberon-governor
 
-# Disable broken COPR
-sudo dnf copr disable filippor/bazzite
+# Remove oberon package
+sudo dnf remove oberon-governor              # Fedora/Bazzite
+# Or: sudo pacman -R oberon-governor         # Arch
+# Or: rpm-ostree uninstall oberon-governor   # Bazzite (rpm-ostree)
 
-# Add working COPR
-sudo dnf copr enable @exotic-soc/oberon-governor
+# Remove old config
+sudo rm -f /etc/oberon-config.yaml
 
-# Install working package
-sudo dnf install oberon-governor
+# Install replacement
+sudo dnf copr enable filippor/bazzite
+sudo dnf install cyan-skillfish-governor-smu
 
 # Enable and start
-sudo systemctl enable --now oberon-governor.service
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 
 # Verify it's running
-systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
 ```
 
 **Verify fix:**
@@ -507,8 +436,8 @@ cat /sys/class/drm/card1/device/pp_dpm_sclk
 **Cause:** When the GPU crashes while the governor is actively managing frequencies, the GPU reset mechanism can't complete properly. The governor continues trying to write to sysfs during the reset, preventing recovery.
 
 **Workaround:**
-- Disable governor before playing crash-prone games: `sudo systemctl stop cyan-skillfish-governor-tt`
-- Re-enable after: `sudo systemctl start cyan-skillfish-governor-tt`
+- Disable governor before playing crash-prone games: `sudo systemctl stop cyan-skillfish-governor-smu`
+- Re-enable after: `sudo systemctl start cyan-skillfish-governor-smu`
 
 **Long-term fix:** Use stable voltage/frequency settings that don't cause GPU crashes in the first place. If a specific game consistently crashes the GPU, increase voltage or reduce max frequency.
 
@@ -526,18 +455,22 @@ cat /sys/class/drm/card1/device/pp_dpm_sclk
 **Solutions:**
 
 **1. Increase voltage:**
-```yaml
-# Edit /etc/oberon-config.yaml
-opps:
-  voltage:
-    max: 1050  # Increase from 1000 to 1050
+```toml
+# Edit /etc/cyan-skillfish-governor-smu/config.toml
+# Increase max voltage in safe-points
+safe-points = [
+    [1000, 700],
+    [2000, 1050],  # Increase from 1000 to 1050
+]
 ```
 
 **2. Reduce max frequency:**
-```yaml
-opps:
-  frequency:
-    max: 1900  # Reduce from 2000
+```toml
+# Remove or lower the highest safe-point
+safe-points = [
+    [1000, 700],
+    [1900, 1000],  # Reduce from 2000
+]
 ```
 
 **3. Check temperatures:**
@@ -549,57 +482,55 @@ sensors
 ### Governor High CPU Usage
 
 **Normal CPU Usage:**
-- Oberon original: 0.4% CPU
-- Filip's enhanced: 0.4-1.0% CPU
-- Cyan-Skillfish: 0.9-1.3% CPU
+- Cyan-Skillfish SMU: 0.9-1.3% CPU
+- Cyan-Skillfish TT: 0.9-1.3% CPU
 
 **If CPU usage > 2%:**
 
 **Check polling interval:**
-```yaml
-# Reduce polling frequency
-governor:
-  polling_delay_ms: 100  # Increase from 50
+```toml
+# Edit /etc/cyan-skillfish-governor-smu/config.toml
+[timing]
+interval_ms = 100  # Increase from 50
 ```
 
 **Check for bugs:**
 ```bash
 # View governor logs (use whichever you installed)
-sudo journalctl -u cyan-skillfish-governor-tt -f
-# Or: sudo journalctl -u oberon-governor -f
+sudo journalctl -u cyan-skillfish-governor-smu -f
+# Or: sudo journalctl -u cyan-skillfish-governor-tt -f
 ```
 
 ## Performance Comparison
 
-| Governor | Idle Freq | Max Freq | CPU Usage | Response Time | Performance |
+| Governor | Idle Freq | Max Freq | CPU Usage | Response Time | Kernel Patch |
 |----------|-----------|----------|-----------|---------------|-------------|
-| **None** | 1500 MHz | 1500 MHz | 0% | N/A | ⭐⭐ |
-| **Oberon** | 1000 MHz | 2000 MHz | 0.4% | 100ms | ⭐⭐⭐⭐ |
-| **Filip's** | 350-1000 MHz | 2175 MHz | 0.4-1.0% | 50-100ms | ⭐⭐⭐⭐⭐ |
-| **Cyan-Skillfish** | Variable | 2000+ MHz | 0.9-1.3% | 24ms | ⭐⭐⭐⭐⭐ |
+| **None** | 1500 MHz | 1500 MHz | 0% | N/A | No |
+| **SMU (Recommended)** | Variable | 2300+ MHz | 0.9-1.3% | 24ms | No |
+| **TT (Alternative)** | Variable | 2175+ MHz | 0.9-1.3% | 24ms | Yes |
+| **Oberon (Legacy)** | 1000 MHz | 2000 MHz | 0.4% | 100ms | Yes |
 
 ## Governor Comparison
 
-### When to Use Oberon (Original)
+### When to Use Cyan-Skillfish SMU (Recommended)
 
-- **Simple setup:** Just works out-of-box
-- **Proven stability:** Most tested
-- **Low overhead:** Minimal CPU usage
-- **Best for:** Beginners, stability-focused builds
+- **No kernel patches:** Works on any distro without patching
+- **Maximum control:** Precise frequency control via SMU firmware
+- **Best efficiency:** Continuous scaling with multiple voltage points
+- **Best for:** All users, especially CachyOS/Arch where kernel patching is extra work
 
-### When to Use Filip's Enhanced
+### When to Use Cyan-Skillfish TT
 
-- **Better performance:** Multi-step scaling
-- **Available as package:** Easy to install
-- **Good balance:** Performance + stability
-- **Best for:** Most users, gaming builds
+- **Multi-step scaling:** Thermal throttling awareness
+- **Available as package:** Easy to install on Bazzite (kernel pre-patched)
+- **Best for:** Bazzite users who already have the kernel patch
 
-### When to Use Cyan-Skillfish
+### When to Use Oberon (Legacy)
 
-- **Maximum control:** Precise frequency control
-- **Best efficiency:** Continuous scaling
-- **Advanced config:** Multiple voltage points
-- **Best for:** Advanced users, overclockers
+- **Simple setup:** Two-state governor (min/max)
+- **Proven stability:** Oldest, most tested
+- **Low overhead:** 0.4% CPU usage
+- **Note:** No longer actively recommended — migrate to SMU
 
 ## Overclocking with Governor
 
@@ -609,8 +540,8 @@ sudo journalctl -u cyan-skillfish-governor-tt -f
 
 ```bash
 # Stop governor (use whichever you installed)
-sudo systemctl stop cyan-skillfish-governor-tt
-# Or: sudo systemctl stop oberon-governor
+sudo systemctl stop cyan-skillfish-governor-smu
+# Or: sudo systemctl stop cyan-skillfish-governor-tt
 
 # Manually set test frequency
 echo vc 0 2100 1050 > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_clk_voltage
@@ -622,31 +553,37 @@ echo vc 0 2100 1050 > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_cl
 
 **Step 2: Update Governor Config**
 
-```yaml
-# /etc/oberon-config.yaml
-opps:
-  frequency:
-    max: 2100  # Your stable frequency
-  voltage:
-    max: 1050  # Your stable voltage
+```toml
+# /etc/cyan-skillfish-governor-smu/config.toml
+safe-points = [
+    [1000, 700],
+    [2000, 1000],
+    [2100, 1050],  # Your stable frequency/voltage
+]
 ```
 
 **Step 3: Restart and Test**
 
 ```bash
-sudo systemctl restart cyan-skillfish-governor-tt
-# Or: sudo systemctl restart oberon-governor
+sudo systemctl restart cyan-skillfish-governor-smu
+# Or: sudo systemctl restart cyan-skillfish-governor-tt
 
 # Test with games/benchmarks
 # Monitor temperatures
 ```
 
-**Known GPU Limits:**
+**Known GPU Limits (cooling dependent):**
+
 - **350 MHz:** Minimum with kernel frequency range patch
 - **1000 MHz:** Minimum on stock kernel
-- **2000 MHz @ 1000mV:** Safe starting point
-- **2100-2175 MHz @ 1025mV:** Works on many boards, test thoroughly
-- **2230 MHz:** Maximum confirmed stable with kernel patch, requires good cooling
+- **2000 MHz @ 1000 mV:** Safe starting point for all boards
+- **2100-2175 MHz @ 1025-1050 mV:** Works on many boards, test thoroughly
+- **2230 MHz @ 1060 mV:** Air cooled, conservative maximum
+- **2300 MHz @ 1075 mV:** Good air cooling (Arctic P12 Max or better)
+- **2400 MHz @ 1125 mV:** Liquid cooling only (per NexGen3D testing)
+
+!!!warning "Cooling Determines Your Limit"
+    Maximum stable frequency depends heavily on your cooling solution. The limits above assume sustained load. Test with 30+ minutes of gaming at each step before committing settings.
 
 ## CPU Overclocking with bc250_smu_oc
 
@@ -773,7 +710,7 @@ echo schedutil | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor
 
 ## Community Resources
 
-- [NexGen3D SteamMachine Scripts](https://github.com/NexGen-3D-Printing/SteamMachine) — automated Bazzite setup (governor + zram + CPU mitigations)
+- [NexGen3D SteamMachine Scripts](https://github.com/NexGen-3D-Printing/SteamMachine) — automated Bazzite setup (governor + swap/zram + CPU mitigations); links to this documentation as the main guide
 - [DeathStalker Grimoire](https://github.com/DeathStalker471/bc250theGrimoire) — community step-by-step guide
 - [PS5GPU-BC250](https://github.com/ZEROAESQUERDA/PS5GPU-BC250) — GUI GPU controller
 - [cyan-skillfish-governor-smu](https://github.com/filippor/cyan-skillfish-governor/tree/smu) — SMU governor (no kernel patch needed)
diff --git a/docs/system/power.md b/docs/system/power.md
index 66cd188..3e32594 100644
--- a/docs/system/power.md
+++ b/docs/system/power.md
@@ -116,9 +116,9 @@ Recommended Amps = 25A for safety margin
 
 The governor is essential for power management and efficiency.
 
-**Cyan Skillfish Governor TT Configuration (recommended):**
+**Cyan Skillfish Governor SMU Configuration (recommended):**
 
-Default location: `/etc/cyan-skillfish-governor-tt/config.toml`
+Default location: `/etc/cyan-skillfish-governor-smu/config.toml`
 
 ```toml
 min_frequency = 1000  # MHz
@@ -138,18 +138,18 @@ max_voltage = 950     # Lower max voltage
 
 Apply changes:
 ```bash
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
-**Oberon Governor Configuration (legacy):**
+**SMU Governor Configuration (recommended):**
 
-Default configuration file: `/etc/oberon-config.yaml` — see [Governor page](governor.md) for details.
+Default configuration file: `/etc/cyan-skillfish-governor-smu/config.toml` — see [Governor page](governor.md) for details.
 
 **More Granular Control:**
 
-Cyan Skillfish Governor TT supports multiple voltage/frequency points.
+Cyan Skillfish Governor SMU supports multiple voltage/frequency points.
 
-Default location: `/etc/cyan-skillfish-governor-tt/config.toml`
+Default location: `/etc/cyan-skillfish-governor-smu/config.toml`
 
 ```toml
 # Multiple safe-points for precise voltage control
@@ -177,7 +177,7 @@ max = 95
 
 Apply changes:
 ```bash
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 ### Manual Power Limiting (Advanced)
@@ -186,7 +186,7 @@ sudo systemctl restart cyan-skillfish-governor-tt
 
 ```bash
 # Stop governor first
-sudo systemctl stop cyan-skillfish-governor-tt
+sudo systemctl stop cyan-skillfish-governor-smu
 
 # Set custom values
 echo "vc 0 1800 950" > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_clk_voltage
@@ -272,15 +272,15 @@ Without governor: 105W idle
 With governor: 85W idle (20W savings)
 
 ```bash
-# Install cyan-skillfish-governor-tt (Fedora/Bazzite)
+# Install cyan-skillfish-governor-smu (Fedora/Bazzite)
 sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-tt
-sudo systemctl enable --now cyan-skillfish-governor-tt
+sudo dnf install cyan-skillfish-governor-smu
+sudo systemctl enable --now cyan-skillfish-governor-smu
 ```
 
 **Step 2: Optimize Governor Settings**
 
-Edit `/etc/cyan-skillfish-governor-tt/config.toml` for lower idle power:
+Edit `/etc/cyan-skillfish-governor-smu/config.toml` for lower idle power:
 
 ```toml
 min_frequency = 1000  # Allow GPU to idle lower
@@ -425,7 +425,7 @@ Max frequencies (2000-2300 MHz): Voltage requirements vary by silicon
 **Conservative (Maximum Stability):**
 
 ```toml
-# Cyan Skillfish Governor TT
+# Cyan Skillfish Governor SMU
 min_frequency = 1000
 max_frequency = 2000
 min_voltage = 700
@@ -475,14 +475,13 @@ voltage = 1035
 
 ### Governor Behavior Comparison
 
-**Oberon Governor (legacy):**
-- Binary mode: Switches between min and max frequency
-- Set point: 20-40% GPU load (with hysteresis)
-- Response time: 100 ms to burst to max
-- CPU usage: 0.4% idle, 0.4% under load
-- Simple, stable, proven
+**Cyan Skillfish Governor SMU (recommended):**
+- Continuous adjustment between multiple frequency steps
+- Manages clocks through SMU firmware calls — no kernel patch needed
+- Same performance characteristics as TT variant
+- CPU usage: 0.9% idle, 1.3% under load
 
-**Cyan Skillfish Governor TT (recommended):**
+**Cyan Skillfish Governor TT (alternative):**
 - Continuous adjustment between multiple frequency steps
 - Set point: 70-95% GPU load (configurable)
 - Response time: 20-24 ms to burst to max
@@ -491,9 +490,9 @@ voltage = 1035
 
 **Which to Choose:**
 
-- **Cyan Skillfish TT**: Recommended default — better power efficiency, smoother performance, thermal throttling support
-- **Cyan Skillfish SMU**: No kernel patches needed — bypasses kernel frequency/voltage limits via SMU firmware
-- **Oberon**: Legacy option — lower CPU overhead, simpler config
+- **Cyan Skillfish SMU**: Recommended default — no kernel patches needed, bypasses kernel frequency/voltage limits via SMU firmware
+- **Cyan Skillfish TT**: Alternative — thermal throttling support, requires kernel patch (pre-included in Bazzite)
+- **Oberon**: Legacy option — migrate to SMU
 
 ---
 
@@ -516,7 +515,7 @@ voltage = 1035
 **Solutions:**
 ```toml
 # Option 1: Reduce max frequency
-# Edit /etc/cyan-skillfish-governor-tt/config.toml
+# Edit /etc/cyan-skillfish-governor-smu/config.toml
 max_frequency = 1800  # Reduced from 2000
 
 # Option 2: Increase voltage
@@ -553,11 +552,10 @@ max_voltage = 1025    # Increased from 1000
 - Unstable undervolt
 
 **Solutions:**
-```bash
+```toml
 # Increase voltage in 25 mV steps
-# Edit /etc/oberon-config.yaml
-  - voltage:
-    - max: 1025  # Increase until stable
+# Edit /etc/cyan-skillfish-governor-smu/config.toml
+# Increase max voltage in your safe-points until stable
 ```
 
 **4. High Idle Power (>100W)**
@@ -573,10 +571,10 @@ max_voltage = 1025    # Increased from 1000
 **Solutions:**
 ```bash
 # Check governor status
-systemctl status cyan-skillfish-governor-tt
+systemctl status cyan-skillfish-governor-smu
 
 # If not running
-sudo systemctl enable --now cyan-skillfish-governor-tt
+sudo systemctl enable --now cyan-skillfish-governor-smu
 
 # Verify GPU frequency scaling
 cat /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_dpm_sclk
@@ -603,7 +601,7 @@ cat /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_dpm_sclk
 **Temporary workaround (not recommended long-term):**
 ```yaml
 # Force governor to maintain frequency even when hot
-# Edit /etc/cyan-skillfish-governor-tt/config.toml to set min = max
+# Edit /etc/cyan-skillfish-governor-smu/config.toml to set min = max
 # min_frequency = 2000
 # max_frequency = 2000
 ```
@@ -623,6 +621,85 @@ cat /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_dpm_sclk
 
 **Current Status:** Community investigating, no reliable method yet.
 
+### Swap and ZRAM Optimization
+
+The BC-250 has only 8GB usable system RAM (with 512MB dynamic VRAM), so swap configuration matters for gaming stability.
+
+**Recommended: Disable ZRAM, enable zswap with lz4, create swap file**
+
+ZRAM compressed swap conflicts with 512MB dynamic VRAM allocation and causes crashes in memory-hungry games (RDR2, Company of Heroes 3). The recommended approach is to replace ZRAM with zswap and a disk-backed swap file.
+
+**Bazzite (rpm-ostree):**
+
+```bash
+# 1. Disable zram
+echo "" | sudo tee /etc/systemd/zram-generator.conf
+
+# 2. Create 16-32GB swap file (see https://docs.bazzite.gg/Advanced/swapfile/)
+sudo btrfs filesystem mkswapfile --size 16G /swap/swapfile
+sudo swapon /swap/swapfile
+echo '/swap/swapfile none swap defaults 0 0' | sudo tee -a /etc/fstab
+
+# 3. Enable lz4 compression in initramfs
+rpm-ostree initramfs --enable \
+  --arg=--add-drivers \
+  --arg=lz4 \
+  --arg=--add-drivers \
+  --arg=lz4_compress
+
+# 4. Enable zswap and set swappiness
+rpm-ostree kargs --append-if-missing="zswap.enabled=1 zswap.max_pool_percent=25 zswap.compressor=lz4"
+
+# 5. Reboot, then set swappiness
+systemctl reboot
+echo 180 | sudo tee /proc/sys/vm/swappiness
+# Make permanent:
+echo 'vm.swappiness=180' | sudo tee -a /etc/sysctl.d/99-swap.conf
+```
+
+**Fedora (dnf):**
+
+```bash
+# 1. Disable zram
+sudo systemctl stop zram-swap
+sudo systemctl disable zram-swap
+
+# 2. Create swap file
+sudo dd if=/dev/zero of=/swapfile bs=1G count=16
+sudo chmod 600 /swapfile
+sudo mkswap /swapfile
+sudo swapon /swapfile
+echo '/swapfile none swap defaults 0 0' | sudo tee -a /etc/fstab
+
+# 3. Enable zswap
+echo 'zswap.enabled=1 zswap.max_pool_percent=25 zswap.compressor=lz4' >> /etc/default/grub
+sudo grub2-mkconfig -o /boot/grub2/grub.cfg
+
+# 4. Set swappiness
+echo 'vm.swappiness=180' | sudo tee /etc/sysctl.d/99-swap.conf
+sudo sysctl -p /etc/sysctl.d/99-swap.conf
+```
+
+**Why vm.swappiness=180:**
+With zswap enabled, a swappiness of 180 (above the default 60) tells the kernel to prefer compressing and swapping pages over dropping file caches. This improves memory management on low-RAM systems like the BC-250 by keeping more application data resident while swapping out less-used pages efficiently.
+
+**Verify:**
+```bash
+# Check zswap is active
+grep -r . /sys/module/zswap/parameters/
+
+# Check swap is enabled
+swapon --show
+
+# Check swappiness
+cat /proc/sys/vm/swappiness
+```
+
+!!!info "Source"
+    Swap optimization approach based on [NexGen3D's SteamMachine script](https://github.com/NexGen-3D-Printing/SteamMachine).
+
+---
+
 ### Memory Power Management
 
 **GDDR6 Memory Characteristics:**
@@ -645,7 +722,7 @@ cat /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_dpm_sclk
 **For Gaming (Balance Performance/Power):**
 
 ```toml
-# /etc/cyan-skillfish-governor-tt/config.toml
+# /etc/cyan-skillfish-governor-smu/config.toml
 min_frequency = 1000
 max_frequency = 2000
 min_voltage = 700
@@ -660,7 +737,7 @@ Expected results:
 **For Power Efficiency (Low Consumption):**
 
 ```toml
-# /etc/cyan-skillfish-governor-tt/config.toml
+# /etc/cyan-skillfish-governor-smu/config.toml
 [[safe-points]]
 frequency = 350
 voltage = 700
@@ -689,14 +766,12 @@ Expected results:
 
 **For Performance (Maximum FPS):**
 
-```yaml
-opps:
-  - frequency:
-    - min: 2000
-    - max: 2230
-  - voltage:
-    - min: 1000
-    - max: 1050
+```toml
+# /etc/cyan-skillfish-governor-smu/config.toml
+safe-points = [
+    [2000, 1000],
+    [2230, 1050],
+]
 ```
 
 Expected results:
@@ -738,9 +813,9 @@ Expected results:
 
 **Check Governor Status:**
 ```bash
-systemctl status cyan-skillfish-governor-tt
-# or if using legacy governor:
-# systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
+# or if using TT governor:
+# systemctl status cyan-skillfish-governor-smu
 ```
 
 **Check Current Power State:**
@@ -785,14 +860,14 @@ sensors | grep PPT
 | High temps + high power | Undervolt needed | Reduce max voltage by 50 mV |
 | Fan speed drops | PSU voltage droop | Upgrade PSU capacity |
 | Unstable after undervolt | Voltage too low | Increase voltage by 25 mV |
-| Governor not working | Service not running | `systemctl enable --now cyan-skillfish-governor-tt` |
+| Governor not working | Service not running | `systemctl enable --now cyan-skillfish-governor-smu` |
 
 ---
 
 ## Additional Resources
 
 **Governor Projects:**
-- [Cyan Skillfish Governor TT/SMU](https://github.com/filippor/cyan-skillfish-governor) (recommended)
+- [Cyan Skillfish Governor SMU](https://github.com/filippor/cyan-skillfish-governor/tree/smu) (recommended)
 - [Oberon Governor](https://gitlab.com/mothenjoyer69/oberon-governor) (legacy)
 
 **Power Monitoring:**
diff --git a/docs/troubleshooting/display.md b/docs/troubleshooting/display.md
index a5b2d82..1309869 100644
--- a/docs/troubleshooting/display.md
+++ b/docs/troubleshooting/display.md
@@ -108,8 +108,8 @@ sudo dnf install mesa-vulkan-drivers mesa-dri-drivers
 
 # Install GPU governor (recommended)
 sudo dnf copr enable filippor/bazzite
-sudo dnf install cyan-skillfish-governor-tt
-sudo systemctl enable --now cyan-skillfish-governor-tt.service
+sudo dnf install cyan-skillfish-governor-smu
+sudo systemctl enable --now cyan-skillfish-governor-smu.service
 
 # Then remove nomodeset:
 sudo nano /etc/default/grub
@@ -240,9 +240,9 @@ If GPU >90°C:
 If using custom governor settings:
 
 ```bash
-# Edit governor config (e.g., /etc/cyan-skillfish-governor-tt/config.toml)
+# Edit governor config (e.g., /etc/cyan-skillfish-governor-smu/config.toml)
 # Reduce max_frequency or increase voltage
-sudo systemctl restart cyan-skillfish-governor-tt
+sudo systemctl restart cyan-skillfish-governor-smu
 ```
 
 **3. Power Supply Issues**
@@ -254,8 +254,8 @@ sudo systemctl restart cyan-skillfish-governor-tt
 Test with lower power limit:
 ```bash
 # Limit max frequency to reduce power draw
-# Edit /etc/oberon-config.yaml
-max_frequency: 1500
+# Edit /etc/cyan-skillfish-governor-smu/config.toml
+# Set max safe-point to 1500 MHz
 ```
 
 **4. Display Adapter Overheating**
diff --git a/docs/troubleshooting/performance.md b/docs/troubleshooting/performance.md
index 718f233..ea7ca63 100644
--- a/docs/troubleshooting/performance.md
+++ b/docs/troubleshooting/performance.md
@@ -23,9 +23,9 @@ lspci -k | grep -A 3 VGA
 glxinfo | grep "OpenGL version"
 
 # Check governor status
-systemctl status cyan-skillfish-governor-tt
-# or if using legacy governor:
-# systemctl status oberon-governor
+systemctl status cyan-skillfish-governor-smu
+# or if using TT governor:
+# systemctl status cyan-skillfish-governor-tt
 ```
 
 ---
@@ -43,12 +43,12 @@ systemctl status cyan-skillfish-governor-tt
 
 The BC-250 requires a custom GPU governor to enable dynamic frequency scaling between 350-2300MHz (patched kernel) or 1000-2000MHz (unpatched kernel).
 
-### Option 1: Cyan Skillfish Governor TT (Recommended)
+### Option 1: Cyan Skillfish Governor SMU (Recommended)
 
 **Features:**
-- Continuous frequency adjustment (no steps)
+- Continuous frequency adjustment via SMU firmware calls
 - Maintains GPU utilization 70-95% (configurable)
-- Higher CPU overhead (0.9-1.3% CPU usage)
+- No kernel patch required on any distro
 - 24ms burst-to-max time
 - More responsive to burst loads
 
@@ -57,13 +57,11 @@ The BC-250 requires a custom GPU governor to enable dynamic frequency scaling be
 **Fedora/RPM:**
 ```bash
 dnf copr enable filippor/bazzite
-dnf install cyan-skillfish-governor-tt
+dnf install cyan-skillfish-governor-smu
 ```
 
 **Arch/AUR:**
 ```bash
-yay -S cyan-skillfish-governor-tt
-# Or for SMU variant (no kernel patch needed):
 yay -S cyan-skillfish-governor-smu
 ```
 
@@ -98,7 +96,7 @@ load_target = { min = 70, max = 95 }
 
     ```bash
     # Stop the governor
-    sudo systemctl stop cyan-skillfish-governor-tt
+    sudo systemctl stop cyan-skillfish-governor-smu
 
     # Manually set frequency/voltage
     echo vc 0 <CLOCK> <VOLTAGE> > /sys/devices/pci0000:00/0000:00:08.1/0000:01:00.0/pp_od_clk_voltage
@@ -109,7 +107,7 @@ load_target = { min = 70, max = 95 }
 
 Enable and start:
 ```bash
-sudo systemctl enable --now cyan-skillfish-governor-tt
+sudo systemctl enable --now cyan-skillfish-governor-smu
 ```
 
 ---
@@ -650,14 +648,14 @@ Use this checklist to verify your system is properly configured:
 
 - [ ] Mesa version 25.1.3 or higher
 - [ ] Kernel 6.18.18 LTS (recommended), 6.17.11+, or 6.12.x-6.14.x LTS (NOT 6.15.0-6.15.6 or 6.17.8-6.17.10)
-- [ ] GPU governor installed and running (cyan-skillfish-governor-tt recommended)
+- [ ] GPU governor installed and running (cyan-skillfish-governor-smu recommended)
 - [ ] `nomodeset` removed from kernel parameters
 - [ ] BIOS flashed to P3.00 with 512MB dynamic or 4-12GB fixed VRAM
 - [ ] `glxinfo` shows RADV driver, not llvmpipe
 - [ ] Temperatures under 85C under load
 - [ ] Cooling with high static pressure fan (>2.0 mmH2O)
 - [ ] IOMMU disabled in BIOS
-- [ ] `systemctl status cyan-skillfish-governor-tt` shows active
+- [ ] `systemctl status cyan-skillfish-governor-smu` shows active
 
 **Quick test:**
 ```bash
@@ -681,7 +679,7 @@ If you're still experiencing performance issues after following this guide:
 uname -r                    # Kernel version
 glxinfo | grep -i mesa      # Mesa version
 sensors                     # Temperatures
-systemctl status cyan-skillfish-governor-tt  # Governor status
+systemctl status cyan-skillfish-governor-smu  # Governor status
 dmesg | grep amdgpu | tail -50    # Recent GPU messages
 ```
 
diff --git a/docs/troubleshooting/stability.md b/docs/troubleshooting/stability.md
index 5fc9b9e..cd69bdc 100644
--- a/docs/troubleshooting/stability.md
+++ b/docs/troubleshooting/stability.md
@@ -53,14 +53,14 @@ Before diving into specific issues, check these common causes:
    - Some boards freeze at 60-65°C if cooling is inadequate
 
 4. **Test with locked frequency**
-   - Edit your governor config (e.g., `/etc/cyan-skillfish-governor-tt/config.toml`):
+   - Edit your governor config (e.g., `/etc/cyan-skillfish-governor-smu/config.toml`):
    ```toml
    min_frequency = 1500
    max_frequency = 1500
    min_voltage = 900
    max_voltage = 900
    ```
-   - Restart governor: `systemctl restart cyan-skillfish-governor-tt`
+   - Restart governor: `systemctl restart cyan-skillfish-governor-smu`
    - If stable at locked frequency, it's a governor tuning issue
 
 ### Thermal-Related Freezes
@@ -141,9 +141,9 @@ Before diving into specific issues, check these common causes:
 
 1. **Disable governor before playing crash-prone games**
    ```bash
-   sudo systemctl stop cyan-skillfish-governor-tt
+   sudo systemctl stop cyan-skillfish-governor-smu
    ```
-   Re-enable after: `sudo systemctl start cyan-skillfish-governor-tt`
+   Re-enable after: `sudo systemctl start cyan-skillfish-governor-smu`
 
 2. **Use stable voltage/frequency settings** to reduce the chance of GPU crashes in the first place — see the voltage-related instability section below.
 
@@ -158,7 +158,7 @@ Before diving into specific issues, check these common causes:
 **Common issues**:
 
 1. **Governor not starting correctly**
-   - Check status: `systemctl status cyan-skillfish-governor-tt`
+   - Check status: `systemctl status cyan-skillfish-governor-smu`
    - If failing, governor may be installed in wrong location
    - Reinstall following distribution-specific guide
 
@@ -170,7 +170,7 @@ Before diving into specific issues, check these common causes:
 3. **Frequency/voltage mismatch**
    - Symptom: Crashes when GPU load increases/decreases
    - Solution: Reduce frequency range or increase voltage headroom
-   - Example fix (cyan-skillfish-governor-tt config.toml):
+   - Example fix (cyan-skillfish-governor-smu config.toml):
    ```toml
    min_frequency = 1000
    max_frequency = 2000
@@ -785,7 +785,7 @@ If problems persist after trying these solutions:
      echo "=== Temperatures ==="
      sensors
      echo "=== Governor Status ==="
-     systemctl status cyan-skillfish-governor-tt
+     systemctl status cyan-skillfish-governor-smu
      echo "=== Recent Errors ==="
      journalctl -p err -n 50
    } > bc250-diagnostic.txt