rdc-cli 0.4.3__tar.gz → 0.5.0__tar.gz

rdc_cli-0.5.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,65 @@
+name: Bug Report
+description: Something isn't working as expected
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting! Please fill in as much detail as you can.
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Describe the bug. What did you do, what did you expect, and what happened instead?
+      placeholder: |
+        Steps to reproduce:
+        1. Run `rdc open capture.rdc`
+        2. Run `rdc draws`
+        3. ...
+
+        Expected: ...
+        Actual: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: doctor-output
+    attributes:
+      label: "`rdc doctor` output"
+      description: Paste the output of `rdc doctor` (helps us understand your environment).
+      render: text
+    validations:
+      required: false
+
+  - type: input
+    id: os
+    attributes:
+      label: OS / Platform
+      placeholder: "e.g. Ubuntu 24.04, Windows 11, macOS 15, Android 12 (EMUI)"
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "e.g. 3.12.3"
+    validations:
+      required: false
+
+  - type: input
+    id: rdc-version
+    attributes:
+      label: rdc-cli version
+      placeholder: "e.g. 0.4.4 (from `rdc --version`)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: capture
+    attributes:
+      label: Capture file
+      description: If possible, attach a minimal `.rdc` file that reproduces the issue, or describe the GPU API / hardware involved.
+    validations:
+      required: false

rdc_cli-0.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://bananasjim.github.io/rdc-cli/
+    about: Check the docs before opening an issue

rdc_cli-0.5.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,37 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Describe the use case first — what problem are you solving?
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / Use case
+      description: What are you trying to do that isn't possible or is too difficult today?
+      placeholder: "I'm trying to ... but currently I have to ..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: If you have ideas on the CLI interface, include example invocations.
+      placeholder: |
+        ```bash
+        rdc frobnicate --flag value
+        ```
+    validations:
+      required: false
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you tried any workarounds? Other tools that solve this?
+    validations:
+      required: false

