# jellyfin/jellyfin-web architecture

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

- Interactive diagram: https://gitdiagram.com/jellyfin/jellyfin-web
- Repository: https://github.com/jellyfin/jellyfin-web

## Overview

Jellyfin Web is a browser frontend for Jellyfin clients. The main user journey is entering the app, connecting to a server, navigating a client layout, and using media and playback features; administrators also have a dashboard for server configuration and operations. The tree documents substantial browsing, Live TV, search, settings, and SyncPlay areas. Edges are limited to relationships visible in excerpts, the SOURCE INDEX, or the README; several feature branches are shown without guessed wiring.

Main entry points: [`src/plugins/syncPlay/core/Manager.js`](https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/Manager.js) (SyncPlay Manager), [`src/index.jsx`](https://github.com/jellyfin/jellyfin-web/blob/master/src/index.jsx) (App Bootstrap), [`src/components/playback/playbackmanager.js`](https://github.com/jellyfin/jellyfin-web/blob/master/src/components/playback/playbackmanager.js) (Playback Manager), [`src/RootApp.tsx`](https://github.com/jellyfin/jellyfin-web/blob/master/src/RootApp.tsx) (Root App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_entry["App Bootstrap<br/>[index.jsx]"]
  node_root["Root App<br/>[RootApp.tsx]"]
  node_connections["Server Connections"]
  node_router["Legacy Router<br/>[appRouter.js]"]
  node_layout["Layout Manager<br/>[layoutManager.js]"]
end

subgraph group_media["Media Experience"]
  node_modern["Modern Client"]
  node_legacy["Legacy Client"]
  node_libraries["Library Browsing"]
  node_search["Media Search"]
  node_live["Live TV"]
  node_preferences["User Preferences"]
end

subgraph group_admin["Server Dashboard"]
  node_dashboard["Admin Dashboard"]
  node_tasks["Scheduled Tasks"]
  node_backups["Backups"]
  node_plugins["Plugin Management"]
end

subgraph group_playback["Playback"]
  node_playback["Playback Manager<br/>[playbackmanager.js]"]
  node_queue["Playback Queue"]
end

subgraph group_sync["SyncPlay"]
  node_syncmanager["SyncPlay Manager<br/>[Manager.js]"]
  node_synccontroller["SyncPlay Controller<br/>[Controller.js]"]
  node_syncplayback["SyncPlay Playback Core<br/>[PlaybackCore.js]"]
  node_syncqueue["SyncPlay Queue Core<br/>[QueueCore.js]"]
  node_timesync["Time Synchronization<br/>[TimeSyncCore.js]"]
end

node_user(("Client User"))
node_server(("Jellyfin Server"))

node_user -->|"opens"| node_entry
node_entry -->|"renders"| node_root
node_server -->|"validates connection"| node_connections
node_playback -->|"creates"| node_queue
node_syncmanager -->|"creates"| node_synccontroller
node_syncmanager -->|"creates"| node_syncplayback
node_syncmanager -->|"creates"| node_syncqueue
node_syncmanager -->|"creates"| node_timesync

click node_entry "https://github.com/jellyfin/jellyfin-web/blob/master/src/index.jsx"
click node_root "https://github.com/jellyfin/jellyfin-web/blob/master/src/RootApp.tsx"
click node_connections "https://github.com/jellyfin/jellyfin-web/blob/master/src/lib/jellyfin-apiclient/connectionManager.js"
click node_router "https://github.com/jellyfin/jellyfin-web/blob/master/src/components/router/appRouter.js"
click node_layout "https://github.com/jellyfin/jellyfin-web/blob/master/src/components/layoutManager.js"
click node_modern "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/modern"
click node_legacy "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/legacy"
click node_libraries "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/modern/features/libraries"
click node_search "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/legacy/features/search"
click node_live "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/legacy/controllers/livetv"
click node_preferences "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/modern/features/preferences"
click node_dashboard "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard"
click node_tasks "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard/features/tasks"
click node_backups "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard/features/backups"
click node_plugins "https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard/features/plugins"
click node_playback "https://github.com/jellyfin/jellyfin-web/blob/master/src/components/playback/playbackmanager.js"
click node_queue "https://github.com/jellyfin/jellyfin-web/blob/master/src/components/playback/playqueuemanager.js"
click node_syncmanager "https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/Manager.js"
click node_synccontroller "https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/Controller.js"
click node_syncplayback "https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/PlaybackCore.js"
click node_syncqueue "https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/QueueCore.js"
click node_timesync "https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/timeSync/TimeSyncCore.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_entry,node_root,node_connections,node_router,node_layout,node_user toneBlue
class node_modern,node_legacy,node_libraries,node_search,node_live,node_preferences toneAmber
class node_dashboard,node_tasks,node_backups,node_plugins,node_server toneMint
class node_playback,node_queue toneRose
class node_syncmanager,node_synccontroller,node_syncplayback,node_syncqueue,node_timesync toneIndigo
```

## Components

### App Shell

- [App Bootstrap](https://github.com/jellyfin/jellyfin-web/blob/master/src/index.jsx): `src/index.jsx`
- [Root App](https://github.com/jellyfin/jellyfin-web/blob/master/src/RootApp.tsx): `src/RootApp.tsx`
- [Server Connections](https://github.com/jellyfin/jellyfin-web/blob/master/src/lib/jellyfin-apiclient/connectionManager.js): `src/lib/jellyfin-apiclient/connectionManager.js`
- [Legacy Router](https://github.com/jellyfin/jellyfin-web/blob/master/src/components/router/appRouter.js): `src/components/router/appRouter.js`
- [Layout Manager](https://github.com/jellyfin/jellyfin-web/blob/master/src/components/layoutManager.js): `src/components/layoutManager.js`

### Media Experience

- [Modern Client](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/modern): `src/apps/modern`
- [Legacy Client](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/legacy): `src/apps/legacy`
- [Library Browsing](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/modern/features/libraries): `src/apps/modern/features/libraries`
- [Media Search](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/legacy/features/search): `src/apps/legacy/features/search`
- [Live TV](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/legacy/controllers/livetv): `src/apps/legacy/controllers/livetv`
- [User Preferences](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/modern/features/preferences): `src/apps/modern/features/preferences`

### Server Dashboard

- [Admin Dashboard](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard): `src/apps/dashboard`
- [Scheduled Tasks](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard/features/tasks): `src/apps/dashboard/features/tasks`
- [Backups](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard/features/backups): `src/apps/dashboard/features/backups`
- [Plugin Management](https://github.com/jellyfin/jellyfin-web/tree/master/src/apps/dashboard/features/plugins): `src/apps/dashboard/features/plugins`

### Playback

- [Playback Manager](https://github.com/jellyfin/jellyfin-web/blob/master/src/components/playback/playbackmanager.js): `src/components/playback/playbackmanager.js`
- [Playback Queue](https://github.com/jellyfin/jellyfin-web/blob/master/src/components/playback/playqueuemanager.js): `src/components/playback/playqueuemanager.js`

### SyncPlay

- [SyncPlay Manager](https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/Manager.js): `src/plugins/syncPlay/core/Manager.js`
- [SyncPlay Controller](https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/Controller.js): `src/plugins/syncPlay/core/Controller.js`
- [SyncPlay Playback Core](https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/PlaybackCore.js): `src/plugins/syncPlay/core/PlaybackCore.js`
- [SyncPlay Queue Core](https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/QueueCore.js): `src/plugins/syncPlay/core/QueueCore.js`
- [Time Synchronization](https://github.com/jellyfin/jellyfin-web/blob/master/src/plugins/syncPlay/core/timeSync/TimeSyncCore.js): `src/plugins/syncPlay/core/timeSync/TimeSyncCore.js`

### Other components

- **Client User**
- **Jellyfin Server**

## Connections

- Client User → App Bootstrap: opens (evidence: `README.md`)
- App Bootstrap → Root App: renders (evidence: `src/index.jsx`)
- Jellyfin Server → Server Connections: validates connection (evidence: `src/lib/jellyfin-apiclient/connectionManager.js`)
- Playback Manager → Playback Queue: creates (evidence: `src/components/playback/playbackmanager.js`)
- SyncPlay Manager → SyncPlay Controller: creates (evidence: `src/plugins/syncPlay/core/Manager.js`)
- SyncPlay Manager → SyncPlay Playback Core: creates (evidence: `src/plugins/syncPlay/core/Manager.js`)
- SyncPlay Manager → SyncPlay Queue Core: creates (evidence: `src/plugins/syncPlay/core/Manager.js`)
- SyncPlay Manager → Time Synchronization: creates (evidence: `src/plugins/syncPlay/core/Manager.js`)
