davinci-resolve-checker

Check whether an Arch-based Linux system is configured well enough to run DaVinci Resolve before you spend time debugging GPU, OpenCL, or renderer issues by hand.

Supports Arch Linux, CachyOS, EndeavourOS, Manjaro, and Garuda.

Features

• Detects supported GPU topologies and flags unsupported Intel-only or mixed-vendor setups
• Checks OpenGL renderer selection, installed OpenCL drivers, and discovered OpenCL platforms
• Applies AMD open-stack, AMD Pro, and NVIDIA-specific compatibility rules
• Emits either a readable terminal report or machine-readable JSON for automation

Documentation

• ARCHITECTURE.md for the CLI, probe, check, and render flow
• CONTRIBUTING.md for setup, testing, commit style, and PR expectations
• AGENTS.md for agent-specific working rules and verification commands

Installation

# Install uv first on Arch-based systems
sudo pacman -S uv

# Then install the checker from PyPI
uv tool install davinci-resolve-checker

# Or run it without installing
uvx davinci-resolve-checker

If you do not want to install uv from pacman, see the official uv installation docs.

For the most complete diagnostics, make sure these system utilities are available:

sudo pacman -S expac clinfo mesa-utils pciutils

Usage

# Run all checks
davinci-resolve-checker

# Check AMD Pro stack compatibility
davinci-resolve-checker --pro

# Machine-readable JSON output
davinci-resolve-checker --json

# Stop after the first failing result
davinci-resolve-checker --fail-fast

Flags

Flag	Description
--pro	Check for AMD proprietary stack compatibility
--fail-fast	Stop after the first failing result
--json	Machine-readable JSON output

Shell Completions

# Install completions for your current shell (bash, zsh, or fish)
davinci-resolve-checker --install-completion

This auto-detects your shell and adds the completion script to your RC file. Restart your shell or source the RC file to activate.

Exit Codes

• 0 if all checks pass
• 1 if at least one check fails

Development

git clone https://github.com/mordor-forge/davinci-resolve-checker.git
cd davinci-resolve-checker
uv sync
uv run pytest -v

Full Test Matrix

uvx --with tox-uv tox

Lint

uv run ruff check src tests
uv run ruff format --check src tests

Support

Open bugs or feature requests in GitHub Issues. For security-sensitive reports, follow the private reporting guidance in CONTRIBUTING.md.

Credits

This project is a ground-up rewrite of Ashark/davinci-resolve-checker. The check logic, GPU codename lists, and OpenCL detection heuristics are derived from the original work.

License

GPL-3.0