# satyamhitman/fanripper architecture

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

- Interactive diagram: https://gitdiagram.com/satyamhitman/fanripper
- Repository: https://github.com/satyamhitman/fanripper

## Overview

Fanripper is a browser extension for backing up subscription content that the user can already access. The documented workflow is to use a save button on supported-site content, process protected media locally when supported, and save downloads to the user’s Downloads folder. The README also describes profile and library crawls, metadata, PPV preview, plan-gated sites, and an optional cloud-backup and Telegram-delivery add-on. No implementation files were provided, so paths and relationships below are grounded only in README.md; internal call structure is unknown.

Main entry points: [`README.md`](https://github.com/satyamhitman/fanripper/blob/main/README.md) (Save controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Content capture"]
  node_save["Save controls<br/>[README.md]"]
  node_profile["Profile crawls<br/>[README.md]"]
  node_messages["DM media<br/>[README.md]"]
  node_vault_collections["Vault and collections<br/>[README.md]"]
  node_ppv_preview["PPV preview<br/>[README.md]"]
  node_filters["Crawl filters<br/>[README.md]"]
end

subgraph group_media["Media processing"]
  node_protected_media["Protected media<br/>[README.md]"]
  node_local_decryption["Local decryption<br/>[README.md]"]
  node_streaming["Stream to disk<br/>[README.md]"]
  node_metadata["File metadata<br/>[README.md]"]
end

subgraph group_access["Plans and access"]
  node_plans["Plans and entitlements<br/>[README.md]"]
end

subgraph group_delivery["Download and delivery"]
  node_downloads[("Downloads folder")]
  node_cloud_backup["Cloud backup"]
end

node_user(("Subscriber"))
node_platforms{{"Supported platforms"}}
node_telegram{{"Telegram delivery"}}

node_user -->|"uses"| node_save
node_platforms -->|"shows controls"| node_save
node_save -->|"saves accessible content"| node_platforms
node_user -->|"starts crawl"| node_profile
node_profile -->|"backs up profiles"| node_platforms
node_profile -->|"uses"| node_filters
node_save -->|"saves media"| node_messages
node_save -->|"saves content"| node_vault_collections
node_user -->|"previews length"| node_ppv_preview
node_platforms -->|"provides media"| node_protected_media
node_protected_media -->|"decrypts locally"| node_local_decryption
node_local_decryption -->|"streams to disk"| node_streaming
node_save -->|"embeds metadata"| node_metadata
node_save -->|"saves files"| node_downloads
node_user -->|"buys plan"| node_plans
node_plans -->|"gates site access"| node_platforms
node_cloud_backup -.->|"delivers backups"| node_telegram

click node_save "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_profile "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_messages "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_vault_collections "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_ppv_preview "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_filters "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_protected_media "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_local_decryption "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_streaming "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_metadata "https://github.com/satyamhitman/fanripper/blob/main/README.md"
click node_plans "https://github.com/satyamhitman/fanripper/blob/main/README.md"

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_save,node_profile,node_messages,node_vault_collections,node_ppv_preview,node_filters toneBlue
class node_protected_media,node_local_decryption,node_streaming,node_metadata toneAmber
class node_plans toneMint
class node_downloads,node_cloud_backup toneRose
class node_user,node_platforms,node_telegram toneIndigo
```

## Components

### Content capture

- [Save controls](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [Profile crawls](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [DM media](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [Vault and collections](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [PPV preview](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [Crawl filters](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`

### Media processing

- [Protected media](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [Local decryption](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [Stream to disk](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`
- [File metadata](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`

### Plans and access

- [Plans and entitlements](https://github.com/satyamhitman/fanripper/blob/main/README.md): `README.md`

### Download and delivery

- **Downloads folder**
- **Cloud backup**

### Other components

- **Subscriber**
- **Supported platforms**
- **Telegram delivery**

## Connections

- Subscriber → Save controls: uses (evidence: `README.md`)
- Supported platforms → Save controls: shows controls (evidence: `README.md`)
- Save controls → Supported platforms: saves accessible content (evidence: `README.md`)
- Subscriber → Profile crawls: starts crawl (evidence: `README.md`)
- Profile crawls → Supported platforms: backs up profiles (evidence: `README.md`)
- Profile crawls → Crawl filters: uses (evidence: `README.md`)
- Save controls → DM media: saves media (evidence: `README.md`)
- Save controls → Vault and collections: saves content (evidence: `README.md`)
- Subscriber → PPV preview: previews length (evidence: `README.md`)
- Supported platforms → Protected media: provides media (evidence: `README.md`)
- Protected media → Local decryption: decrypts locally (evidence: `README.md`)
- Local decryption → Stream to disk: streams to disk (evidence: `README.md`)
- Save controls → File metadata: embeds metadata (evidence: `README.md`)
- Save controls → Downloads folder: saves files (evidence: `README.md`)
- Subscriber → Plans and entitlements: buys plan (evidence: `README.md`)
- Plans and entitlements → Supported platforms: gates site access (evidence: `README.md`)
- Cloud backup → Telegram delivery: delivers backups (evidence: `README.md`)
