# piratecz/meowrent architecture

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

- Interactive diagram: https://gitdiagram.com/piratecz/meowrent
- Repository: https://github.com/piratecz/meowrent

## Overview

Meowrent is an Electron torrent client. Users add torrents from links or files, monitor and control transfers, and can create torrents; settings also cover downloads, appearance, startup, and torrent history. The main process coordinates windows, torrent operations, IPC, and persisted data, while preloads expose narrow APIs to renderer pages. The README gives no feature detail, so capabilities are inferred from the sampled renderer/preload code and main-process excerpts; some main-process handlers and UI modules were not shown.

Main entry points: [`src/main.js`](https://github.com/piratecz/meowrent/blob/main/src/main.js) (Main process), [`src/preload/preload.js`](https://github.com/piratecz/meowrent/blob/main/src/preload/preload.js) (Main preload API), [`src/renderer/formRenderer.js`](https://github.com/piratecz/meowrent/blob/main/src/renderer/formRenderer.js) (Add/create form), [`src/renderer/settingsRenderer.js`](https://github.com/piratecz/meowrent/blob/main/src/renderer/settingsRenderer.js) (Settings UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Electron app"]
  node_main["Main process<br/>[main.js]"]
  node_mainui["Torrent list UI<br/>[renderer.js]"]
  node_native["Electron dialogs and shell<br/>[main.js]"]
end

subgraph group_transfer["Torrent transfers"]
  node_formui["Add/create form<br/>[formRenderer.js]"]
  node_webtorrent["WebTorrent client<br/>[main.js]"]
end

subgraph group_preferences["Settings and history"]
  node_settingsui["Settings UI"]
  node_history[("Torrent history<br/>[main.js]")]
  node_settingsdata[("Settings persistence<br/>[main.js]")]
end

subgraph group_bridge["Renderer bridges"]
  node_mainbridge["Main preload API<br/>[preload.js]"]
  node_formbridge["Form preload API<br/>[formPreload.js]"]
  node_settingsbridge["Settings preload API<br/>[settingsPreload.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_mainui
node_user -->|"submits torrent"| node_formui
node_user -->|"configures"| node_settingsui
node_mainui -->|"invokes APIs"| node_mainbridge
node_mainbridge -->|"sends IPC"| node_main
node_main -->|"sends updates"| node_mainbridge
node_mainbridge -->|"delivers events"| node_mainui
node_formui -->|"invokes APIs"| node_formbridge
node_formbridge -.->|"requests torrent actions"| node_main
node_main -->|"adds torrents"| node_webtorrent
node_main -->|"reads and writes"| node_history
node_settingsui -->|"invokes APIs"| node_settingsbridge
node_settingsbridge -->|"sends IPC"| node_main
node_main -.->|"loads and saves"| node_settingsdata
node_formui -->|"selects files"| node_native
node_settingsui -->|"opens dialogs"| node_native
node_main -->|"opens dialogs"| node_native

click node_main "https://github.com/piratecz/meowrent/blob/main/src/main.js"
click node_mainui "https://github.com/piratecz/meowrent/blob/main/src/renderer/renderer.js"
click node_formui "https://github.com/piratecz/meowrent/blob/main/src/renderer/formRenderer.js"
click node_settingsui "https://github.com/piratecz/meowrent/blob/main/src/renderer/settingsRenderer.js"
click node_webtorrent "https://github.com/piratecz/meowrent/blob/main/src/main.js"
click node_history "https://github.com/piratecz/meowrent/blob/main/src/main.js"
click node_settingsdata "https://github.com/piratecz/meowrent/blob/main/src/main.js"
click node_mainbridge "https://github.com/piratecz/meowrent/blob/main/src/preload/preload.js"
click node_formbridge "https://github.com/piratecz/meowrent/blob/main/src/preload/formPreload.js"
click node_settingsbridge "https://github.com/piratecz/meowrent/blob/main/src/preload/settingsPreload.js"
click node_native "https://github.com/piratecz/meowrent/blob/main/src/main.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_main,node_mainui,node_native,node_user toneBlue
class node_formui,node_webtorrent toneAmber
class node_settingsui,node_history,node_settingsdata toneMint
class node_mainbridge,node_formbridge,node_settingsbridge toneRose
```

## Components

### Electron app

- [Main process](https://github.com/piratecz/meowrent/blob/main/src/main.js): `src/main.js`
- [Torrent list UI](https://github.com/piratecz/meowrent/blob/main/src/renderer/renderer.js): `src/renderer/renderer.js`
- [Electron dialogs and shell](https://github.com/piratecz/meowrent/blob/main/src/main.js): `src/main.js`

### Torrent transfers

- [Add/create form](https://github.com/piratecz/meowrent/blob/main/src/renderer/formRenderer.js): `src/renderer/formRenderer.js`
- [WebTorrent client](https://github.com/piratecz/meowrent/blob/main/src/main.js): `src/main.js`

### Settings and history

- [Settings UI](https://github.com/piratecz/meowrent/blob/main/src/renderer/settingsRenderer.js): `src/renderer/settingsRenderer.js`
- [Torrent history](https://github.com/piratecz/meowrent/blob/main/src/main.js): `src/main.js`
- [Settings persistence](https://github.com/piratecz/meowrent/blob/main/src/main.js): `src/main.js`

### Renderer bridges

- [Main preload API](https://github.com/piratecz/meowrent/blob/main/src/preload/preload.js): `src/preload/preload.js`
- [Form preload API](https://github.com/piratecz/meowrent/blob/main/src/preload/formPreload.js): `src/preload/formPreload.js`
- [Settings preload API](https://github.com/piratecz/meowrent/blob/main/src/preload/settingsPreload.js): `src/preload/settingsPreload.js`

### Other components

- **User**

## Connections

- User → Torrent list UI: uses (evidence: `src/renderer/renderer.js`)
- User → Add/create form: submits torrent (evidence: `src/renderer/formRenderer.js`)
- User → Settings UI: configures (evidence: `src/renderer/settingsRenderer.js`)
- Torrent list UI → Main preload API: invokes APIs (evidence: `src/renderer/renderer.js`)
- Main preload API → Main process: sends IPC (evidence: `src/preload/preload.js`)
- Main process → Main preload API: sends updates (evidence: `src/main.js`)
- Main preload API → Torrent list UI: delivers events (evidence: `src/renderer/renderer.js`)
- Add/create form → Form preload API: invokes APIs (evidence: `src/renderer/formRenderer.js`)
- Form preload API → Main process: requests torrent actions
- Main process → WebTorrent client: adds torrents (evidence: `src/main.js`)
- Main process → Torrent history: reads and writes (evidence: `src/main.js`)
- Settings UI → Settings preload API: invokes APIs (evidence: `src/renderer/settingsRenderer.js`)
- Settings preload API → Main process: sends IPC (evidence: `src/preload/settingsPreload.js`)
- Main process → Settings persistence: loads and saves (evidence: `src/main.js`)
- Add/create form → Electron dialogs and shell: selects files (evidence: `src/renderer/formRenderer.js`)
- Settings UI → Electron dialogs and shell: opens dialogs (evidence: `src/renderer/settingsRenderer.js`)
- Main process → Electron dialogs and shell: opens dialogs (evidence: `src/main.js`)
