# aomediacodec/avm architecture

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

- Interactive diagram: https://gitdiagram.com/aomediacodec/avm
- Repository: https://github.com/aomediacodec/avm

## Overview

AVM is an AV2 video codec library with command-line encoding and decoding applications. Its principal workflow accepts video, configures and runs the encoder, emits a coded stream, then parses and decodes that stream into frames. The graph also preserves the repository’s separate AVM Analyzer application and its local/HTTP stream and visualization branches. Encoder/decoder internals and analyzer wiring are only partly sampled; unsupported implementation links are omitted rather than inferred.

Main entry points: [`av2/encoder/encoder.h`](https://github.com/aomediacodec/avm/blob/main/av2/encoder/encoder.h) (Encoder engine), [`avm/avm_codec.h`](https://github.com/aomediacodec/avm/blob/main/avm/avm_codec.h) (Codec API), [`av2/av2_cx_iface.c`](https://github.com/aomediacodec/avm/blob/main/av2/av2_cx_iface.c) (Encoder interface), [`av2/encoder/partition_search.c`](https://github.com/aomediacodec/avm/blob/main/av2/encoder/partition_search.c) (Partition search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Codec applications"]
  node_avmenc["Encoder CLI<br/>[avmenc.c]"]
  node_avmdec["Decoder CLI<br/>[avmdec.c]"]
end

subgraph group_codec["Codec runtime"]
  node_api["Codec API<br/>[avm_codec.h]"]
  node_encoder_iface["Encoder interface<br/>[av2_cx_iface.c]"]
  node_encoder_core["Encoder engine<br/>[encoder.h]"]
  node_partition["Partition search<br/>[partition_search.c]"]
  node_transform["Transform search<br/>[tx_search.c]"]
  node_bitstream["Bitstream writing<br/>[bitstream.c]"]
  node_decoder_iface["Decoder interface<br/>[av2_dx_iface.c]"]
  node_decodeframe["Frame decoding<br/>[decodeframe.c]"]
  node_codec_state["Frame and block state<br/>[av2_common_int.h]"]
  node_entropy["Entropy coding<br/>[entropy.h]"]
  node_quant["Quantization rules<br/>[quant_common.h]"]
  node_dsp["Signal processing<br/>[avm_dsp_common.h]"]
end

subgraph group_analysis["Stream analysis"]
  node_analyzer["Analyzer app<br/>[app.rs]"]
  node_streams["Stream management<br/>[mod.rs]"]
  node_local_stream["Local streams"]
  node_http_stream["HTTP streams"]
  node_server_decode["Server decoding<br/>[server_decode.rs]"]
  node_views["Visualization views<br/>[mod.rs]"]
end

node_user(("User"))
node_video["Input video"]
node_coded["Coded stream"]
node_frames["Decoded frames"]

node_user -->|"runs"| node_avmenc
node_video -->|"supplies"| node_avmenc
node_avmenc -->|"uses codec API"| node_api
node_api -->|"selects AV2 encoder"| node_encoder_iface
node_encoder_iface -->|"configures engine"| node_encoder_core
node_encoder_core -.->|"searches partitions"| node_partition
node_encoder_core -.->|"searches transforms"| node_transform
node_encoder_iface -.->|"emits packets"| node_bitstream
node_bitstream -.->|"produces"| node_coded
node_encoder_core -.->|"uses frame state"| node_codec_state
node_partition -->|"uses block state"| node_codec_state
node_partition -->|"references quant rules"| node_quant
node_transform -->|"references quant rules"| node_quant
node_user -->|"runs"| node_avmdec
node_coded -.->|"supplies stream"| node_avmdec
node_avmdec -.->|"uses codec API"| node_api
node_api -->|"selects AV2 decoder"| node_decoder_iface
node_decoder_iface -.->|"decodes frames"| node_decodeframe
node_decodeframe -->|"uses frame state"| node_codec_state
node_decodeframe -.->|"outputs"| node_frames
node_analyzer -->|"uses stream manager"| node_streams
node_analyzer -->|"renders views"| node_views
node_streams -->|"dispatches locally"| node_local_stream
node_http_stream -->|"uses decoding"| node_server_decode

click node_avmenc "https://github.com/aomediacodec/avm/blob/main/apps/avmenc.c"
click node_avmdec "https://github.com/aomediacodec/avm/blob/main/apps/avmdec.c"
click node_api "https://github.com/aomediacodec/avm/blob/main/avm/avm_codec.h"
click node_encoder_iface "https://github.com/aomediacodec/avm/blob/main/av2/av2_cx_iface.c"
click node_encoder_core "https://github.com/aomediacodec/avm/blob/main/av2/encoder/encoder.h"
click node_partition "https://github.com/aomediacodec/avm/blob/main/av2/encoder/partition_search.c"
click node_transform "https://github.com/aomediacodec/avm/blob/main/av2/encoder/tx_search.c"
click node_bitstream "https://github.com/aomediacodec/avm/blob/main/av2/encoder/bitstream.c"
click node_decoder_iface "https://github.com/aomediacodec/avm/blob/main/av2/av2_dx_iface.c"
click node_decodeframe "https://github.com/aomediacodec/avm/blob/main/av2/decoder/decodeframe.c"
click node_codec_state "https://github.com/aomediacodec/avm/blob/main/av2/common/av2_common_int.h"
click node_entropy "https://github.com/aomediacodec/avm/blob/main/av2/common/entropy.h"
click node_quant "https://github.com/aomediacodec/avm/blob/main/av2/common/quant_common.h"
click node_dsp "https://github.com/aomediacodec/avm/blob/main/avm_dsp/avm_dsp_common.h"
click node_analyzer "https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/app.rs"
click node_streams "https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/mod.rs"
click node_local_stream "https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/local_stream_manager.rs"
click node_http_stream "https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/http_stream_manager.rs"
click node_server_decode "https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/server_decode.rs"
click node_views "https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/views/mod.rs"

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_avmenc,node_avmdec,node_user toneBlue
class node_api,node_encoder_iface,node_encoder_core,node_partition,node_transform,node_bitstream,node_decoder_iface,node_decodeframe,node_codec_state,node_entropy,node_quant,node_dsp toneAmber
class node_analyzer,node_streams,node_local_stream,node_http_stream,node_server_decode,node_views toneMint
class node_video,node_coded,node_frames toneIndigo
```

## Components

### Codec applications

- [Encoder CLI](https://github.com/aomediacodec/avm/blob/main/apps/avmenc.c): `apps/avmenc.c`
- [Decoder CLI](https://github.com/aomediacodec/avm/blob/main/apps/avmdec.c): `apps/avmdec.c`

### Codec runtime

- [Codec API](https://github.com/aomediacodec/avm/blob/main/avm/avm_codec.h): `avm/avm_codec.h`
- [Encoder interface](https://github.com/aomediacodec/avm/blob/main/av2/av2_cx_iface.c): `av2/av2_cx_iface.c`
- [Encoder engine](https://github.com/aomediacodec/avm/blob/main/av2/encoder/encoder.h): `av2/encoder/encoder.h`
- [Partition search](https://github.com/aomediacodec/avm/blob/main/av2/encoder/partition_search.c): `av2/encoder/partition_search.c`
- [Transform search](https://github.com/aomediacodec/avm/blob/main/av2/encoder/tx_search.c): `av2/encoder/tx_search.c`
- [Bitstream writing](https://github.com/aomediacodec/avm/blob/main/av2/encoder/bitstream.c): `av2/encoder/bitstream.c`
- [Decoder interface](https://github.com/aomediacodec/avm/blob/main/av2/av2_dx_iface.c): `av2/av2_dx_iface.c`
- [Frame decoding](https://github.com/aomediacodec/avm/blob/main/av2/decoder/decodeframe.c): `av2/decoder/decodeframe.c`
- [Frame and block state](https://github.com/aomediacodec/avm/blob/main/av2/common/av2_common_int.h): `av2/common/av2_common_int.h`
- [Entropy coding](https://github.com/aomediacodec/avm/blob/main/av2/common/entropy.h): `av2/common/entropy.h`
- [Quantization rules](https://github.com/aomediacodec/avm/blob/main/av2/common/quant_common.h): `av2/common/quant_common.h`
- [Signal processing](https://github.com/aomediacodec/avm/blob/main/avm_dsp/avm_dsp_common.h): `avm_dsp/avm_dsp_common.h`

### Stream analysis

- [Analyzer app](https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/app.rs): `tools/avm_analyzer/avm_analyzer_app/src/app.rs`
- [Stream management](https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/mod.rs): `tools/avm_analyzer/avm_analyzer_app/src/stream/mod.rs`
- [Local streams](https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/local_stream_manager.rs): `tools/avm_analyzer/avm_analyzer_app/src/stream/local_stream_manager.rs`
- [HTTP streams](https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/http_stream_manager.rs): `tools/avm_analyzer/avm_analyzer_app/src/stream/http_stream_manager.rs`
- [Server decoding](https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/stream/server_decode.rs): `tools/avm_analyzer/avm_analyzer_app/src/stream/server_decode.rs`
- [Visualization views](https://github.com/aomediacodec/avm/blob/main/tools/avm_analyzer/avm_analyzer_app/src/views/mod.rs): `tools/avm_analyzer/avm_analyzer_app/src/views/mod.rs`

### Other components

- **User**
- **Input video**
- **Coded stream**
- **Decoded frames**

## Connections

- User → Encoder CLI: runs (evidence: `apps/avmenc.c`)
- Input video → Encoder CLI: supplies (evidence: `apps/avmenc.c`)
- Encoder CLI → Codec API: uses codec API (evidence: `apps/avmenc.c`)
- Codec API → Encoder interface: selects AV2 encoder (evidence: `avm/avm_codec.h`)
- Encoder interface → Encoder engine: configures engine (evidence: `av2/av2_cx_iface.c`)
- Encoder engine → Partition search: searches partitions (evidence: `av2/encoder/partition_search.c`)
- Encoder engine → Transform search: searches transforms
- Encoder interface → Bitstream writing: emits packets
- Bitstream writing → Coded stream: produces
- Encoder engine → Frame and block state: uses frame state
- Partition search → Frame and block state: uses block state (evidence: `av2/encoder/partition_search.c`)
- Partition search → Quantization rules: references quant rules (evidence: `av2/encoder/partition_search.c`)
- Transform search → Quantization rules: references quant rules (evidence: `av2/encoder/tx_search.c`)
- User → Decoder CLI: runs
- Coded stream → Decoder CLI: supplies stream
- Decoder CLI → Codec API: uses codec API
- Codec API → Decoder interface: selects AV2 decoder (evidence: `avm/avm_codec.h`)
- Decoder interface → Frame decoding: decodes frames
- Frame decoding → Frame and block state: uses frame state (evidence: `av2/decoder/decodeframe.c`)
- Frame decoding → Decoded frames: outputs
- Analyzer app → Stream management: uses stream manager (evidence: `tools/avm_analyzer/avm_analyzer_app/src/app.rs`)
- Analyzer app → Visualization views: renders views (evidence: `tools/avm_analyzer/avm_analyzer_app/src/app.rs`)
- Stream management → Local streams: dispatches locally (evidence: `tools/avm_analyzer/avm_analyzer_app/src/stream/local_stream_manager.rs`)
- HTTP streams → Server decoding: uses decoding (evidence: `tools/avm_analyzer/avm_analyzer_app/src/stream/http_stream_manager.rs`)
