# qwertyuiop8899/streamvix architecture

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

- Interactive diagram: https://gitdiagram.com/qwertyuiop8899/streamvix
- Repository: https://github.com/qwertyuiop8899/streamvix

## Overview

StreamViX is a Stremio add-on that discovers playable streams for films, series, anime, live TV, and sports. The main user workflow is a Stremio request entering the add-on, being handled by a content provider, and returning streams; host extractors resolve some provider links. Separate live-event preparation and channel utilities support the live catalog. The README documents broader provider and live capabilities than the excerpts expose, so those branches are shown without guessing their internal calls.

Main entry points: [`src/addon.ts`](https://github.com/qwertyuiop8899/streamvix/blob/main/src/addon.ts) (Addon service), [`src/providers/animeunity-provider.ts`](https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animeunity-provider.ts) (AnimeUnity), [`src/providers/anime-core`](https://github.com/qwertyuiop8899/streamvix/tree/main/src/providers/anime-core) (Anime mapping and fetch), [`src/providers/animeworld-provider.ts`](https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animeworld-provider.ts) (AnimeWorld)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_addon["Addon and Providers"]
  node_addon["Addon service<br/>[addon.ts]"]
  node_filmseries["Film and series providers<br/>[extractor.ts]"]
end

subgraph group_anime["Anime Support"]
  node_animeunity["AnimeUnity"]
  node_animesaturn["AnimeSaturn"]
  node_animeworld["AnimeWorld"]
  node_animecore["Anime mapping and fetch"]
  node_animegate["Anime identification<br/>[animeGate.ts]"]
  node_kitsu["Kitsu metadata<br/>[kitsu.ts]"]
end

subgraph group_streams["Stream Resolution"]
  node_extractor["VixSrc resolver<br/>[extractor.ts]"]
  node_hostdispatch["Host extractor dispatch<br/>[index.ts]"]
  node_hostextractors["Host link extractors<br/>[base.ts]"]
  node_mediaflow["MediaFlow wrapping<br/>[mediaflow.ts]"]
end

subgraph group_live["Live and Sports"]
  node_liveactor["Live schedule<br/>[Live.py]"]
  node_dynamicchannels["Dynamic channel catalog<br/>[dynamicChannels.ts]"]
  node_epg["EPG data<br/>[epg.ts]"]
  node_sports["Sports streams<br/>[sponSchedule.ts]"]
  node_sports99["Sports99 resolver<br/>[sports99.ts]"]
  node_vavoo["Vavoo resolver<br/>[vavoo_resolver.py]"]
end

node_stremio(("Stremio client"))
node_externalmfp{{"MediaFlow Proxy"}}

node_stremio -->|"requests catalog"| node_addon
node_addon -->|"serves streams"| node_filmseries
node_addon -->|"serves anime"| node_animeunity
node_addon -->|"serves anime"| node_animesaturn
node_addon -->|"serves anime"| node_animeworld
node_animeunity -->|"uses mapping"| node_animecore
node_animeworld -->|"uses lookup"| node_animecore
node_animesaturn -->|"uses shared core"| node_animecore
node_animeunity -->|"checks anime ID"| node_animegate
node_animeunity -->|"uses resolver"| node_extractor
node_animeworld -->|"uses resolver"| node_extractor
node_animeunity -->|"looks up metadata"| node_kitsu
node_animeworld -->|"uses provider"| node_kitsu
node_animecore -->|"fetches mapping"| node_animecore
node_extractor -.->|"dispatches links"| node_hostdispatch
node_hostdispatch -->|"selects extractor"| node_hostextractors
node_extractor -->|"wraps streams"| node_mediaflow
node_mediaflow -.->|"proxies streams"| node_externalmfp
node_liveactor -->|"refreshes catalog"| node_dynamicchannels
node_addon -->|"loads live catalog"| node_dynamicchannels
node_addon -.->|"serves TV data"| node_epg
node_addon -.->|"serves sports events"| node_sports
node_addon -.->|"serves sports streams"| node_sports99
node_addon -.->|"serves live channels"| node_vavoo

click node_addon "https://github.com/qwertyuiop8899/streamvix/blob/main/src/addon.ts"
click node_filmseries "https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractor.ts"
click node_animeunity "https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animeunity-provider.ts"
click node_animesaturn "https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animesaturn-provider.ts"
click node_animeworld "https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animeworld-provider.ts"
click node_animecore "https://github.com/qwertyuiop8899/streamvix/tree/main/src/providers/anime-core"
click node_animegate "https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/animeGate.ts"
click node_kitsu "https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/kitsu.ts"
click node_extractor "https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractor.ts"
click node_hostdispatch "https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/index.ts"
click node_hostextractors "https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/base.ts"
click node_mediaflow "https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/mediaflow.ts"
click node_liveactor "https://github.com/qwertyuiop8899/streamvix/blob/main/Live.py"
click node_dynamicchannels "https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/dynamicChannels.ts"
click node_epg "https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/epg.ts"
click node_sports "https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/sponSchedule.ts"
click node_sports99 "https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/sports99.ts"
click node_vavoo "https://github.com/qwertyuiop8899/streamvix/blob/main/vavoo_resolver.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_addon,node_filmseries,node_stremio toneBlue
class node_animeunity,node_animesaturn,node_animeworld,node_animecore,node_animegate,node_kitsu toneAmber
class node_extractor,node_hostdispatch,node_hostextractors,node_mediaflow toneMint
class node_liveactor,node_dynamicchannels,node_epg,node_sports,node_sports99,node_vavoo toneRose
class node_externalmfp toneIndigo
```

## Components

### Addon and Providers

- [Addon service](https://github.com/qwertyuiop8899/streamvix/blob/main/src/addon.ts): `src/addon.ts`
- [Film and series providers](https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractor.ts): `src/extractor.ts`

### Anime Support

- [AnimeUnity](https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animeunity-provider.ts): `src/providers/animeunity-provider.ts`
- [AnimeSaturn](https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animesaturn-provider.ts): `src/providers/animesaturn-provider.ts`
- [AnimeWorld](https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/animeworld-provider.ts): `src/providers/animeworld-provider.ts`
- [Anime mapping and fetch](https://github.com/qwertyuiop8899/streamvix/tree/main/src/providers/anime-core): `src/providers/anime-core`
- [Anime identification](https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/animeGate.ts): `src/utils/animeGate.ts`
- [Kitsu metadata](https://github.com/qwertyuiop8899/streamvix/blob/main/src/providers/kitsu.ts): `src/providers/kitsu.ts`

### Stream Resolution

- [VixSrc resolver](https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractor.ts): `src/extractor.ts`
- [Host extractor dispatch](https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/index.ts): `src/extractors/index.ts`
- [Host link extractors](https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/base.ts): `src/extractors/base.ts`
- [MediaFlow wrapping](https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/mediaflow.ts): `src/utils/mediaflow.ts`

### Live and Sports

- [Live schedule](https://github.com/qwertyuiop8899/streamvix/blob/main/Live.py): `Live.py`
- [Dynamic channel catalog](https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/dynamicChannels.ts): `src/utils/dynamicChannels.ts`
- [EPG data](https://github.com/qwertyuiop8899/streamvix/blob/main/src/utils/epg.ts): `src/utils/epg.ts`
- [Sports streams](https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/sponSchedule.ts): `src/extractors/sponSchedule.ts`
- [Sports99 resolver](https://github.com/qwertyuiop8899/streamvix/blob/main/src/extractors/sports99.ts): `src/extractors/sports99.ts`
- [Vavoo resolver](https://github.com/qwertyuiop8899/streamvix/blob/main/vavoo_resolver.py): `vavoo_resolver.py`

### Other components

- **Stremio client**
- **MediaFlow Proxy**

## Connections

- Stremio client → Addon service: requests catalog
- Addon service → Film and series providers: serves streams
- Addon service → AnimeUnity: serves anime
- Addon service → AnimeSaturn: serves anime
- Addon service → AnimeWorld: serves anime
- AnimeUnity → Anime mapping and fetch: uses mapping (evidence: `src/providers/animeunity-provider.ts`)
- AnimeWorld → Anime mapping and fetch: uses lookup (evidence: `src/providers/animeworld-provider.ts`)
- AnimeSaturn → Anime mapping and fetch: uses shared core (evidence: `src/providers/animesaturn-provider.ts`)
- AnimeUnity → Anime identification: checks anime ID (evidence: `src/providers/animeunity-provider.ts`)
- AnimeUnity → VixSrc resolver: uses resolver (evidence: `src/providers/animeunity-provider.ts`)
- AnimeWorld → VixSrc resolver: uses resolver (evidence: `src/providers/animeworld-provider.ts`)
- AnimeUnity → Kitsu metadata: looks up metadata (evidence: `src/providers/animeunity-provider.ts`)
- AnimeWorld → Kitsu metadata: uses provider (evidence: `src/providers/animeworld-provider.ts`)
- Anime mapping and fetch → Anime mapping and fetch: fetches mapping (evidence: `src/providers/anime-core/mapping-api.ts`)
- VixSrc resolver → Host extractor dispatch: dispatches links
- Host extractor dispatch → Host link extractors: selects extractor (evidence: `src/extractors/index.ts`)
- VixSrc resolver → MediaFlow wrapping: wraps streams (evidence: `src/extractor.ts`)
- MediaFlow wrapping → MediaFlow Proxy: proxies streams
- Live schedule → Dynamic channel catalog: refreshes catalog
- Addon service → Dynamic channel catalog: loads live catalog
- Addon service → EPG data: serves TV data
- Addon service → Sports streams: serves sports events
- Addon service → Sports99 resolver: serves sports streams
- Addon service → Vavoo resolver: serves live channels
