# aninsomniacy/aria2-next architecture

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

## Overview

Aria2 Next is a multi-protocol download engine with CLI, JSON-RPC, and embeddable-library interfaces. The main workflow is to accept a request, manage it as a task, dispatch it to a protocol-specific transfer path, write payload data, and retain resumable state and results. Major branches include HTTP(S)/SFTP, BitTorrent, ED2K, Metalink, and native HLS/DASH media. The graph combines README-documented capabilities with relationships visible in sampled source; unsampled wiring is left unasserted or marked unverified.

Main entry points: [`src/RequestGroup.h`](https://github.com/aninsomniacy/aria2-next/blob/main/src/RequestGroup.h) (Download task), [`src/task/TaskManagerQueue.cc`](https://github.com/aninsomniacy/aria2-next/blob/main/src/task/TaskManagerQueue.cc) (Task management), [`src/main.cc`](https://github.com/aninsomniacy/aria2-next/blob/main/src/main.cc) (Engine executable), [`src/stream/StreamStorage.cc`](https://github.com/aninsomniacy/aria2-next/blob/main/src/stream/StreamStorage.cc) (HTTP stream transfer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Engine and tasks"]
  node_executable["Engine executable<br/>[main.cc]"]
  node_options["Options"]
  node_engine["Download engine<br/>[DownloadEngine.cc]"]
  node_task_queue["Task management"]
  node_request_group["Download task<br/>[RequestGroup.h]"]
end

subgraph group_protocols["Transfer protocols"]
  node_http_stream["HTTP stream transfer<br/>[StreamStorage.cc]"]
  node_curl_session["Curl session<br/>[CurlSession.h]"]
  node_bittorrent["BitTorrent"]
  node_ed2k["ED2K"]
  node_metalink["Metalink"]
end

subgraph group_interfaces["Interfaces and media"]
  node_rpc["JSON-RPC"]
  node_media["HLS/DASH media<br/>[MediaSession.cc]"]
end

subgraph group_state["Payload and state"]
  node_download_context["Download context<br/>[DownloadContext.h]"]
  node_piece_storage["Piece storage"]
  node_task_storage["Task persistence<br/>[TaskStorage.cc]"]
  node_session_storage[("Session state")]
  node_diagnostics["Logging<br/>[Log.h]"]
  node_shared_util["Shared utilities<br/>[a2functional.h]"]
  node_message_catalog["Message catalog<br/>[message.h]"]
end

node_cli_user(("CLI user"))
node_rpc_client(("RPC client"))
node_libcurl["libcurl"]
node_libtorrent["libtorrent"]
node_media_libraries["GPAC and FFmpeg"]
node_payload_files[("Payload files")]

node_cli_user -->|"runs"| node_executable
node_rpc_client -->|"calls methods"| node_rpc
node_executable -->|"accepts options"| node_options
node_executable -.->|"starts engine"| node_engine
node_options -.->|"configures tasks"| node_task_queue
node_task_queue -->|"manages tasks"| node_request_group
node_request_group -->|"dispatches transfer"| node_http_stream
node_http_stream -->|"uses session"| node_curl_session
node_http_stream -->|"transfers via"| node_libcurl
node_request_group -->|"supports transfer"| node_bittorrent
node_bittorrent -->|"uses native engine"| node_libtorrent
node_request_group -->|"supports transfer"| node_ed2k
node_request_group -->|"supports metadata"| node_metalink
node_rpc -->|"controls tasks"| node_task_queue
node_request_group -->|"supports media tasks"| node_media
node_media -->|"uses for transfers"| node_libcurl
node_media -->|"uses libraries"| node_media_libraries
node_request_group -->|"holds context"| node_download_context
node_download_context -.->|"tracks pieces"| node_piece_storage
node_piece_storage -.->|"writes payload"| node_payload_files
node_task_queue -->|"stores task state"| node_task_storage
node_task_storage -->|"persists session"| node_session_storage
node_engine -.->|"logs events"| node_diagnostics

click node_executable "https://github.com/aninsomniacy/aria2-next/blob/main/src/main.cc"
click node_options "https://github.com/aninsomniacy/aria2-next/blob/main/src/option_processing.cc"
click node_engine "https://github.com/aninsomniacy/aria2-next/blob/main/src/DownloadEngine.cc"
click node_task_queue "https://github.com/aninsomniacy/aria2-next/blob/main/src/task/TaskManagerQueue.cc"
click node_request_group "https://github.com/aninsomniacy/aria2-next/blob/main/src/RequestGroup.h"
click node_http_stream "https://github.com/aninsomniacy/aria2-next/blob/main/src/stream/StreamStorage.cc"
click node_curl_session "https://github.com/aninsomniacy/aria2-next/blob/main/src/CurlSession.h"
click node_bittorrent "https://github.com/aninsomniacy/aria2-next/blob/main/src/bittorrent/BtSessionControl.cc"
click node_ed2k "https://github.com/aninsomniacy/aria2-next/blob/main/src/ed2k/Ed2kCommandSupport.cc"
click node_metalink "https://github.com/aninsomniacy/aria2-next/blob/main/src/MetalinkParserController.cc"
click node_rpc "https://github.com/aninsomniacy/aria2-next/blob/main/src/rpc/TaskStatusMethods.cc"
click node_media "https://github.com/aninsomniacy/aria2-next/blob/main/src/media/MediaSession.cc"
click node_download_context "https://github.com/aninsomniacy/aria2-next/blob/main/src/DownloadContext.h"
click node_piece_storage "https://github.com/aninsomniacy/aria2-next/blob/main/src/DefaultPieceStorage.cc"
click node_task_storage "https://github.com/aninsomniacy/aria2-next/blob/main/src/task/TaskStorage.cc"
click node_session_storage "https://github.com/aninsomniacy/aria2-next/blob/main/src/task/TaskManagerStorage.cc"
click node_diagnostics "https://github.com/aninsomniacy/aria2-next/blob/main/src/Log.h"
click node_shared_util "https://github.com/aninsomniacy/aria2-next/blob/main/src/a2functional.h"
click node_message_catalog "https://github.com/aninsomniacy/aria2-next/blob/main/src/message.h"

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_executable,node_options,node_engine,node_task_queue,node_request_group,node_cli_user,node_rpc_client toneBlue
class node_http_stream,node_curl_session,node_bittorrent,node_ed2k,node_metalink,node_payload_files toneAmber
class node_rpc,node_media toneMint
class node_download_context,node_piece_storage,node_task_storage,node_session_storage,node_diagnostics,node_shared_util,node_message_catalog toneRose
class node_libcurl,node_libtorrent,node_media_libraries toneIndigo
```

## Components

### Engine and tasks

- [Engine executable](https://github.com/aninsomniacy/aria2-next/blob/main/src/main.cc): `src/main.cc`
- [Options](https://github.com/aninsomniacy/aria2-next/blob/main/src/option_processing.cc): `src/option_processing.cc`
- [Download engine](https://github.com/aninsomniacy/aria2-next/blob/main/src/DownloadEngine.cc): `src/DownloadEngine.cc`
- [Task management](https://github.com/aninsomniacy/aria2-next/blob/main/src/task/TaskManagerQueue.cc): `src/task/TaskManagerQueue.cc`
- [Download task](https://github.com/aninsomniacy/aria2-next/blob/main/src/RequestGroup.h): `src/RequestGroup.h`

### Transfer protocols

- [HTTP stream transfer](https://github.com/aninsomniacy/aria2-next/blob/main/src/stream/StreamStorage.cc): `src/stream/StreamStorage.cc`
- [Curl session](https://github.com/aninsomniacy/aria2-next/blob/main/src/CurlSession.h): `src/CurlSession.h`
- [BitTorrent](https://github.com/aninsomniacy/aria2-next/blob/main/src/bittorrent/BtSessionControl.cc): `src/bittorrent/BtSessionControl.cc`
- [ED2K](https://github.com/aninsomniacy/aria2-next/blob/main/src/ed2k/Ed2kCommandSupport.cc): `src/ed2k/Ed2kCommandSupport.cc`
- [Metalink](https://github.com/aninsomniacy/aria2-next/blob/main/src/MetalinkParserController.cc): `src/MetalinkParserController.cc`

### Interfaces and media

- [JSON-RPC](https://github.com/aninsomniacy/aria2-next/blob/main/src/rpc/TaskStatusMethods.cc): `src/rpc/TaskStatusMethods.cc`
- [HLS/DASH media](https://github.com/aninsomniacy/aria2-next/blob/main/src/media/MediaSession.cc): `src/media/MediaSession.cc`

### Payload and state

- [Download context](https://github.com/aninsomniacy/aria2-next/blob/main/src/DownloadContext.h): `src/DownloadContext.h`
- [Piece storage](https://github.com/aninsomniacy/aria2-next/blob/main/src/DefaultPieceStorage.cc): `src/DefaultPieceStorage.cc`
- [Task persistence](https://github.com/aninsomniacy/aria2-next/blob/main/src/task/TaskStorage.cc): `src/task/TaskStorage.cc`
- [Session state](https://github.com/aninsomniacy/aria2-next/blob/main/src/task/TaskManagerStorage.cc): `src/task/TaskManagerStorage.cc`
- [Logging](https://github.com/aninsomniacy/aria2-next/blob/main/src/Log.h): `src/Log.h`
- [Shared utilities](https://github.com/aninsomniacy/aria2-next/blob/main/src/a2functional.h): `src/a2functional.h`
- [Message catalog](https://github.com/aninsomniacy/aria2-next/blob/main/src/message.h): `src/message.h`

### Other components

- **CLI user**
- **RPC client**
- **libcurl**
- **libtorrent**
- **GPAC and FFmpeg**
- **Payload files**

## Connections

- CLI user → Engine executable: runs
- RPC client → JSON-RPC: calls methods
- Engine executable → Options: accepts options
- Engine executable → Download engine: starts engine
- Options → Task management: configures tasks
- Task management → Download task: manages tasks (evidence: `src/task/TaskManagerQueue.cc`)
- Download task → HTTP stream transfer: dispatches transfer (evidence: `src/RequestGroup.h`)
- HTTP stream transfer → Curl session: uses session (evidence: `src/stream/StreamStorage.cc`)
- HTTP stream transfer → libcurl: transfers via
- Download task → BitTorrent: supports transfer (evidence: `src/bittorrent/BtSessionControl.cc`)
- BitTorrent → libtorrent: uses native engine
- Download task → ED2K: supports transfer
- Download task → Metalink: supports metadata
- JSON-RPC → Task management: controls tasks
- Download task → HLS/DASH media: supports media tasks
- HLS/DASH media → libcurl: uses for transfers
- HLS/DASH media → GPAC and FFmpeg: uses libraries
- Download task → Download context: holds context (evidence: `src/RequestGroup.h`)
- Download context → Piece storage: tracks pieces (evidence: `src/DefaultPieceStorage.cc`)
- Piece storage → Payload files: writes payload
- Task management → Task persistence: stores task state (evidence: `src/task/TaskManagerQueue.cc`)
- Task persistence → Session state: persists session (evidence: `src/task/TaskManagerStorage.cc`)
- Download engine → Logging: logs events (evidence: `src/DownloadEngine.cc`)
