# jellyfin/jellyfin architecture

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

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

## Overview

Jellyfin is a self-hosted media server for organizing a media library and streaming it to client devices. A typical user requests library content or playback through the API; the server resolves and queries media, returns item data, or prepares a stream. The map also includes metadata providers, user/session services, and database persistence as important supporting capabilities. Some edges reflect explicit README statements or source-index references; links to unsampled subsystems are omitted rather than inferred.

Main entry points: [`Emby.Server.Implementations/Library/LibraryManager.cs`](https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Library/LibraryManager.cs) (Library manager), [`Jellyfin.Api/Controllers/ItemsController.cs`](https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Api/Controllers/ItemsController.cs) (HTTP API), [`Jellyfin.Api/Controllers/DynamicHlsController.cs`](https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Api/Controllers/DynamicHlsController.cs) (HLS endpoints), [`MediaBrowser.Providers/Manager/ProviderManager.cs`](https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Providers/Manager/ProviderManager.cs) (Metadata providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_api["HTTP API<br/>[ItemsController.cs]"]
  node_stream_api["HLS endpoints"]
  node_auth["Authentication<br/>[AuthService.cs]"]
  node_dto["Item responses<br/>[DtoService.cs]"]
end

subgraph group_library["Library and metadata"]
  node_library_manager["Library manager<br/>[LibraryManager.cs]"]
  node_item_model["Media item model<br/>[BaseItem.cs]"]
  node_video_model["Video model<br/>[Video.cs]"]
  node_library_contract["Library contract<br/>[ILibraryManager.cs]"]
  node_naming["Name resolution<br/>[VideoResolver.cs]"]
  node_provider_manager["Metadata providers<br/>[ProviderManager.cs]"]
  node_photo_provider["Photo provider<br/>[PhotoProvider.cs]"]
  node_search["Library search<br/>[SearchManager.cs]"]
end

subgraph group_playback["Playback and sessions"]
  node_transcode_api["Transcode manager"]
  node_encoding["Encoding helper<br/>[EncodingHelper.cs]"]
  node_session["Session manager<br/>[SessionManager.cs]"]
  node_syncplay["Synchronized playback<br/>[SyncPlayManager.cs]"]
end

subgraph group_storage["Persistence and users"]
  node_query["Item query"]
  node_query_build["Query translation"]
  node_db[("Database context")]
  node_user_entity["User records<br/>[User.cs]"]
  node_user_manager["User management<br/>[UserManager.cs]"]
end

node_client(("Client device"))

node_client -->|"requests content"| node_api
node_client -->|"requests playback"| node_stream_api
node_api -.->|"authenticates"| node_auth
node_library_manager -->|"resolves items"| node_video_model
node_library_manager -->|"uses naming"| node_naming
node_library_contract -.->|"implemented by"| node_library_manager
node_provider_manager -->|"uses library"| node_library_manager
node_provider_manager -.->|"loads providers"| node_photo_provider
node_api -.->|"queries items"| node_library_manager
node_api -.->|"returns item data"| node_dto
node_api -.->|"searches library"| node_search
node_stream_api -->|"requests transcoding"| node_transcode_api
node_stream_api -->|"uses encoding"| node_encoding
node_stream_api -->|"looks up media"| node_library_manager
node_stream_api -.->|"checks user state"| node_session
node_syncplay -.->|"coordinates sessions"| node_session
node_query -.->|"builds queries"| node_query_build
node_query -->|"queries database"| node_db
node_query_build -->|"translates queries"| node_db
node_user_manager -.->|"manages users"| node_user_entity

click node_api "https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Api/Controllers/ItemsController.cs"
click node_stream_api "https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Api/Controllers/DynamicHlsController.cs"
click node_auth "https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/HttpServer/Security/AuthService.cs"
click node_library_manager "https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Library/LibraryManager.cs"
click node_item_model "https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/Entities/BaseItem.cs"
click node_video_model "https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/Entities/Video.cs"
click node_library_contract "https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/Library/ILibraryManager.cs"
click node_naming "https://github.com/jellyfin/jellyfin/blob/master/Emby.Naming/Video/VideoResolver.cs"
click node_provider_manager "https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Providers/Manager/ProviderManager.cs"
click node_photo_provider "https://github.com/jellyfin/jellyfin/blob/master/Emby.Photos/PhotoProvider.cs"
click node_dto "https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Dto/DtoService.cs"
click node_search "https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Library/Search/SearchManager.cs"
click node_transcode_api "https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.MediaEncoding/Transcoding/TranscodeManager.cs"
click node_encoding "https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/MediaEncoding/EncodingHelper.cs"
click node_session "https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Session/SessionManager.cs"
click node_syncplay "https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/SyncPlay/SyncPlayManager.cs"
click node_query "https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Server.Implementations/Item/BaseItemRepository.Querying.cs"
click node_query_build "https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Server.Implementations/Item/BaseItemRepository.QueryBuilding.cs"
click node_db "https://github.com/jellyfin/jellyfin/blob/master/src/Jellyfin.Database/Jellyfin.Database.Implementations/JellyfinDbContext.cs"
click node_user_entity "https://github.com/jellyfin/jellyfin/blob/master/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/User.cs"
click node_user_manager "https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Server.Implementations/Users/UserManager.cs"

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_api,node_stream_api,node_auth,node_dto,node_client toneBlue
class node_library_manager,node_item_model,node_video_model,node_library_contract,node_naming,node_provider_manager,node_photo_provider,node_search toneAmber
class node_transcode_api,node_encoding,node_session,node_syncplay toneMint
class node_query,node_query_build,node_db,node_user_entity,node_user_manager toneRose
```

## Components

### API and access

- [HTTP API](https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Api/Controllers/ItemsController.cs): `Jellyfin.Api/Controllers/ItemsController.cs`
- [HLS endpoints](https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Api/Controllers/DynamicHlsController.cs): `Jellyfin.Api/Controllers/DynamicHlsController.cs`
- [Authentication](https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/HttpServer/Security/AuthService.cs): `Emby.Server.Implementations/HttpServer/Security/AuthService.cs`
- [Item responses](https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Dto/DtoService.cs): `Emby.Server.Implementations/Dto/DtoService.cs`

### Library and metadata

- [Library manager](https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Library/LibraryManager.cs): `Emby.Server.Implementations/Library/LibraryManager.cs`
- [Media item model](https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/Entities/BaseItem.cs): `MediaBrowser.Controller/Entities/BaseItem.cs`
- [Video model](https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/Entities/Video.cs): `MediaBrowser.Controller/Entities/Video.cs`
- [Library contract](https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/Library/ILibraryManager.cs): `MediaBrowser.Controller/Library/ILibraryManager.cs`
- [Name resolution](https://github.com/jellyfin/jellyfin/blob/master/Emby.Naming/Video/VideoResolver.cs): `Emby.Naming/Video/VideoResolver.cs`
- [Metadata providers](https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Providers/Manager/ProviderManager.cs): `MediaBrowser.Providers/Manager/ProviderManager.cs`
- [Photo provider](https://github.com/jellyfin/jellyfin/blob/master/Emby.Photos/PhotoProvider.cs): `Emby.Photos/PhotoProvider.cs`
- [Library search](https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Library/Search/SearchManager.cs): `Emby.Server.Implementations/Library/Search/SearchManager.cs`

### Playback and sessions

- [Transcode manager](https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.MediaEncoding/Transcoding/TranscodeManager.cs): `MediaBrowser.MediaEncoding/Transcoding/TranscodeManager.cs`
- [Encoding helper](https://github.com/jellyfin/jellyfin/blob/master/MediaBrowser.Controller/MediaEncoding/EncodingHelper.cs): `MediaBrowser.Controller/MediaEncoding/EncodingHelper.cs`
- [Session manager](https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/Session/SessionManager.cs): `Emby.Server.Implementations/Session/SessionManager.cs`
- [Synchronized playback](https://github.com/jellyfin/jellyfin/blob/master/Emby.Server.Implementations/SyncPlay/SyncPlayManager.cs): `Emby.Server.Implementations/SyncPlay/SyncPlayManager.cs`

### Persistence and users

- [Item query](https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Server.Implementations/Item/BaseItemRepository.Querying.cs): `Jellyfin.Server.Implementations/Item/BaseItemRepository.Querying.cs`
- [Query translation](https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Server.Implementations/Item/BaseItemRepository.QueryBuilding.cs): `Jellyfin.Server.Implementations/Item/BaseItemRepository.QueryBuilding.cs`
- [Database context](https://github.com/jellyfin/jellyfin/blob/master/src/Jellyfin.Database/Jellyfin.Database.Implementations/JellyfinDbContext.cs): `src/Jellyfin.Database/Jellyfin.Database.Implementations/JellyfinDbContext.cs`
- [User records](https://github.com/jellyfin/jellyfin/blob/master/src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/User.cs): `src/Jellyfin.Database/Jellyfin.Database.Implementations/Entities/User.cs`
- [User management](https://github.com/jellyfin/jellyfin/blob/master/Jellyfin.Server.Implementations/Users/UserManager.cs): `Jellyfin.Server.Implementations/Users/UserManager.cs`

### Other components

- **Client device**

## Connections

- Client device → HTTP API: requests content (evidence: `README.md`)
- Client device → HLS endpoints: requests playback (evidence: `README.md`)
- HTTP API → Authentication: authenticates
- Library manager → Video model: resolves items (evidence: `Emby.Server.Implementations/Library/LibraryManager.cs`)
- Library manager → Name resolution: uses naming (evidence: `Emby.Server.Implementations/Library/LibraryManager.cs`)
- Library contract → Library manager: implemented by (evidence: `Emby.Server.Implementations/Library/LibraryManager.cs`)
- Metadata providers → Library manager: uses library (evidence: `MediaBrowser.Providers/Manager/ProviderManager.cs`)
- Metadata providers → Photo provider: loads providers
- HTTP API → Library manager: queries items
- HTTP API → Item responses: returns item data
- HTTP API → Library search: searches library
- HLS endpoints → Transcode manager: requests transcoding (evidence: `Jellyfin.Api/Controllers/DynamicHlsController.cs`)
- HLS endpoints → Encoding helper: uses encoding (evidence: `Jellyfin.Api/Controllers/DynamicHlsController.cs`)
- HLS endpoints → Library manager: looks up media (evidence: `Jellyfin.Api/Controllers/DynamicHlsController.cs`)
- HLS endpoints → Session manager: checks user state
- Synchronized playback → Session manager: coordinates sessions
- Item query → Query translation: builds queries
- Item query → Database context: queries database (evidence: `Jellyfin.Server.Implementations/Item/BaseItemRepository.Querying.cs`)
- Query translation → Database context: translates queries (evidence: `Jellyfin.Server.Implementations/Item/BaseItemRepository.QueryBuilding.cs`)
- User management → User records: manages users (evidence: `Jellyfin.Server.Implementations/Users/UserManager.cs`)
