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:
28allday
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