Add comprehensive README with GPU support matrix and troubleshooting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
d80b376e99
commit
bf0b8b7264
1 changed files with 194 additions and 0 deletions
194
README.md
Normal file
194
README.md
Normal file
|
|
@ -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.
|
||||||
Loading…
Add table
Reference in a new issue