# edfwasd1234/furecordio architecture

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

- Interactive diagram: https://gitdiagram.com/edfwasd1234/furecordio
- Repository: https://github.com/edfwasd1234/furecordio

## Overview

Furecordio is a Windows dubbing suite: DubForge prepares clip packs, DubMaker provides a visual pack-making workflow, and DubStage records and plays those packs. Its online mode adds a relay-based room for parallel character recording, including browser-based phone participants. The graph preserves those documented product stages and the sampled core, networking, speech-to-text, and tunnel layers; some GUI-to-core links reflect README workflows because the GUI source was not sampled.

Main entry points: [`DubStage.pyw`](https://github.com/edfwasd1234/furecordio/blob/main/DubStage.pyw) (DubStage), [`DubMaker.pyw`](https://github.com/edfwasd1234/furecordio/blob/main/DubMaker.pyw) (DubMaker), [`dubforge_core.py`](https://github.com/edfwasd1234/furecordio/blob/main/dubforge_core.py) (Clip processing), [`DubForge.pyw`](https://github.com/edfwasd1234/furecordio/blob/main/DubForge.pyw) (DubForge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pack_creation["Pack creation"]
  node_dubforge_ui["DubForge<br/>[DubForge.pyw]"]
  node_dubmaker_ui["DubMaker<br/>[DubMaker.pyw]"]
  node_pack_processing["Clip processing<br/>[dubforge_core.py]"]
  node_speech_to_text["Speech to text<br/>[dubstage_stt.py]"]
  node_dub_pack["Dub pack"]
end

subgraph group_recording["DubStage recording"]
  node_dubstage_ui["DubStage<br/>[DubStage.pyw]"]
  node_pack_playback["Pack playback<br/>[dubstage_core.py]"]
  node_line_recording["Line recording<br/>[dubstage_core.py]"]
  node_scene_export["Scene export<br/>[dubstage_core.py]"]
end

subgraph group_multiplayer["Online multiplayer"]
  node_online_room["Room and lobby<br/>[dubstage_server.py]"]
  node_desktop_network["Desktop client<br/>[dubstage_net.py]"]
  node_phone_player["Phone player<br/>[app.js]"]
  node_room_takes[("Room takes<br/>[dubstage_server.py]")]
  node_quick_tunnel["Quick tunnel<br/>[dubstage_tunnel.py]"]
end

subgraph group_shared_services["Shared services"]
end

node_user(("Dubbing user"))
node_video_source(("Video source"))
node_cloudflare["Cloudflare tunnel"]
node_ffmpeg["ffmpeg"]
node_youtube["YouTube"]

node_user -->|"starts pack"| node_dubforge_ui
node_user -->|"builds pack"| node_dubmaker_ui
node_video_source -->|"provides video"| node_dubforge_ui
node_video_source -->|"provides video"| node_dubmaker_ui
node_youtube -->|"provides video"| node_dubforge_ui
node_dubforge_ui -->|"analyses clips"| node_pack_processing
node_dubmaker_ui -->|"builds pack"| node_pack_processing
node_dubmaker_ui -->|"transcribes clips"| node_speech_to_text
node_pack_processing -->|"processes media"| node_ffmpeg
node_pack_processing -->|"builds pack"| node_dub_pack
node_speech_to_text -->|"adds subtitles"| node_dub_pack
node_user -->|"records lines"| node_dubstage_ui
node_dub_pack -->|"loads pack"| node_dubstage_ui
node_dubstage_ui -->|"plays scene"| node_pack_playback
node_dubstage_ui -->|"records takes"| node_line_recording
node_dubstage_ui -->|"exports MP4"| node_scene_export
node_dubstage_ui -->|"opens room"| node_desktop_network
node_desktop_network -->|"uses relay"| node_online_room
node_phone_player -->|"joins room"| node_online_room
node_online_room -->|"stores takes"| node_room_takes
node_desktop_network -->|"downloads takes"| node_room_takes
node_dubstage_ui -->|"hosts locally"| node_quick_tunnel
node_quick_tunnel -->|"opens tunnel"| node_cloudflare
node_cloudflare -->|"forwards traffic"| node_online_room

click node_dubforge_ui "https://github.com/edfwasd1234/furecordio/blob/main/DubForge.pyw"
click node_dubmaker_ui "https://github.com/edfwasd1234/furecordio/blob/main/DubMaker.pyw"
click node_pack_processing "https://github.com/edfwasd1234/furecordio/blob/main/dubforge_core.py"
click node_speech_to_text "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_stt.py"
click node_dubstage_ui "https://github.com/edfwasd1234/furecordio/blob/main/DubStage.pyw"
click node_pack_playback "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_core.py"
click node_line_recording "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_core.py"
click node_scene_export "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_core.py"
click node_online_room "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_server.py"
click node_desktop_network "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_net.py"
click node_phone_player "https://github.com/edfwasd1234/furecordio/blob/main/web/app.js"
click node_room_takes "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_server.py"
click node_quick_tunnel "https://github.com/edfwasd1234/furecordio/blob/main/dubstage_tunnel.py"

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_dubforge_ui,node_dubmaker_ui,node_pack_processing,node_speech_to_text,node_dub_pack,node_user toneBlue
class node_dubstage_ui,node_pack_playback,node_line_recording,node_scene_export toneAmber
class node_online_room,node_desktop_network,node_phone_player,node_room_takes,node_quick_tunnel toneMint
class node_video_source,node_cloudflare,node_ffmpeg,node_youtube toneIndigo
```

## Components

### Pack creation

- [DubForge](https://github.com/edfwasd1234/furecordio/blob/main/DubForge.pyw): `DubForge.pyw`
- [DubMaker](https://github.com/edfwasd1234/furecordio/blob/main/DubMaker.pyw): `DubMaker.pyw`
- [Clip processing](https://github.com/edfwasd1234/furecordio/blob/main/dubforge_core.py): `dubforge_core.py`
- [Speech to text](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_stt.py): `dubstage_stt.py`
- **Dub pack**

### DubStage recording

- [DubStage](https://github.com/edfwasd1234/furecordio/blob/main/DubStage.pyw): `DubStage.pyw`
- [Pack playback](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_core.py): `dubstage_core.py`
- [Line recording](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_core.py): `dubstage_core.py`
- [Scene export](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_core.py): `dubstage_core.py`

### Online multiplayer

- [Room and lobby](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_server.py): `dubstage_server.py`
- [Desktop client](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_net.py): `dubstage_net.py`
- [Phone player](https://github.com/edfwasd1234/furecordio/blob/main/web/app.js): `web/app.js`
- [Room takes](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_server.py): `dubstage_server.py`
- [Quick tunnel](https://github.com/edfwasd1234/furecordio/blob/main/dubstage_tunnel.py): `dubstage_tunnel.py`

### Other components

- **Dubbing user**
- **Video source**
- **Cloudflare tunnel**
- **ffmpeg**
- **YouTube**

## Connections

- Dubbing user → DubForge: starts pack (evidence: `README.md`)
- Dubbing user → DubMaker: builds pack (evidence: `README.md`)
- Video source → DubForge: provides video (evidence: `README.md`)
- Video source → DubMaker: provides video (evidence: `README.md`)
- YouTube → DubForge: provides video (evidence: `README.md`)
- DubForge → Clip processing: analyses clips (evidence: `README.md`)
- DubMaker → Clip processing: builds pack (evidence: `README.md`)
- DubMaker → Speech to text: transcribes clips (evidence: `dubstage_stt.py`)
- Clip processing → ffmpeg: processes media (evidence: `README.md`)
- Clip processing → Dub pack: builds pack (evidence: `README.md`)
- Speech to text → Dub pack: adds subtitles (evidence: `dubstage_stt.py`)
- Dubbing user → DubStage: records lines (evidence: `README.md`)
- Dub pack → DubStage: loads pack (evidence: `README.md`)
- DubStage → Pack playback: plays scene (evidence: `README.md`)
- DubStage → Line recording: records takes (evidence: `README.md`)
- DubStage → Scene export: exports MP4 (evidence: `README.md`)
- DubStage → Desktop client: opens room (evidence: `README.md`)
- Desktop client → Room and lobby: uses relay (evidence: `README.md`)
- Phone player → Room and lobby: joins room (evidence: `web/app.js`)
- Room and lobby → Room takes: stores takes (evidence: `dubstage_server.py`)
- Desktop client → Room takes: downloads takes (evidence: `dubstage_net.py`)
- DubStage → Quick tunnel: hosts locally (evidence: `README.md`)
- Quick tunnel → Cloudflare tunnel: opens tunnel (evidence: `dubstage_tunnel.py`)
- Cloudflare tunnel → Room and lobby: forwards traffic