rdc_cli-0.5.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## What
+
+<!-- One-sentence summary of what this PR does. -->
+
+## Why
+
+<!-- The problem or motivation. Link to the issue if there is one (Fixes #123). -->
+
+## How
+
+<!-- Brief description of the approach. Call out any non-obvious decisions. -->
+
+## Test plan
+
+- [ ] `pixi run check` passes (lint + typecheck + tests)
+- [ ] Added/updated unit tests
+- [ ] Manual testing with a real `.rdc` capture (if applicable)

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/.github/workflows/aur.yml

@@ -76,4 +76,5 @@ jobs:
           commit_email: ${{ secrets.AUR_EMAIL }}
           ssh_private_key: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
           commit_message: "Update rdc-cli to v${{ steps.ver.outputs.version }}"
+          force_push: true
           post_process: git checkout -B master

rdc_cli-0.5.0/CONTRIBUTING.md

@@ -0,0 +1,92 @@
+# Contributing to rdc-cli
+
+Thanks for your interest in rdc-cli! Whether it's a bug report, feature idea, or code contribution — all are welcome.
+
+## Reporting issues
+
+Found a bug or have a feature request? Please [open an issue](https://github.com/BANANASJIM/rdc-cli/issues).
+
+A good issue includes:
+
+- **Bug reports**: what you did, what you expected, what happened instead. Include `rdc doctor` output and your OS/Python version. A minimal `.rdc` capture to reproduce is ideal but not required.
+- **Feature requests**: describe the use case (what problem are you solving?), not just the solution. If you have thoughts on the CLI interface, include an example invocation.
+- **Questions**: if you're unsure whether something is a bug or a usage question, open an issue anyway — we'll sort it out.
+
+## Pull requests
+
+### Before you start
+
+- For non-trivial changes, **open an issue first** to discuss the approach. This avoids wasted effort if the design needs adjustment.
+- Small fixes (typos, one-liner bug fixes) can go straight to a PR.
+
+### PR description format
+
+A good PR description helps reviewers understand your change quickly:
+
+```
+## What
+
+One-sentence summary of what this PR does.
+
+## Why
+
+The problem or motivation. Link to the issue if there is one (Fixes #123).
+
+## How
+
+Brief description of the approach. Call out any non-obvious decisions
+or trade-offs.
+
+## Test plan
+
+How you verified the change works:
+- [ ] Added/updated unit tests
+- [ ] Ran `pixi run check` (lint + typecheck + tests)
+- [ ] Manual testing with a real .rdc capture (if applicable)
+```
+
+### Commit messages
+
+We use [Conventional Commits](https://www.conventionalcommits.org/), enforced by commitlint in CI:
+
+```
+feat(cli): add frobnicate command
+fix(daemon): handle missing texture gracefully
+docs(readme): update install instructions
+```
+
+Common scopes: `cli`, `daemon`, `vfs`, `ci`, `build`, `docs`.
+
+### Workflow
+
+1. Fork and clone the repo
+2. Set up the dev environment:
+   ```bash
+   pixi install && pixi run sync
+   ```
+3. Create a feature branch: `git switch -c feat/my-feature`
+4. Make your changes, ensure `pixi run check` passes
+5. Push and open a PR against `master`
+
+PRs are squash-merged after review.
+
+### Code style
+
+Enforced by CI — just follow the tooling:
+
+- **Linter/formatter**: ruff (`ruff check --fix` / `ruff format` to auto-fix)
+- **Type checker**: mypy strict mode
+- **Line length**: 100 chars
+- **Output**: `click.echo()` or `logging`, never `print()`
+- **Paths**: `pathlib.Path`, not `os.path`
+
+### CI checks on PRs
+
+- Lint (ruff) + type check (mypy)
+- Unit tests — Python 3.10 / 3.12 / 3.14 on Linux + Windows
+- Commitlint — conventional commit format
+- Dependency audit (pip-audit)
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdc-cli
-Version: 0.4.3
+Version: 0.5.0
 Summary: CLI for RenderDoc .rdc captures
 Author: Jim
 License-Expression: MIT
@@ -40,6 +40,7 @@ Dynamic: license-file
 [![Commands](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/commands.json)](https://bananasjim.github.io/rdc-cli/)
 [![Tests](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/tests.json)](https://bananasjim.github.io/rdc-cli/)
 [![Coverage](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/coverage.json)](https://bananasjim.github.io/rdc-cli/)
+[![Discord](https://img.shields.io/discord/1485003415687008296?logo=discord&label=Discord)](https://discord.gg/h3zwUadp4k)
 
 **Turn RenderDoc captures into Unix text streams.** rdc-cli does not replace RenderDoc — it makes `.rdc` file contents accessible to `grep`, `awk`, `sort`, `diff`, `jq`, and AI agents.
 
@@ -99,11 +100,12 @@ pixi run setup-renderdoc              # build renderdoc (pixi installs toolchain
 
 ### Platform Support Matrix
 
-| Platform | Local capture/replay | Split client |
-|----------|----------------------|--------------|
-| Linux | ✅ | ✅ |
-| macOS | ❌ (not supported yet) | ✅ (recommended) |
-| Windows | ✅ | ✅ |
+| Platform | Local capture/replay | Split client | Remote capture |
+|----------|----------------------|--------------|----------------|
+| Linux | ✅ | ✅ | ✅ |
+| macOS | ❌ (not supported yet) | ✅ (recommended) | — |
+| Windows | ✅ | ✅ | ✅ |
+| Android | — | — | ✅ capture + remote replay |
 
 ### RenderDoc bootstrap
 
@@ -189,6 +191,28 @@ rdc close
 
 Split mode is recommended for cross-platform use. All commands work transparently regardless of mode.
 
+**Android capture and remote replay**
+
+```bash
+rdc setup-renderdoc --android            # download RenderDoc APKs for Android
+rdc android setup                        # start remote server on connected device
+rdc android capture com.app/.MainActivity -o frame.rdc   # capture via GPU debug layers
+
+# Remote replay on the device GPU
+rdc open frame.rdc --android             # auto-resolves device from saved state
+rdc draws                                # all commands work transparently
+rdc pick-pixel 540 1170 --json           # pixel queries work in remote mode
+rdc close
+
+rdc android stop                         # stop remote server
+```
+
+Android capture uses GPU debug layers (Android 10+). Remote replay uploads the capture back to the device for replay on the original GPU. Tested on Adreno and Mali (EMUI) devices. For Mali GPUs, ARM Performance Studio is recommended:
+
+```bash
+rdc setup-renderdoc --android --arm-studio /path/to/arm-performance-studio
+```
+
 ## Why rdc-cli?
 
 RenderDoc is excellent at capturing GPU frames and replaying them interactively. But its GUI doesn't compose — you can't pipe a draw call list into `sort`, diff two captures in CI, or let an AI agent inspect shader state.
@@ -213,16 +237,17 @@ Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See
 | GPU state | `pipeline`, `bindings`, `shader`, `shaders`, `shader-map` |
 | Debug | `debug pixel`, `debug vertex`, `debug thread`, `pixel`, `pick-pixel`, `tex-stats` |
 | Shader edit | `shader-build`, `shader-replace`, `shader-restore`, `shader-restore-all`, `shader-encodings` |
-| Resources | `resources`, `resource`, `passes`, `pass`, `usage` |
+| Resources | `resources`, `resource`, `passes`, `pass`, `usage`, `unused-targets` |
 | Export | `texture`, `rt`, `buffer`, `mesh`, `snapshot` |
 | Search | `search`, `counters` |
 | Assertions | `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` |
 | Diff | `diff` (with `--draws`, `--stats`, `--framebuffer`, `--pipeline`, etc.) |
 | VFS | `ls`, `cat`, `tree` |
 | Remote | `remote connect`, `remote list`, `remote capture` |
+| Android | `android setup`, `android stop`, `android capture` |
 | Target control | `attach`, `capture-trigger`, `capture-list`, `capture-copy` |
 | Capture file | `sections`, `section`, `callstacks`, `gpus`, `thumbnail` |
-| Utility | `doctor`, `completion`, `capture`, `count`, `script`, `serve`, `install-skill` |
+| Utility | `doctor`, `completion`, `capture`, `count`, `script`, `serve`, `setup-renderdoc`, `install-skill` |
 
 All list commands output TSV. All commands support `--json`. Footer/summary goes to stderr — stdout is always clean data.
 
@@ -269,6 +294,10 @@ pixi run e2e                  # cross-platform smoke test (26 checks)
 pixi run test-e2e             # full e2e suite (self-capture + dynamic discovery)
 ```
 
+## Contributing
+
+Bug reports, feature requests, and pull requests are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
 ## License
 
 [MIT](LICENSE)

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/README.md

@@ -13,6 +13,7 @@
 [![Commands](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/commands.json)](https://bananasjim.github.io/rdc-cli/)
 [![Tests](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/tests.json)](https://bananasjim.github.io/rdc-cli/)
 [![Coverage](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/coverage.json)](https://bananasjim.github.io/rdc-cli/)
+[![Discord](https://img.shields.io/discord/1485003415687008296?logo=discord&label=Discord)](https://discord.gg/h3zwUadp4k)
 
 **Turn RenderDoc captures into Unix text streams.** rdc-cli does not replace RenderDoc — it makes `.rdc` file contents accessible to `grep`, `awk`, `sort`, `diff`, `jq`, and AI agents.
 
@@ -72,11 +73,12 @@ pixi run setup-renderdoc              # build renderdoc (pixi installs toolchain
 
 ### Platform Support Matrix
 
-| Platform | Local capture/replay | Split client |
-|----------|----------------------|--------------|
-| Linux | ✅ | ✅ |
-| macOS | ❌ (not supported yet) | ✅ (recommended) |
-| Windows | ✅ | ✅ |
+| Platform | Local capture/replay | Split client | Remote capture |
+|----------|----------------------|--------------|----------------|
+| Linux | ✅ | ✅ | ✅ |
+| macOS | ❌ (not supported yet) | ✅ (recommended) | — |
+| Windows | ✅ | ✅ | ✅ |
+| Android | — | — | ✅ capture + remote replay |
 
 ### RenderDoc bootstrap
 
@@ -162,6 +164,28 @@ rdc close
 
 Split mode is recommended for cross-platform use. All commands work transparently regardless of mode.
 
+**Android capture and remote replay**
+
+```bash
+rdc setup-renderdoc --android            # download RenderDoc APKs for Android
+rdc android setup                        # start remote server on connected device
+rdc android capture com.app/.MainActivity -o frame.rdc   # capture via GPU debug layers
+
+# Remote replay on the device GPU
+rdc open frame.rdc --android             # auto-resolves device from saved state
+rdc draws                                # all commands work transparently
+rdc pick-pixel 540 1170 --json           # pixel queries work in remote mode
+rdc close
+
+rdc android stop                         # stop remote server
+```
+
+Android capture uses GPU debug layers (Android 10+). Remote replay uploads the capture back to the device for replay on the original GPU. Tested on Adreno and Mali (EMUI) devices. For Mali GPUs, ARM Performance Studio is recommended:
+
+```bash
+rdc setup-renderdoc --android --arm-studio /path/to/arm-performance-studio
+```
+
 ## Why rdc-cli?
 
 RenderDoc is excellent at capturing GPU frames and replaying them interactively. But its GUI doesn't compose — you can't pipe a draw call list into `sort`, diff two captures in CI, or let an AI agent inspect shader state.
@@ -186,16 +210,17 @@ Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See
 | GPU state | `pipeline`, `bindings`, `shader`, `shaders`, `shader-map` |
 | Debug | `debug pixel`, `debug vertex`, `debug thread`, `pixel`, `pick-pixel`, `tex-stats` |
 | Shader edit | `shader-build`, `shader-replace`, `shader-restore`, `shader-restore-all`, `shader-encodings` |
-| Resources | `resources`, `resource`, `passes`, `pass`, `usage` |
+| Resources | `resources`, `resource`, `passes`, `pass`, `usage`, `unused-targets` |
 | Export | `texture`, `rt`, `buffer`, `mesh`, `snapshot` |
 | Search | `search`, `counters` |
 | Assertions | `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` |
 | Diff | `diff` (with `--draws`, `--stats`, `--framebuffer`, `--pipeline`, etc.) |
 | VFS | `ls`, `cat`, `tree` |
 | Remote | `remote connect`, `remote list`, `remote capture` |
+| Android | `android setup`, `android stop`, `android capture` |
 | Target control | `attach`, `capture-trigger`, `capture-list`, `capture-copy` |
 | Capture file | `sections`, `section`, `callstacks`, `gpus`, `thumbnail` |
-| Utility | `doctor`, `completion`, `capture`, `count`, `script`, `serve`, `install-skill` |
+| Utility | `doctor`, `completion`, `capture`, `count`, `script`, `serve`, `setup-renderdoc`, `install-skill` |
 
 All list commands output TSV. All commands support `--json`. Footer/summary goes to stderr — stdout is always clean data.
 
@@ -242,6 +267,10 @@ pixi run e2e                  # cross-platform smoke test (26 checks)
 pixi run test-e2e             # full e2e suite (self-capture + dynamic discovery)
 ```
 
+## Contributing
+
+Bug reports, feature requests, and pull requests are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
 ## License
 
 [MIT](LICENSE)

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/docs-astro/src/data/commands.json

@@ -9,7 +9,7 @@
           "name": "open",
           "id": "open",
           "help": "Create local default session and start daemon skeleton.",
-          "usage": "rdc open [CAPTURE] [--preload] [--proxy HOST[:PORT]] [--remote HOST[:PORT]] [--listen [ADDR]:PORT] [--connect HOST:PORT] [--token TEXT]"
+          "usage": "rdc open [CAPTURE] [--preload] [--proxy HOST[:PORT]|adb://SERIAL] [--android] [--serial TEXT] [--remote HOST[:PORT]] [--listen [ADDR]:PORT] [--connect HOST:PORT] [--token TEXT]"
         },
         {
           "name": "close",
@@ -168,13 +168,19 @@
           "name": "passes",
           "id": "passes",
           "help": "List render passes.",
-          "usage": "rdc passes [--json] [--deps] [--dot] [--graph] [--no-header] [--jsonl] [-q]"
+          "usage": "rdc passes [--json] [--deps] [--dot] [--graph] [--table] [--switches] [--no-header] [--jsonl] [-q]"
         },
         {
           "name": "pass",
           "id": "pass",
           "help": "Show detail for a single render pass by 0-based index or name.",
           "usage": "rdc pass <IDENTIFIER> [--json]"
+        },
+        {
+          "name": "unused-targets",
+          "id": "unused-targets",
+          "help": "Detect render targets produced but never consumed by visible output.",
+          "usage": "rdc unused-targets [--json] [-q] [--no-header]"
         }
       ]
     },
@@ -466,6 +472,24 @@
           "id": "remote-capture",
           "help": "Capture on a remote host and transfer to local.",
           "usage": "rdc remote capture <APP> -o <PATH> [--url TEXT] [--args TEXT] [--workdir TEXT] [--frame INTEGER] [--timeout FLOAT] [--api-validation] [--callstacks] [--hook-children] [--ref-all-resources] [--soft-memory-limit INTEGER] [--keep-remote] [--json]"
+        },
+        {
+          "name": "android setup",
+          "id": "android-setup",
+          "help": "Start RenderDoc remote server on an Android device.",
+          "usage": "rdc android setup [--serial TEXT] [--json]"
+        },
+        {
+          "name": "android stop",
+          "id": "android-stop",
+          "help": "Stop RenderDoc remote server on an Android device.",
+          "usage": "rdc android stop [--serial TEXT] [--json]"
+        },
+        {
+          "name": "android capture",
+          "id": "android-capture",
+          "help": "Capture a frame from an Android app using GPU debug layers.",
+          "usage": "rdc android capture <ACTIVITY> [--serial TEXT] [-o PATH] [--timeout FLOAT] [--port INTEGER] [--json]"
         }
       ]
     },
@@ -502,7 +526,7 @@
           "name": "setup-renderdoc",
           "id": "setup-renderdoc",
           "help": "Build and install the renderdoc Python module from source.",
-          "usage": "rdc setup-renderdoc [INSTALL-DIR] [--build-dir TEXT] [--version TEXT] [--jobs INTEGER]"
+          "usage": "rdc setup-renderdoc [INSTALL-DIR] [--build-dir TEXT] [--version TEXT] [--jobs INTEGER] [--android] [--arm] [--arm-studio DIRECTORY]"
         }
       ]
     }

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/docs-astro/src/pages/docs/examples.astro

