# barcodebimbo/vrcjat_ripper architecture

> Architecture diagram of the GitHub repository barcodebimbo/vrcjat_ripper, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/barcodebimbo/vrcjat_ripper
- Repository: https://github.com/barcodebimbo/vrcjat_ripper

## Overview

VRC Audio Ripper is a Node.js utility for retrieving VRCJAT session audio and exporting WAV files, with both a CLI batch downloader and a browser-driven server mode. The core workflow fetches paginated sessions and their Opus frames, decodes frames, then writes resumable WAV output organized by display name. The README documents sorting, invalid-frame handling, safe filenames, and output format. The sampled source also shows web API proxying and individual-session downloads; other page behavior is not inferred from unsampled code.

Main entry points: [`ripper.js`](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js) (Session download), [`index.html`](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/index.html) (Browser UI), [`audio`](https://github.com/barcodebimbo/vrcjat_ripper/tree/main/audio) (WAV archive)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_cli["CLI menu and modes<br/>[ripper.js]"]
end

subgraph group_download["Download pipeline"]
  node_sessionlist["Session listing<br/>[ripper.js]"]
  node_frames["Frame retrieval<br/>[ripper.js]"]
  node_sessionjob["Session download<br/>[ripper.js]"]
  node_decoder["Opus decoding<br/>[ripper.js]"]
end

subgraph group_output["Audio output"]
  node_wavwriter["WAV writing<br/>[ripper.js]"]
  node_audiofiles[("WAV archive")]
end

subgraph group_web["Web interface"]
  node_webserver["Web server<br/>[ripper.js]"]
  node_browser["Browser UI<br/>[index.html]"]
  node_proxy["API proxy<br/>[ripper.js]"]
  node_downloadroute["Web download route<br/>[ripper.js]"]
end

node_user(("User"))
node_vrcjat["VRCJAT STT API"]
node_opuslib["Opus decoder"]
node_wavlib["WAV library"]

node_user -->|"selects mode"| node_cli
node_cli -->|"runs batch"| node_sessionlist
node_cli -->|"starts server"| node_webserver
node_browser -.->|"requests UI"| node_webserver
node_sessionlist -->|"fetches sessions"| node_vrcjat
node_sessionlist -->|"dispatches sessions"| node_sessionjob
node_sessionjob -->|"gets frames"| node_frames
node_frames -->|"fetches frames"| node_vrcjat
node_sessionjob -->|"decodes frames"| node_decoder
node_decoder -->|"uses decoder"| node_opuslib
node_sessionjob -->|"writes audio"| node_wavwriter
node_wavwriter -->|"encodes WAV"| node_wavlib
node_wavwriter -->|"saves files"| node_audiofiles
node_webserver -->|"routes API"| node_proxy
node_proxy -->|"forwards requests"| node_vrcjat
node_webserver -->|"handles POST"| node_downloadroute
node_downloadroute -->|"fetches session"| node_vrcjat
node_downloadroute -->|"starts download"| node_sessionjob

click node_cli "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_webserver "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_browser "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/index.html"
click node_sessionlist "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_frames "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_sessionjob "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_decoder "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_wavwriter "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_audiofiles "https://github.com/barcodebimbo/vrcjat_ripper/tree/main/audio"
click node_proxy "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"
click node_downloadroute "https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_user toneBlue
class node_sessionlist,node_frames,node_sessionjob,node_decoder toneAmber
class node_wavwriter,node_audiofiles,node_vrcjat toneMint
class node_webserver,node_browser,node_proxy,node_downloadroute toneRose
class node_opuslib,node_wavlib toneIndigo
```

## Components

### Entry points

- [CLI menu and modes](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`

### Download pipeline

- [Session listing](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`
- [Frame retrieval](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`
- [Session download](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`
- [Opus decoding](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`

### Audio output

- [WAV writing](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`
- [WAV archive](https://github.com/barcodebimbo/vrcjat_ripper/tree/main/audio): `audio`

### Web interface

- [Web server](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`
- [Browser UI](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/index.html): `index.html`
- [API proxy](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`
- [Web download route](https://github.com/barcodebimbo/vrcjat_ripper/blob/main/ripper.js): `ripper.js`

### Other components

- **User**
- **VRCJAT STT API**
- **Opus decoder**
- **WAV library**

## Connections

- User → CLI menu and modes: selects mode (evidence: `ripper.js`)
- CLI menu and modes → Session listing: runs batch (evidence: `ripper.js`)
- CLI menu and modes → Web server: starts server (evidence: `ripper.js`)
- Browser UI → Web server: requests UI
- Session listing → VRCJAT STT API: fetches sessions (evidence: `README.md`)
- Session listing → Session download: dispatches sessions (evidence: `ripper.js`)
- Session download → Frame retrieval: gets frames (evidence: `ripper.js`)
- Frame retrieval → VRCJAT STT API: fetches frames (evidence: `ripper.js`)
- Session download → Opus decoding: decodes frames (evidence: `ripper.js`)
- Opus decoding → Opus decoder: uses decoder (evidence: `ripper.js`)
- Session download → WAV writing: writes audio (evidence: `ripper.js`)
- WAV writing → WAV library: encodes WAV (evidence: `ripper.js`)
- WAV writing → WAV archive: saves files (evidence: `README.md`)
- Web server → API proxy: routes API (evidence: `ripper.js`)
- API proxy → VRCJAT STT API: forwards requests (evidence: `ripper.js`)
- Web server → Web download route: handles POST (evidence: `ripper.js`)
- Web download route → VRCJAT STT API: fetches session (evidence: `ripper.js`)
- Web download route → Session download: starts download (evidence: `ripper.js`)
