From bf0b8b7264ae2e0a8e4937e48696bb7bf89ba4eb Mon Sep 17 00:00:00 2001 From: 28allday Date: Sat, 28 Mar 2026 12:32:13 +0000 Subject: [PATCH] Add comprehensive README with GPU support matrix and troubleshooting Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 194 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..479e762 --- /dev/null +++ b/README.md @@ -0,0 +1,194 @@ +# DaVinci Resolve - AMD Omarchy + +Install [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) on [Omarchy](https://omarchy.com) (Arch Linux + Hyprland) with AMD GPU support, including the new RX 9000 series (RDNA 4). + +Features a pre-installation system scanner that detects your GPU, drivers, OpenCL stack, display server, and audio — then builds a tailored package list for your exact setup. + +## Requirements + +- **OS**: [Omarchy](https://omarchy.com) (Arch Linux) or any Arch-based distro +- **GPU**: AMD (RDNA 1 through RDNA 4, including RX 9070/9080) +- **AUR Helper**: yay or paru +- **Compositor**: Hyprland (optional, but script adds window rules if detected) + +## Quick Start + +```bash +git clone https://github.com/28allday/DaVinci-Resolve-AMD-Omarchy.git +cd DaVinci-Resolve-AMD-Omarchy +chmod +x install-davinci-resolve.sh +./install-davinci-resolve.sh +``` + +The script will scan your system, show what it found, and ask before making any changes. + +## What It Does + +### 1. System Scan + +Before installing anything, the script scans your system to detect: + +| Component | What It Checks | +|-----------|---------------| +| **Kernel** | Version, RDNA 4 compatibility (needs 6.12+) | +| **GPU(s)** | Vendor, model, RDNA generation, discrete vs integrated | +| **Hybrid GPU** | Intel/AMD iGPU + discrete GPU detection, PRIME offload support | +| **Mesa** | Version, OpenGL renderer, Vulkan availability | +| **OpenCL** | Installed provider, whether AMD platform is actually working | +| **Audio** | PipeWire or PulseAudio detection | +| **Display** | Wayland/X11, compositor (Hyprland, Sway, GNOME, KDE) | +| **Resolve** | Existing installation detection | +| **Disk space** | Free space on root and home partitions | + +### 2. Smart Package Selection + +Based on the scan, it builds a package list that: +- Skips packages already installed +- Selects the right OpenCL provider for your GPU +- Removes conflicting packages (e.g. rusticl breaks ROCm) +- Adds hybrid GPU support if needed + +### 3. OpenCL Provider + +Two options (configurable in the script): + +| Provider | Source | Best For | +|----------|--------|----------| +| `opencl-amd` (default) | AUR | Recommended by Arch Wiki for Resolve | +| `rocm-full` | Official repos | Full ROCm/HIP stack, better RDNA 4 support | + +### 4. Installs DaVinci Resolve + +Installs via the AUR package (`davinci-resolve` or `davinci-resolve-studio`). + +### 5. Applies Compatibility Fixes + +| Fix | Method | Why | +|-----|--------|-----| +| **GLib conflict** | patchelf (davincibox-style) | Cleaner than LD_PRELOAD, survives updates | +| **OpenCL decoders** | Disable BlackmagicRaw OpenCL | Prevents crashes with AMD OpenCL | +| **Rusticl removal** | Removes conflicting packages | Mesa's rusticl breaks ROCm OpenCL | +| **XWayland wrapper** | Custom launcher script | Resolve doesn't support native Wayland | +| **RDNA 4 env vars** | HSA_OVERRIDE_GFX_VERSION | Tells ROCm how to talk to gfx1201 GPUs | + +### 6. Creates Launcher + +A wrapper script at `~/.local/bin/davinci-resolve` that: +- Forces XWayland mode (`QT_QPA_PLATFORM=xcb`) +- Sets ROCm/OpenCL environment variables +- Handles DRI_PRIME for hybrid GPU setups +- Sets RDNA 4 GFX version override if needed + +### 7. Configures Hyprland + +Adds window rules to `hyprland.conf` for Resolve's floating dialogs (file pickers, render settings, etc.) so they behave correctly under Hyprland. + +### 8. Bonus Tools + +- **resolve-convert** — Converts MP4/MKV to DNxHR format (DaVinci Resolve Free on Linux doesn't support H.264/H.265) +- **davinci-resolve-checker** — Community diagnostic tool for troubleshooting Resolve issues + +## Supported AMD GPUs + +| Generation | GPUs | Notes | +|-----------|------|-------| +| **RDNA 4** | RX 9070, 9080 | Needs kernel 6.12+, Mesa 25+ | +| **RDNA 3** | RX 7600–7900 | Full support | +| **RDNA 2** | RX 6400–6950 | Full support | +| **RDNA 1** | RX 5500–5700 | Full support | +| **Vega** | Vega 56/64 | Supported | +| **GCN** | Older cards | May work, not tested | + +## Hybrid GPU Support + +The script detects and handles these configurations: + +- **Intel iGPU + AMD dGPU** — Configures DRI_PRIME for discrete GPU +- **AMD iGPU + AMD dGPU** — Auto-selects discrete GPU +- **Intel iGPU + NVIDIA dGPU** — Advises on PRIME render offload +- **AMD iGPU + NVIDIA dGPU** — Advises on PRIME render offload + +## Configuration + +### Changing OpenCL Provider + +Edit the script and change `OPENCL_PROVIDER`: + +```bash +# In install-davinci-resolve.sh: +OPENCL_PROVIDER="opencl-amd" # AUR package (default) +OPENCL_PROVIDER="rocm-full" # Official ROCm stack +``` + +### Free Version Codec Limitation + +DaVinci Resolve Free on Linux cannot decode H.264/H.265. Convert your media first: + +```bash +resolve-convert video.mp4 +# Creates video_dnxhr.mov (DNxHR format that Resolve Free supports) +``` + +## Troubleshooting + +### GPU not detected in Resolve + +```bash +# Check OpenCL +clinfo --list + +# Check ROCm +rocminfo + +# Run diagnostics +davinci-resolve-checker +``` + +### RDNA 4 specific issues + +If Resolve doesn't detect your RX 9070/9080, try adjusting the GFX version in the launcher: + +```bash +# Edit ~/.local/bin/davinci-resolve +# Change HSA_OVERRIDE_GFX_VERSION value: +# 11.0.1 (default for gfx1201) +# 11.0.0 (fallback to gfx1100) +``` + +### Resolve crashes on launch + +- Check patchelf fix is applied: `patchelf --print-needed /opt/resolve/bin/resolve | grep glib` +- Re-run the script to reapply fixes +- Check logs: `~/.local/share/DaVinciResolve/logs/` + +### Kernel 6.14/6.15 ROCm issues + +Kernels 6.14 and 6.15 have known DKMS issues with ROCm. Consider using kernel 6.12 or 6.13. + +## Uninstalling + +```bash +# Remove Resolve (AUR package) +yay -Rns davinci-resolve + +# Remove launcher and tools +rm -f ~/.local/bin/davinci-resolve +rm -f ~/.local/bin/resolve-convert +rm -f ~/.local/bin/davinci-resolve-checker +rm -rf ~/.local/share/davinci-resolve-checker + +# Remove user data (WARNING: deletes all projects) +rm -rf ~/.local/share/DaVinciResolve +``` + +## Credits + +- [Omarchy](https://omarchy.com) - The Arch Linux distribution this was built for +- [davincibox](https://github.com/zelikos/davincibox) - Patchelf fix technique +- [Arch Wiki - DaVinci Resolve](https://wiki.archlinux.org/title/DaVinci_Resolve) - Community documentation +- [Blackmagic Design](https://www.blackmagicdesign.com/) - DaVinci Resolve +- [davinci-resolve-checker](https://github.com/Ashark/davinci-resolve-checker) - Diagnostic tool + +## License + +This project is provided as-is for the Omarchy community.