# google/exoplayer architecture

> Architecture diagram of the GitHub repository google/exoplayer, 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/google/exoplayer
- Repository: https://github.com/google/exoplayer

## Overview

ExoPlayer is an Android media playback and processing library, with downloadable media and adapters for alternate transports, codecs, ads, sessions, and remote playback. The principal workflow is an application controlling a player that loads a media source, extracts and decodes samples, and renders audio/video; transformation is a separate export workflow. The tree and index establish these product areas, but sampled source does not show the central player/source wiring, so those relationships are marked unverified rather than asserted. The README only documents project deprecation and migration to Media3.

Main entry points: [`library/common/src/main/java/com/google/android/exoplayer2/Player.java`](https://github.com/google/exoplayer/blob/release-v2/library/common/src/main/java/com/google/android/exoplayer2/Player.java) (Player API), [`library/core/src/main/java/com/google/android/exoplayer2/source`](https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2/source) (Media sources), [`library/core/src/main/java/com/google/android/exoplayer2`](https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2) (Playback engine), [`library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java`](https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java) (Export sample base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_playback["Playback core"]
  node_player_api["Player API<br/>[Player.java]"]
  node_media_types["Media types"]
  node_playback_engine["Playback engine"]
  node_media_sources["Media sources"]
  node_stream_formats["Stream formats"]
  node_extractors["Container extractors"]
  node_decoder_framework["Decoder framework"]
  node_renderers["Audio/video renderers"]
  node_datasources["Data sources"]
end

subgraph group_processing["Media processing"]
  node_common_audio["Audio processing"]
  node_video_effects["Video effects"]
  node_audio_export["Audio export pipeline"]
  node_video_export["Video export pipeline"]
  node_sample_pipeline["Export sample base"]
  node_muxer["Output muxer<br/>[MuxerWrapper.java]"]
  node_export_errors["Export errors"]
end

subgraph group_offline["Offline media"]
  node_download_service["Download service"]
  node_download_manager["Download manager"]
  node_download_store[("Download database")]
end

subgraph group_integrations["Playback integrations"]
  node_player_ui["Player UI"]
  node_media_sessions["Media sessions"]
  node_ads["Ad insertion<br/>[ImaAdsLoader.java]"]
  node_cast["Cast playback<br/>[CastPlayer.java]"]
end

subgraph group_extensions["Optional extensions"]
  node_network_extensions["Network adapters"]
  node_codec_extensions["Codec extensions"]
  node_other_extensions["Other extensions"]
end

node_app(("Application"))

node_app -.->|"controls"| node_player_api
node_player_api -.->|"delegates to"| node_playback_engine
node_playback_engine -.->|"requests media"| node_media_sources
node_media_sources -.->|"loads streams"| node_stream_formats
node_media_sources -.->|"parses samples"| node_extractors
node_media_sources -.->|"reads media"| node_datasources
node_playback_engine -.->|"decodes samples"| node_decoder_framework
node_playback_engine -.->|"dispatches tracks"| node_renderers
node_media_types -.->|"defines contracts"| node_player_api
node_player_api -->|"controls"| node_player_ui
node_player_api -.->|"controls"| node_media_sessions
node_player_api -.->|"remote playback"| node_cast
node_media_sources -.->|"inserts ads"| node_ads
node_download_service -->|"manages downloads"| node_download_manager
node_download_manager -.->|"persists state"| node_download_store
node_audio_export -->|"extends"| node_sample_pipeline
node_video_export -->|"extends"| node_sample_pipeline
node_audio_export -->|"processes audio"| node_common_audio
node_video_export -->|"processes frames"| node_video_effects
node_sample_pipeline -->|"writes output"| node_muxer
node_audio_export -->|"writes output"| node_muxer
node_video_export -.->|"writes output"| node_muxer
node_sample_pipeline -.->|"reports failures"| node_export_errors
node_network_extensions -.->|"supplies transport"| node_datasources
node_codec_extensions -.->|"adds codecs"| node_renderers
node_other_extensions -.->|"extends playback"| node_playback_engine

click node_player_api "https://github.com/google/exoplayer/blob/release-v2/library/common/src/main/java/com/google/android/exoplayer2/Player.java"
click node_media_types "https://github.com/google/exoplayer/tree/release-v2/library/common/src/main/java/com/google/android/exoplayer2"
click node_playback_engine "https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2"
click node_media_sources "https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2/source"
click node_stream_formats "https://github.com/google/exoplayer/tree/release-v2/library/dash/src/main/java/com/google/android/exoplayer2/source/dash"
click node_extractors "https://github.com/google/exoplayer/tree/release-v2/library/extractor/src/main/java/com/google/android/exoplayer2/extractor"
click node_decoder_framework "https://github.com/google/exoplayer/tree/release-v2/library/decoder/src/main/java/com/google/android/exoplayer2/decoder"
click node_renderers "https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2"
click node_datasources "https://github.com/google/exoplayer/tree/release-v2/library/datasource/src/main/java/com/google/android/exoplayer2/upstream"
click node_common_audio "https://github.com/google/exoplayer/blob/release-v2/library/common/src/main/java/com/google/android/exoplayer2/audio/AudioProcessingPipeline.java"
click node_video_effects "https://github.com/google/exoplayer/blob/release-v2/library/effect/src/main/java/com/google/android/exoplayer2/effect/ExternalTextureManager.java"
click node_audio_export "https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java"
click node_video_export "https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java"
click node_sample_pipeline "https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java"
click node_muxer "https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/MuxerWrapper.java"
click node_export_errors "https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/ExportException.java"
click node_download_service "https://github.com/google/exoplayer/blob/release-v2/library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadService.java"
click node_download_manager "https://github.com/google/exoplayer/blob/release-v2/library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadManager.java"
click node_download_store "https://github.com/google/exoplayer/blob/release-v2/library/database/src/main/java/com/google/android/exoplayer2/database/DefaultDatabaseProvider.java"
click node_player_ui "https://github.com/google/exoplayer/blob/release-v2/library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerNotificationManager.java"
click node_media_sessions "https://github.com/google/exoplayer/blob/release-v2/extensions/mediasession/src/main/java/com/google/android/exoplayer2/ext/mediasession/MediaSessionConnector.java"
click node_ads "https://github.com/google/exoplayer/blob/release-v2/extensions/ima/src/main/java/com/google/android/exoplayer2/ext/ima/ImaAdsLoader.java"
click node_cast "https://github.com/google/exoplayer/blob/release-v2/extensions/cast/src/main/java/com/google/android/exoplayer2/ext/cast/CastPlayer.java"
click node_network_extensions "https://github.com/google/exoplayer/blob/release-v2/extensions/cronet/src/main/java/com/google/android/exoplayer2/ext/cronet/CronetDataSource.java"
click node_codec_extensions "https://github.com/google/exoplayer/blob/release-v2/extensions/av1/src/main/java/com/google/android/exoplayer2/ext/av1/Libgav1VideoRenderer.java"
click node_other_extensions "https://github.com/google/exoplayer/tree/release-v2/extensions"

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_player_api,node_media_types,node_playback_engine,node_media_sources,node_stream_formats,node_extractors,node_decoder_framework,node_renderers,node_datasources toneBlue
class node_common_audio,node_video_effects,node_audio_export,node_video_export,node_sample_pipeline,node_muxer,node_export_errors toneAmber
class node_download_service,node_download_manager,node_download_store toneMint
class node_player_ui,node_media_sessions,node_ads,node_cast toneRose
class node_network_extensions,node_codec_extensions,node_other_extensions,node_app toneIndigo
```

## Components

### Playback core

- [Player API](https://github.com/google/exoplayer/blob/release-v2/library/common/src/main/java/com/google/android/exoplayer2/Player.java): `library/common/src/main/java/com/google/android/exoplayer2/Player.java`
- [Media types](https://github.com/google/exoplayer/tree/release-v2/library/common/src/main/java/com/google/android/exoplayer2): `library/common/src/main/java/com/google/android/exoplayer2`
- [Playback engine](https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2): `library/core/src/main/java/com/google/android/exoplayer2`
- [Media sources](https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2/source): `library/core/src/main/java/com/google/android/exoplayer2/source`
- [Stream formats](https://github.com/google/exoplayer/tree/release-v2/library/dash/src/main/java/com/google/android/exoplayer2/source/dash): `library/dash/src/main/java/com/google/android/exoplayer2/source/dash`
- [Container extractors](https://github.com/google/exoplayer/tree/release-v2/library/extractor/src/main/java/com/google/android/exoplayer2/extractor): `library/extractor/src/main/java/com/google/android/exoplayer2/extractor`
- [Decoder framework](https://github.com/google/exoplayer/tree/release-v2/library/decoder/src/main/java/com/google/android/exoplayer2/decoder): `library/decoder/src/main/java/com/google/android/exoplayer2/decoder`
- [Audio/video renderers](https://github.com/google/exoplayer/tree/release-v2/library/core/src/main/java/com/google/android/exoplayer2): `library/core/src/main/java/com/google/android/exoplayer2`
- [Data sources](https://github.com/google/exoplayer/tree/release-v2/library/datasource/src/main/java/com/google/android/exoplayer2/upstream): `library/datasource/src/main/java/com/google/android/exoplayer2/upstream`

### Media processing

- [Audio processing](https://github.com/google/exoplayer/blob/release-v2/library/common/src/main/java/com/google/android/exoplayer2/audio/AudioProcessingPipeline.java): `library/common/src/main/java/com/google/android/exoplayer2/audio/AudioProcessingPipeline.java`
- [Video effects](https://github.com/google/exoplayer/blob/release-v2/library/effect/src/main/java/com/google/android/exoplayer2/effect/ExternalTextureManager.java): `library/effect/src/main/java/com/google/android/exoplayer2/effect/ExternalTextureManager.java`
- [Audio export pipeline](https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java): `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java`
- [Video export pipeline](https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java): `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java`
- [Export sample base](https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java): `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java`
- [Output muxer](https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/MuxerWrapper.java): `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/MuxerWrapper.java`
- [Export errors](https://github.com/google/exoplayer/blob/release-v2/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/ExportException.java): `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/ExportException.java`

### Offline media

- [Download service](https://github.com/google/exoplayer/blob/release-v2/library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadService.java): `library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadService.java`
- [Download manager](https://github.com/google/exoplayer/blob/release-v2/library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadManager.java): `library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadManager.java`
- [Download database](https://github.com/google/exoplayer/blob/release-v2/library/database/src/main/java/com/google/android/exoplayer2/database/DefaultDatabaseProvider.java): `library/database/src/main/java/com/google/android/exoplayer2/database/DefaultDatabaseProvider.java`

### Playback integrations

- [Player UI](https://github.com/google/exoplayer/blob/release-v2/library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerNotificationManager.java): `library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerNotificationManager.java`
- [Media sessions](https://github.com/google/exoplayer/blob/release-v2/extensions/mediasession/src/main/java/com/google/android/exoplayer2/ext/mediasession/MediaSessionConnector.java): `extensions/mediasession/src/main/java/com/google/android/exoplayer2/ext/mediasession/MediaSessionConnector.java`
- [Ad insertion](https://github.com/google/exoplayer/blob/release-v2/extensions/ima/src/main/java/com/google/android/exoplayer2/ext/ima/ImaAdsLoader.java): `extensions/ima/src/main/java/com/google/android/exoplayer2/ext/ima/ImaAdsLoader.java`
- [Cast playback](https://github.com/google/exoplayer/blob/release-v2/extensions/cast/src/main/java/com/google/android/exoplayer2/ext/cast/CastPlayer.java): `extensions/cast/src/main/java/com/google/android/exoplayer2/ext/cast/CastPlayer.java`

### Optional extensions

- [Network adapters](https://github.com/google/exoplayer/blob/release-v2/extensions/cronet/src/main/java/com/google/android/exoplayer2/ext/cronet/CronetDataSource.java): `extensions/cronet/src/main/java/com/google/android/exoplayer2/ext/cronet/CronetDataSource.java`
- [Codec extensions](https://github.com/google/exoplayer/blob/release-v2/extensions/av1/src/main/java/com/google/android/exoplayer2/ext/av1/Libgav1VideoRenderer.java): `extensions/av1/src/main/java/com/google/android/exoplayer2/ext/av1/Libgav1VideoRenderer.java`
- [Other extensions](https://github.com/google/exoplayer/tree/release-v2/extensions): `extensions`

### Other components

- **Application**

## Connections

- Application → Player API: controls
- Player API → Playback engine: delegates to (evidence: `library/core/src/main/java/com/google/android/exoplayer2/AudioFocusManager.java`)
- Playback engine → Media sources: requests media (evidence: `library/core/src/main/java/com/google/android/exoplayer2/analytics/DefaultPlaybackSessionManager.java`)
- Media sources → Stream formats: loads streams (evidence: `library/dash/src/main/java/com/google/android/exoplayer2/source/dash/PlayerEmsgHandler.java`)
- Media sources → Container extractors: parses samples
- Media sources → Data sources: reads media
- Playback engine → Decoder framework: decodes samples
- Playback engine → Audio/video renderers: dispatches tracks
- Media types → Player API: defines contracts (evidence: `library/common/src/main/java/com/google/android/exoplayer2/util/Util.java`)
- Player API → Player UI: controls (evidence: `library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerNotificationManager.java`)
- Player API → Media sessions: controls
- Player API → Cast playback: remote playback
- Media sources → Ad insertion: inserts ads
- Download service → Download manager: manages downloads (evidence: `library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadService.java`)
- Download manager → Download database: persists state
- Audio export pipeline → Export sample base: extends (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java`)
- Video export pipeline → Export sample base: extends (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java`)
- Audio export pipeline → Audio processing: processes audio (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java`)
- Video export pipeline → Video effects: processes frames (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java`)
- Export sample base → Output muxer: writes output (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java`)
- Audio export pipeline → Output muxer: writes output (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java`)
- Video export pipeline → Output muxer: writes output (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java`)
- Export sample base → Export errors: reports failures (evidence: `library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java`)
- Network adapters → Data sources: supplies transport
- Codec extensions → Audio/video renderers: adds codecs
- Other extensions → Playback engine: extends playback (evidence: `extensions/workmanager/src/main/java/com/google/android/exoplayer2/ext/workmanager/WorkManagerScheduler.java`)
