DaVinci-Resolve-openSUSE-Tu.../README.md
28allday 0ab5ea2cf6 Add video guide to README
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 12:27:10 +00:00

147 lines
4.4 KiB
Markdown

# DaVinci Resolve - openSUSE Tumbleweed
## Video Guide
<p align="center">
<a href="https://youtu.be/oAEjaAcWE-8">
<img src="https://img.youtube.com/vi/oAEjaAcWE-8/0.jpg" width="700">
</a>
</p>
Install [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) on openSUSE Tumbleweed with all the compatibility fixes needed for this rolling-release distro.
Handles gdk-pixbuf ABI mismatches, GLib conflicts, OpenCL setup, libtiff shims, and XWayland wrapper creation — so Resolve just works.
## Requirements
- **OS**: openSUSE Tumbleweed
- **GPU**: NVIDIA with proprietary drivers installed
- **DaVinci Resolve**: ZIP or .run file downloaded to `~/Downloads/`
## Quick Start
1. **Download DaVinci Resolve** from [blackmagicdesign.com](https://www.blackmagicdesign.com/products/davinciresolve) — save to `~/Downloads/`
2. **Run the installer**:
```bash
git clone https://github.com/28allday/DaVinci-Resolve-openSUSE-Tumbleweed.git
cd DaVinci-Resolve-openSUSE-Tumbleweed
chmod +x install-resolve-tw.sh
sudo ./install-resolve-tw.sh
```
3. **Launch Resolve**: `resolve`
You can also pass the file path directly:
```bash
sudo ./install-resolve-tw.sh /path/to/DaVinci_Resolve_Linux.zip
```
## What It Does
### 1. Installs Dependencies
| Package | Purpose |
|---------|---------|
| `libOpenCL1` | GPU-accelerated processing (effects, colour grading) |
| `libjpeg62` | JPEG image support (older ABI that Resolve needs) |
| `libX11-xcb1` + `xcb-*` | X11/XCB protocol libraries for display |
| `libglib/gio/gmodule/gthread` | GLib stack (system versions) |
| `libapr1-0`, `libapr-util1-0` | Apache Portable Runtime (Resolve's DB engine) |
| `xwayland` | X11 compatibility layer for Wayland desktops |
### 2. Runs Blackmagic's Installer
- Tries running as the current user first
- Falls back to sudo with X11 display passthrough if needed
- Bypasses distro check (`SKIP_PACKAGE_CHECK=1`)
- Forces X11 mode (`QT_QPA_PLATFORM=xcb`)
### 3. Applies Tumbleweed-Specific Fixes
| Fix | Why |
|-----|-----|
| **Fedora gdk-pixbuf2** | Tumbleweed's version is too new for Resolve's Qt — fetches a compatible one from Fedora archives |
| **System GLib** | Replaces bundled GLib with system version (stable C ABI, safe to swap) |
| **OpenCL symlink** | Links system libOpenCL.so.1 into Resolve's lib directory |
| **libtiff5 shim** | Tumbleweed ships libtiff.so.6, Resolve wants .so.5 — symlink bridges the gap |
### 4. Creates XWayland Wrapper
Resolve doesn't support native Wayland. The wrapper at `/usr/local/bin/resolve` forces X11 mode and sets up the correct library paths and NVIDIA environment variables.
### 5. Patches Desktop Entries
Updates `.desktop` files so launching from the app menu uses the wrapper with all the correct environment settings.
## Debug Mode
For verbose output showing every command:
```bash
sudo DEBUG=1 ./install-resolve-tw.sh
```
## Troubleshooting
### Resolve crashes on launch
- Launch from terminal to see errors: `resolve`
- Check NVIDIA driver: `nvidia-smi`
- Verify gdk-pixbuf was installed: `ls /opt/resolve/libs/libgdk_pixbuf*`
### Installer GUI doesn't appear
- Make sure X11/XWayland is running: `echo $DISPLAY`
- The script automatically handles xhost for sudo — if it still fails, try:
```bash
xhost +SI:localuser:root
sudo ./install-resolve-tw.sh
```
### OpenCL errors / GPU not detected
- Check OpenCL is available: `ls /opt/resolve/libs/libOpenCL.so.1`
- Verify NVIDIA OpenCL: `zypper in nvidia-compute-utils && clinfo`
### "libtiff.so.5 not found"
The script creates a shim automatically. If it's still missing:
```bash
sudo ln -s /usr/lib64/libtiff.so.6 /opt/resolve/libs/libtiff.so.5
```
## Updating Resolve
Download the new ZIP and run the script again:
```bash
sudo ./install-resolve-tw.sh
```
## Uninstalling
```bash
# Remove application
sudo rm -rf /opt/resolve
# Remove wrapper
sudo rm -f /usr/local/bin/resolve
# Remove desktop entries
rm -f ~/.local/share/applications/davinci-resolve.desktop
rm -f ~/.local/share/applications/com.blackmagicdesign.resolve.desktop
sudo rm -f /usr/share/applications/davinci-resolve.desktop
# Remove user data (WARNING: deletes all projects)
rm -rf ~/.local/share/DaVinciResolve
rm -rf ~/.config/Blackmagic\ Design
```
## Credits
- [openSUSE](https://www.opensuse.org/) - Tumbleweed rolling-release distro
- [Blackmagic Design](https://www.blackmagicdesign.com/) - DaVinci Resolve
- Mark Himsley and the openSUSE community for the gdk-pixbuf workaround
## License
This project is provided as-is.