@@ -260,17 +260,51 @@ rdc --session after close</code></pre>
 
   <h2 id="render-pass">Render Pass Analysis</h2>
 
-  <pre><code>{"# List all render passes"}
+  <pre><code>{"# List all render passes (NAME, DRAWS, DISPATCHES, TRIANGLES, BEGIN_EID, END_EID)"}
 rdc passes
 
-{"# Inspect a specific pass"}
+{"# Inspect attachments, load/store ops, and dimensions for a pass"}
 rdc pass GBuffer
 
 {"# List draws in a pass"}
 rdc draws --pass GBuffer
 
 {"# Find passes with many draws"}
-rdc passes --json | jq '.[] | select(.draw_count > 50)'</code></pre>
+rdc passes --json | jq '.[] | select(.draw_count > 50)'
+
+{"# Largest triangle passes"}
+rdc passes --json | jq 'sort_by(.triangles) | reverse | .[0:5] | .[] | {name, triangles}'
+
+{"# Passes that clear then discard (load=Clear, store=Discard — wasted work)"}
+rdc passes --json | jq '.[] | select(.load_ops[]? == "Clear" and .store_ops[]? == "Discard")'</code></pre>
+
+  <h2 id="pass-deps">Pass Dependency Analysis</h2>
+
+  <pre><code>{"# Per-pass reads/writes/load/store table"}
+rdc passes --deps --table
+
+{"# TBR/mobile: identify passes that switch render targets frequently"}
+rdc passes --switches
+
+{"# Passes with RT_SWITCHES > 2 (high bandwidth pressure on tile-based GPUs)"}
+rdc passes --switches --json | jq '.[] | select(.rt_switches > 2) | {name, rt_switches}'
+
+{"# Full dependency graph as DOT (render with Graphviz)"}
+rdc passes --deps --dot | dot -Tsvg -o passes.svg</code></pre>
+
+  <h2 id="unused-targets">Dead Render Target Detection</h2>
+
+  <pre><code>{"# Find render targets that are written but never read"}
+rdc unused-targets
+
+{"# Names only — quick scan"}
+rdc unused-targets -q
+
+{"# JSON — get name + writer + wave for each dead target"}
+rdc unused-targets --json | jq '.unused[] | {name, written_by, wave}'
+
+{"# Count dead targets (useful as a CI assert)"}
+rdc unused-targets -q | wc -l</code></pre>
 
   <h2 id="pixel-ladder">Pixel Investigation Ladder</h2>
 

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/docs-astro/src/pages/docs/remote.astro

