# prinsss/twitter-web-exporter architecture

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

- Interactive diagram: https://gitdiagram.com/prinsss/twitter-web-exporter
- Repository: https://github.com/prinsss/twitter-web-exporter

## Overview

Twitter Web Exporter is a browser-side userscript for capturing data already loaded by the Twitter/X web app, browsing it locally, and exporting records or media. The user opens a relevant page and scrolls to load data; registered extensions intercept web-app responses, while the UI exposes captured data for selection and export. The README documents the export formats and supported data categories. Several feature modules are unsampled, so their individual storage calls and UI wiring are not asserted here.

Main entry points: [`src/core/extensions/manager.ts`](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/extensions/manager.ts) (Extension manager), [`src/core/database/manager.ts`](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/database/manager.ts) (Capture database), [`src/core/app.tsx`](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/app.tsx) (Control panel), [`src/main.tsx`](https://github.com/prinsss/twitter-web-exporter/blob/main/src/main.tsx) (Userscript bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and control"]
  node_bootstrap["Userscript bootstrap<br/>[main.tsx]"]
  node_app["Control panel<br/>[app.tsx]"]
end

subgraph group_capture["Capture extensions"]
  node_extensions["Extension manager<br/>[manager.ts]"]
  node_user_pages["User pages"]
  node_social_lists["Social lists"]
  node_timeline_search["Timelines and search"]
  node_bookmarks_likes["Bookmarks and likes"]
  node_messages_community["Messages and community"]
end

subgraph group_data["Local data"]
  node_database[("Capture database<br/>[manager.ts]")]
  node_api_parsing["Response parsing<br/>[api.ts]"]
  node_tweet_types["Tweet and user models<br/>[tweet.ts]"]
end

subgraph group_browse["Browse and settings"]
  node_table["Data table<br/>[table-view.tsx]"]
  node_settings["Settings panel<br/>[settings.tsx]"]
  node_options["Options manager<br/>[manager.ts]"]
end

subgraph group_export["Export and media"]
  node_export_data["Data export<br/>[export-data.tsx]"]
  node_exporter["Format exporter<br/>[exporter.ts]"]
  node_export_media["Media export<br/>[export-media.tsx]"]
  node_media_download["Media download and zip<br/>[download.ts]"]
end

node_user(("User"))
node_twitter["Twitter web app"]

node_user -->|"browses and scrolls"| node_twitter
node_twitter -->|"loads responses"| node_extensions
node_bootstrap -->|"registers modules"| node_extensions
node_extensions -->|"dispatches intercepts"| node_user_pages
node_extensions -->|"dispatches intercepts"| node_social_lists
node_extensions -->|"dispatches intercepts"| node_timeline_search
node_extensions -->|"dispatches intercepts"| node_bookmarks_likes
node_extensions -->|"dispatches intercepts"| node_messages_community
node_bootstrap -->|"mounts"| node_app
node_app -->|"renders enabled modules"| node_extensions
node_user -->|"opens panel"| node_app
node_user_pages -.->|"captures locally"| node_database
node_social_lists -.->|"captures locally"| node_database
node_timeline_search -.->|"captures locally"| node_database
node_bookmarks_likes -.->|"captures locally"| node_database
node_messages_community -.->|"captures locally"| node_database
node_user -->|"previews and selects"| node_table
node_user -->|"chooses format"| node_export_data
node_export_data -.->|"exports records"| node_exporter
node_user -->|"requests bulk download"| node_export_media
node_export_media -->|"downloads and archives"| node_media_download
node_settings -->|"reads and writes"| node_options
node_app -->|"renders"| node_settings
node_api_parsing -->|"uses data models"| node_tweet_types

click node_bootstrap "https://github.com/prinsss/twitter-web-exporter/blob/main/src/main.tsx"
click node_app "https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/app.tsx"
click node_extensions "https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/extensions/manager.ts"
click node_user_pages "https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/user-tweets"
click node_social_lists "https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/followers"
click node_timeline_search "https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/search-timeline"
click node_bookmarks_likes "https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/bookmarks"
click node_messages_community "https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/direct-messages"
click node_database "https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/database/manager.ts"
click node_api_parsing "https://github.com/prinsss/twitter-web-exporter/blob/main/src/utils/api.ts"
click node_tweet_types "https://github.com/prinsss/twitter-web-exporter/blob/main/src/types/tweet.ts"
click node_table "https://github.com/prinsss/twitter-web-exporter/blob/main/src/components/table/table-view.tsx"
click node_settings "https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/settings.tsx"
click node_options "https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/options/manager.ts"
click node_export_data "https://github.com/prinsss/twitter-web-exporter/blob/main/src/components/modals/export-data.tsx"
click node_exporter "https://github.com/prinsss/twitter-web-exporter/blob/main/src/utils/exporter.ts"
click node_export_media "https://github.com/prinsss/twitter-web-exporter/blob/main/src/components/modals/export-media.tsx"
click node_media_download "https://github.com/prinsss/twitter-web-exporter/blob/main/src/utils/download.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_bootstrap,node_app,node_user toneBlue
class node_extensions,node_user_pages,node_social_lists,node_timeline_search,node_bookmarks_likes,node_messages_community toneAmber
class node_database,node_api_parsing,node_tweet_types toneMint
class node_table,node_settings,node_options toneRose
class node_export_data,node_exporter,node_export_media,node_media_download,node_twitter toneIndigo
```

## Components

### Application and control

- [Userscript bootstrap](https://github.com/prinsss/twitter-web-exporter/blob/main/src/main.tsx): `src/main.tsx`
- [Control panel](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/app.tsx): `src/core/app.tsx`

### Capture extensions

- [Extension manager](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/extensions/manager.ts): `src/core/extensions/manager.ts`
- [User pages](https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/user-tweets): `src/modules/user-tweets`
- [Social lists](https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/followers): `src/modules/followers`
- [Timelines and search](https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/search-timeline): `src/modules/search-timeline`
- [Bookmarks and likes](https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/bookmarks): `src/modules/bookmarks`
- [Messages and community](https://github.com/prinsss/twitter-web-exporter/tree/main/src/modules/direct-messages): `src/modules/direct-messages`

### Local data

- [Capture database](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/database/manager.ts): `src/core/database/manager.ts`
- [Response parsing](https://github.com/prinsss/twitter-web-exporter/blob/main/src/utils/api.ts): `src/utils/api.ts`
- [Tweet and user models](https://github.com/prinsss/twitter-web-exporter/blob/main/src/types/tweet.ts): `src/types/tweet.ts`

### Browse and settings

- [Data table](https://github.com/prinsss/twitter-web-exporter/blob/main/src/components/table/table-view.tsx): `src/components/table/table-view.tsx`
- [Settings panel](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/settings.tsx): `src/core/settings.tsx`
- [Options manager](https://github.com/prinsss/twitter-web-exporter/blob/main/src/core/options/manager.ts): `src/core/options/manager.ts`

### Export and media

- [Data export](https://github.com/prinsss/twitter-web-exporter/blob/main/src/components/modals/export-data.tsx): `src/components/modals/export-data.tsx`
- [Format exporter](https://github.com/prinsss/twitter-web-exporter/blob/main/src/utils/exporter.ts): `src/utils/exporter.ts`
- [Media export](https://github.com/prinsss/twitter-web-exporter/blob/main/src/components/modals/export-media.tsx): `src/components/modals/export-media.tsx`
- [Media download and zip](https://github.com/prinsss/twitter-web-exporter/blob/main/src/utils/download.ts): `src/utils/download.ts`

### Other components

- **User**
- **Twitter web app**

## Connections

- User → Twitter web app: browses and scrolls
- Twitter web app → Extension manager: loads responses
- Userscript bootstrap → Extension manager: registers modules (evidence: `src/main.tsx`)
- Extension manager → User pages: dispatches intercepts (evidence: `src/core/extensions/manager.ts`)
- Extension manager → Social lists: dispatches intercepts (evidence: `src/core/extensions/manager.ts`)
- Extension manager → Timelines and search: dispatches intercepts (evidence: `src/core/extensions/manager.ts`)
- Extension manager → Bookmarks and likes: dispatches intercepts (evidence: `src/core/extensions/manager.ts`)
- Extension manager → Messages and community: dispatches intercepts (evidence: `src/core/extensions/manager.ts`)
- Userscript bootstrap → Control panel: mounts (evidence: `src/main.tsx`)
- Control panel → Extension manager: renders enabled modules (evidence: `src/core/app.tsx`)
- User → Control panel: opens panel
- User pages → Capture database: captures locally
- Social lists → Capture database: captures locally
- Timelines and search → Capture database: captures locally
- Bookmarks and likes → Capture database: captures locally
- Messages and community → Capture database: captures locally
- User → Data table: previews and selects
- User → Data export: chooses format
- Data export → Format exporter: exports records
- User → Media export: requests bulk download
- Media export → Media download and zip: downloads and archives (evidence: `src/components/modals/export-media.tsx`)
- Settings panel → Options manager: reads and writes (evidence: `src/core/settings.tsx`)
- Control panel → Settings panel: renders (evidence: `src/core/app.tsx`)
- Response parsing → Tweet and user models: uses data models (evidence: `src/utils/api.ts`)
