BANANASJIM

BANANASJIM / rdc-cli

Public

Scriptable CLI for RenderDoc captures — built for terminal workflows, CI pipelines, and AI agents

bananasjim.github.iordc-cli cli frame-analysis gpu gpu-capture graphics-debugging
18
2
100% credibility
Found Feb 26, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

rdc-cli turns RenderDoc GPU frame captures into searchable Unix text streams for easy inspection with tools like grep, awk, and jq.

How It Works

1
🎮 Capture a graphics moment

You record a snapshot of your game's or app's graphics frame to debug visuals or performance.

2
📦 Get the handy inspector

Download and set up the free tool that reads your snapshots like simple text files.

3
🔧 One-time graphics link

Run a quick setup so the tool can understand your snapshot's inner workings.

4
📂 Open your snapshot

Load the file and start exploring its contents like folders on your desktop.

5
🔍 Dive into the details

Browse drawings, colors, shaders, and textures to spot what's happening in your frame.

6
🔗 Search and compare

Find specific effects, count triangles, or diff changes between snapshots using everyday search tools.

✅ Fix issues fast

Pinpoint bugs or slowdowns in your graphics without needing complex software, saving time and frustration.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is rdc-cli?

rdc-cli is a Python CLI for dissecting RenderDoc GPU frame captures (.rdc files) in the terminal. It pipes draw calls, shaders, pipelines, textures, and pixel histories as TSV or JSON streams ripe for grep, jq, awk, sort, or diff—turning opaque captures into scriptable data. Load once via daemon, then ls /draws/142, cat shader constants, export render targets, or assert pixel values in CI.

Why is it gaining traction?

RenderDoc's GUI doesn't pipe into Unix tools; rdc-cli does, with VFS navigation (/passes/GBuffer/draws), two-capture diffs (--draws, --framebuffer), and assertions (assert-pixel, assert-clean) that fail like diff(1). Daemon avoids reloads for fast queries, JSON/TSV fits AI agents and pipelines, and split mode enables macOS clients replaying on Linux hosts.

Who should use this?

Graphics engineers automating GPU regression tests in CI, game devs diffing frames between builds, or Vulkan/DX12 scripters inspecting shaders without GUI context-switching. Suits teams feeding capture stats to AI agents or building scriptable auto-clickers for render validation.

Verdict

With 14 stars and 1.0% credibility, it's immature but packs polished docs, shell completions, and high test coverage—install via pipx, build RenderDoc once, and go. Niche win for RenderDoc power users chasing terminal-first workflows over GUI hunts.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.