@@ -258,6 +258,54 @@ rdc pipeline   # pipeline state via remote controller</code></pre>
 
   <hr />
 
+  <h2>Android Remote Replay</h2>
+
+  <p>
+    Android captures can only be replayed on the original device GPU (desktop GPUs
+    are incompatible with mobile GLES/Vulkan captures). The <code>--android</code>
+    flag on <code>rdc open</code> automates this: it resolves the device's
+    adb-forwarded port from saved state and opens a proxy replay session.
+  </p>
+
+  <h3>Workflow</h3>
+  <pre><code># 1. Setup: start RenderDoc remote server on the device
+rdc android setup
+
+# 2. Capture a frame
+rdc android capture com.example.app/.MainActivity -o frame.rdc
+
+# 3. Remote replay on the device GPU
+rdc open frame.rdc --android              # auto-resolves device
+rdc open frame.rdc --android --serial XYZ # explicit device selection
+
+# 4. All commands work transparently
+rdc info          # shows "API: OpenGL, machine_ident: Android ARM 64-bit"
+rdc draws         # draw call list
+rdc pick-pixel 540 1170 --json   # pixel queries
+rdc snapshot 11 -o ./snap/      # pipeline + shader export
+rdc close
+
+# 5. Cleanup
+rdc android stop</code></pre>
+
+  <h3>How it works</h3>
+  <p>
+    <code>--android</code> reads the <code>RemoteServerState</code> saved by
+    <code>rdc android setup</code>, finds the adb-forwarded TCP port via
+    <code>adb forward --list</code>, and passes <code>localhost:PORT</code>
+    as the proxy URL. The daemon then uploads the capture to the device via
+    <code>CopyCaptureToRemote</code> and opens it for replay on the device GPU.
+  </p>
+
+  <h3>Prerequisites</h3>
+  <ul>
+    <li><code>rdc android setup</code> must be run first (starts the remote server)</li>
+    <li>Device must be connected via USB with <code>adb</code> access</li>
+    <li>Android 10+ for GPU debug layer capture</li>
+  </ul>
+
+  <hr />
+
   <h2>Remote Capture Commands</h2>
 
   <p>
