# skye1349/obsidian-ai-translator architecture

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

- Interactive diagram: https://gitdiagram.com/skye1349/obsidian-ai-translator
- Repository: https://github.com/skye1349/obsidian-ai-translator

## Overview

AI Translation Assistant is an Obsidian plugin for contextual translation, bilingual note workflows, excerpts, and speech; the repository also contains substantial YouTube/local-video playback and video-chat capabilities. The principal reading workflow runs from Obsidian selection through translation orchestration and a configured AI backend, then returns translated text for display or insertion. Main excerpts establish several internal calls; README documents user-facing features whose specific implementation paths are not fully evidenced here, so uncertain feature wiring is omitted.

Main entry points: [`src/main.ts`](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/main.ts) (Plugin commands), [`src/video-chat-backend.ts`](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-backend.ts) (Video chat backend), [`src/youtube.ts`](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/youtube.ts) (YouTube player), [`src/video-chat-panel.ts`](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-panel.ts) (Video chat panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reading["Reading and translation"]
  node_plugin["Plugin commands<br/>[main.ts]"]
  node_doc_translation["Document translation"]
  node_language["Language rules<br/>[language.ts]"]
  node_prompts["Translation prompts"]
  node_memory["Shared memory<br/>[shared-memory.ts]"]
end

subgraph group_ai["AI services"]
  node_economy["Economy models<br/>[economy-model.ts]"]
  node_backend["Video chat backend"]
  node_runner["Process runner<br/>[process-runner.ts]"]
  node_claude_args["Claude arguments<br/>[claude-args.ts]"]
  node_provider(("AI provider"))
end

subgraph group_video["Video experience"]
  node_webviewer["Web Viewer<br/>[web-viewer.ts]"]
  node_youtube["YouTube player<br/>[youtube.ts]"]
  node_presentation["Playback presentation"]
  node_timing["Playback timing<br/>[youtube-timing.ts]"]
  node_local_video["Local video and captions<br/>[local-video.ts]"]
end

subgraph group_chat["Video chat"]
  node_video_chat["Video chat context<br/>[video-chat.ts]"]
  node_chat_panel["Video chat panel"]
  node_chat_notes["Chat notes"]
end

node_obsidian(("Obsidian user"))

node_obsidian -->|"invokes commands"| node_plugin
node_plugin -->|"parses translation"| node_doc_translation
node_doc_translation -->|"uses language rules"| node_language
node_plugin -->|"resolves CLI"| node_runner
node_plugin -->|"polls viewer"| node_webviewer
node_plugin -->|"manages playback"| node_youtube
node_plugin -->|"captures frames"| node_local_video
node_youtube -->|"parses playback data"| node_presentation
node_youtube -->|"hosts panel"| node_chat_panel
node_youtube -->|"uses captions"| node_local_video
node_chat_panel -->|"builds chat context"| node_video_chat
node_chat_panel -.->|"exports notes"| node_chat_notes
node_video_chat -->|"uses video data"| node_youtube
node_plugin -->|"configures backend"| node_backend
node_backend -->|"spawns process"| node_runner
node_backend -->|"builds CLI args"| node_claude_args
node_backend -->|"selects models"| node_economy
node_plugin -->|"uses prompts"| node_prompts
node_plugin -.->|"uses translation memory"| node_memory
node_plugin -->|"selects models"| node_economy
node_plugin -.->|"sends translation request"| node_provider
node_backend -.->|"requests chat answer"| node_provider

click node_plugin "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/main.ts"
click node_doc_translation "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/document-translation.ts"
click node_language "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/language.ts"
click node_prompts "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/translation-prompts.ts"
click node_memory "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/shared-memory.ts"
click node_economy "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/economy-model.ts"
click node_backend "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-backend.ts"
click node_runner "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/process-runner.ts"
click node_claude_args "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/claude-args.ts"
click node_webviewer "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/web-viewer.ts"
click node_youtube "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/youtube.ts"
click node_presentation "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/youtube-presentation.ts"
click node_timing "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/youtube-timing.ts"
click node_local_video "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/local-video.ts"
click node_video_chat "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat.ts"
click node_chat_panel "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-panel.ts"
click node_chat_notes "https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-notes.ts"

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_plugin,node_doc_translation,node_language,node_prompts,node_memory,node_obsidian toneBlue
class node_economy,node_backend,node_runner,node_claude_args,node_provider toneAmber
class node_webviewer,node_youtube,node_presentation,node_timing,node_local_video toneMint
class node_video_chat,node_chat_panel,node_chat_notes toneRose
```

## Components

### Reading and translation

- [Plugin commands](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/main.ts): `src/main.ts`
- [Document translation](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/document-translation.ts): `src/document-translation.ts`
- [Language rules](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/language.ts): `src/language.ts`
- [Translation prompts](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/translation-prompts.ts): `src/translation-prompts.ts`
- [Shared memory](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/shared-memory.ts): `src/shared-memory.ts`

### AI services

- [Economy models](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/economy-model.ts): `src/economy-model.ts`
- [Video chat backend](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-backend.ts): `src/video-chat-backend.ts`
- [Process runner](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/process-runner.ts): `src/process-runner.ts`
- [Claude arguments](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/claude-args.ts): `src/claude-args.ts`
- **AI provider**

### Video experience

- [Web Viewer](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/web-viewer.ts): `src/web-viewer.ts`
- [YouTube player](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/youtube.ts): `src/youtube.ts`
- [Playback presentation](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/youtube-presentation.ts): `src/youtube-presentation.ts`
- [Playback timing](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/youtube-timing.ts): `src/youtube-timing.ts`
- [Local video and captions](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/local-video.ts): `src/local-video.ts`

### Video chat

- [Video chat context](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat.ts): `src/video-chat.ts`
- [Video chat panel](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-panel.ts): `src/video-chat-panel.ts`
- [Chat notes](https://github.com/skye1349/obsidian-ai-translator/blob/main/src/video-chat-notes.ts): `src/video-chat-notes.ts`

### Other components

- **Obsidian user**

## Connections

- Obsidian user → Plugin commands: invokes commands (evidence: `README.md`)
- Plugin commands → Document translation: parses translation (evidence: `src/main.ts`)
- Document translation → Language rules: uses language rules (evidence: `src/document-translation.ts`)
- Plugin commands → Process runner: resolves CLI (evidence: `src/main.ts`)
- Plugin commands → Web Viewer: polls viewer (evidence: `src/main.ts`)
- Plugin commands → YouTube player: manages playback (evidence: `src/main.ts`)
- Plugin commands → Local video and captions: captures frames (evidence: `src/main.ts`)
- YouTube player → Playback presentation: parses playback data (evidence: `src/youtube.ts`)
- YouTube player → Video chat panel: hosts panel (evidence: `src/youtube.ts`)
- YouTube player → Local video and captions: uses captions (evidence: `src/youtube.ts`)
- Video chat panel → Video chat context: builds chat context (evidence: `src/video-chat-panel.ts`)
- Video chat panel → Chat notes: exports notes
- Video chat context → YouTube player: uses video data (evidence: `src/video-chat.ts`)
- Plugin commands → Video chat backend: configures backend (evidence: `src/main.ts`)
- Video chat backend → Process runner: spawns process (evidence: `src/video-chat-backend.ts`)
- Video chat backend → Claude arguments: builds CLI args (evidence: `src/video-chat-backend.ts`)
- Video chat backend → Economy models: selects models (evidence: `src/video-chat-backend.ts`)
- Plugin commands → Translation prompts: uses prompts (evidence: `src/main.ts`)
- Plugin commands → Shared memory: uses translation memory (evidence: `src/main.ts`)
- Plugin commands → Economy models: selects models (evidence: `src/main.ts`)
- Plugin commands → AI provider: sends translation request
- Video chat backend → AI provider: requests chat answer
