# 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.