@@ -404,7 +452,10 @@ rdc pipeline</code></pre>
 rdc open capture.rdc
 
 # Proxy mode
-rdc open capture.rdc --proxy HOST[:PORT]
+rdc open capture.rdc --proxy HOST[:PORT]|adb://SERIAL
+
+# Android remote replay
+rdc open capture.rdc --android [--serial SERIAL]
 
 # Split server
 rdc open capture.rdc --listen [ADDR]:PORT    # :0 for auto-port
@@ -420,7 +471,8 @@ rdc remote capture APP [-o OUTPUT]</code></pre>
 
   <h2>Notes</h2>
   <ul>
-    <li><code>--connect</code> is mutually exclusive with <code>CAPTURE</code>, <code>--proxy</code>, and <code>--listen</code>.</li>
+    <li><code>--connect</code> is mutually exclusive with <code>CAPTURE</code>, <code>--proxy</code>, <code>--android</code>, and <code>--listen</code>.</li>
+    <li><code>--android</code> is mutually exclusive with <code>--proxy</code>, <code>--connect</code>, and <code>--listen</code>.</li>
     <li><code>--listen</code> can be combined with <code>--proxy</code> for Split+Proxy setups.</li>
     <li>For <code>rdc open</code>, <code>--remote</code> is a deprecated alias for <code>--proxy</code> (hidden, shows deprecation warning).</li>
     <li>The daemon has a 30-minute idle timeout by default. Any command resets the timer.</li>

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/docs-astro/src/pages/docs/usage.astro

