Installation

PyPI (Recommended)

pipx install rdc-cli

This installs the rdc command. You still need the renderdoc Python module — the easiest way is the one-liner build script below.

AUR (Arch Linux)

The AUR packages build the renderdoc Python module automatically, so no extra setup is needed.

# Stable: tracks tagged releases (e.g. v0.3.2)
yay -S rdc-cli

# Git: tracks latest master
yay -S rdc-cli-git

From Source

git clone https://github.com/BANANASJIM/rdc-cli.git
cd rdc-cli
pixi install && pixi run sync

RenderDoc Python Module

rdc requires the renderdoc Python module (renderdoc.cpython-*.so), which is not included in most system packages. Your Python version must match the one used to compile renderdoc.

Build Script (Recommended)

One-liner that clones, builds, and installs the renderdoc Python module (~3 min, needs cmake, ninja, python3-dev):

curl -fsSL https://raw.githubusercontent.com/BANANASJIM/rdc-cli/master/scripts/build-renderdoc.sh | bash

Building Manually

git clone --depth 1 https://github.com/baldurk/renderdoc.git
cd renderdoc
cmake -B build -DENABLE_PYRENDERDOC=ON -DENABLE_QRENDERDOC=OFF
cmake --build build -j$(nproc)
export RENDERDOC_PYTHON_PATH=$PWD/build/lib

Module Discovery

rdc-cli searches for the renderdoc module in this order:

  1. RENDERDOC_PYTHON_PATH environment variable
  2. ~/.local/renderdoc (where the build script installs)
  3. /usr/lib/renderdoc, /usr/local/lib/renderdoc
  4. Sibling directory of renderdoccmd on PATH

Verification

rdc doctor

This checks renderdoc module availability, Python version compatibility, and system configuration.

Shell Completions

# Bash
rdc completion bash > ~/.local/share/bash-completion/completions/rdc

# Zsh
rdc completion zsh > ~/.zfunc/_rdc

# Fish
rdc completion fish > ~/.config/fish/completions/rdc.fish