@@ -95,4 +95,31 @@ rdc usage 5
 
 # Show all resource usage
 rdc usage --all</code></pre>
+
+  <h2>Pass Analysis</h2>
+  <p>
+    <code>rdc passes</code> shows 6 columns: NAME, DRAWS, DISPATCHES, TRIANGLES, BEGIN_EID, END_EID.
+    GL/GLES/D3D11 captures get synthetic pass inference automatically.
+  </p>
+  <pre><code># Tabular pass summary
+rdc passes
+
+# Per-pass dependency graph (reads/writes/load/store)
+rdc passes --deps --table
+
+# Add RT_SWITCHES column for TBR/mobile bandwidth analysis
+rdc passes --switches
+
+# Inspect attachments, load/store ops, and dimensions for a pass
+rdc pass GBuffer
+
+# JSON output — includes load_ops/store_ops per pass
+rdc passes --json | jq '.[] | {name: .name, load: .load_ops, store: .store_ops}'</code></pre>
+
+  <h2>Dead Render Target Detection</h2>
+  <pre><code># List render targets written but never sampled/read
+rdc unused-targets
+
+# JSON output for scripted analysis
+rdc unused-targets --json | jq '.[].name'</code></pre>
 </Docs>

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/pixi.toml

@@ -48,8 +48,12 @@ libvulkan-loader = ">=1.3"
 libvulkan-headers = ">=1.3"
 libvulkan-loader = ">=1.3"
 
+[feature.android.activation.env]
+PATH = ".local/android-platform-tools/platform-tools:${PATH}"
+
 [environments]
 vulkan = { features = ["vulkan"], solve-group = "default" }
+android = { features = ["android"], solve-group = "default" }
 
 [activation.env]
 RENDERDOC_PYTHON_PATH = ".local/renderdoc"
@@ -76,6 +80,7 @@ e2e = "python scripts/e2e_test.py"
 test-e2e = "uv run pytest tests/e2e -v -m gpu --no-header"
 test-e2e-full = "uv run pytest tests/e2e -v -m 'gpu or vulkan_samples' --no-header"
 setup-vulkan-samples = "python scripts/setup_vulkan_samples.py"
+setup-android = "python scripts/setup_android_tools.py"
 docs-install = "npm --prefix docs-astro ci"
 docs-build = "npm --prefix docs-astro run build"
 docs-test = "npm --prefix docs-astro test"

{rdc_cli-0.4.3 → rdc_cli-0.5.0}/pyproject.toml

@@ -35,7 +35,7 @@ dev = [
 ]
 
 [project.scripts]
-rdc = "rdc.cli:main"
+rdc = "rdc.cli:entry"
 
 [tool.setuptools]
 package-dir = {"" = "src"}