# anandprtp/antra architecture

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

- Interactive diagram: https://gitdiagram.com/anandprtp/antra
- Repository: https://github.com/anandprtp/antra

## Overview

Antra is a desktop music-library builder: users submit music links, fetch or resolve track metadata, acquire audio from available sources, then tag and organize files in a local library. The repository contains a Svelte/Wails desktop application alongside a Python service and download engine. The graph preserves the documented provider, format, lyrics, artwork, and library-management capabilities. Some backend and adapter implementations were not excerpted, so uncertain internal connections are omitted; documented workflow links cite the README.

Main entry points: [`antra/core/engine.py`](https://github.com/anandprtp/antra/blob/main/antra/core/engine.py) (Download engine), [`antra/core/service.py`](https://github.com/anandprtp/antra/blob/main/antra/core/service.py) (Application service), [`antra/core/models.py`](https://github.com/anandprtp/antra/blob/main/antra/core/models.py) (Track metadata), [`antra-wails/frontend/src/App.svelte`](https://github.com/anandprtp/antra/blob/main/antra-wails/frontend/src/App.svelte) (Desktop UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop interface"]
  node_ui["Desktop UI<br/>[App.svelte]"]
  node_wails["Wails bindings<br/>[App.js]"]
  node_desktop_backend["Desktop backend<br/>[app_backend.go]"]
end

subgraph group_entry["Application entry points"]
  node_python_cli["Python CLI<br/>[__main__.py]"]
  node_json_api["JSON interface<br/>[json_cli.py]"]
  node_service["Application service<br/>[service.py]"]
end

subgraph group_metadata["Link metadata"]
  node_spotify["Spotify client<br/>[spotify.py]"]
  node_spotify_library["Spotify library<br/>[spotify_library.py]"]
  node_apple_fetch["Apple metadata<br/>[apple_fetcher.py]"]
  node_amazon_fetch["Amazon metadata"]
  node_track_model["Track metadata<br/>[models.py]"]
end

subgraph group_acquisition["Audio acquisition"]
  node_resolver["Source resolver<br/>[resolver.py]"]
  node_source_adapters["Music source adapters"]
  node_download_engine["Download engine<br/>[engine.py]"]
end

subgraph group_library["Library output"]
  node_lyrics["Lyrics lookup<br/>[lyrics.py]"]
  node_tagging["Audio tagging<br/>[tagger.py]"]
  node_organizer["Library organizer<br/>[organizer.py]"]
  node_local_library[("Local music library")]
end

node_user(("Music library user"))

node_user -->|"submits links"| node_ui
node_ui -->|"calls backend"| node_wails
node_wails -.->|"invokes"| node_desktop_backend
node_user -.->|"runs CLI"| node_python_cli
node_python_cli -->|"uses service"| node_service
node_json_api -->|"uses service"| node_service
node_service -->|"starts downloads"| node_download_engine
node_service -->|"fetches Spotify data"| node_spotify
node_spotify -->|"creates metadata"| node_track_model
node_spotify_library -->|"creates metadata"| node_track_model
node_apple_fetch -->|"creates metadata"| node_track_model
node_amazon_fetch -->|"creates metadata"| node_track_model
node_download_engine -->|"resolves tracks"| node_resolver
node_resolver -->|"searches sources"| node_source_adapters
node_download_engine -->|"downloads audio"| node_source_adapters
node_download_engine -->|"fetches lyrics"| node_lyrics
node_download_engine -->|"tags audio"| node_tagging
node_download_engine -->|"organizes files"| node_organizer
node_organizer -->|"writes files"| node_local_library

click node_ui "https://github.com/anandprtp/antra/blob/main/antra-wails/frontend/src/App.svelte"
click node_wails "https://github.com/anandprtp/antra/blob/main/antra-wails/frontend/wailsjs/go/main/App.js"
click node_desktop_backend "https://github.com/anandprtp/antra/blob/main/antra-wails/app_backend.go"
click node_python_cli "https://github.com/anandprtp/antra/blob/main/antra/__main__.py"
click node_json_api "https://github.com/anandprtp/antra/blob/main/antra/json_cli.py"
click node_service "https://github.com/anandprtp/antra/blob/main/antra/core/service.py"
click node_spotify "https://github.com/anandprtp/antra/blob/main/antra/core/spotify.py"
click node_spotify_library "https://github.com/anandprtp/antra/blob/main/antra/core/spotify_library.py"
click node_apple_fetch "https://github.com/anandprtp/antra/blob/main/antra/core/apple_fetcher.py"
click node_amazon_fetch "https://github.com/anandprtp/antra/blob/main/antra/core/amazon_music_fetcher.py"
click node_track_model "https://github.com/anandprtp/antra/blob/main/antra/core/models.py"
click node_resolver "https://github.com/anandprtp/antra/blob/main/antra/core/resolver.py"
click node_source_adapters "https://github.com/anandprtp/antra/tree/main/antra/sources"
click node_download_engine "https://github.com/anandprtp/antra/blob/main/antra/core/engine.py"
click node_lyrics "https://github.com/anandprtp/antra/blob/main/antra/utils/lyrics.py"
click node_tagging "https://github.com/anandprtp/antra/blob/main/antra/utils/tagger.py"
click node_organizer "https://github.com/anandprtp/antra/blob/main/antra/utils/organizer.py"

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_ui,node_wails,node_desktop_backend,node_user toneBlue
class node_python_cli,node_json_api,node_service toneAmber
class node_spotify,node_spotify_library,node_apple_fetch,node_amazon_fetch,node_track_model toneMint
class node_resolver,node_source_adapters,node_download_engine toneRose
class node_lyrics,node_tagging,node_organizer,node_local_library toneIndigo
```

## Components

### Desktop interface

- [Desktop UI](https://github.com/anandprtp/antra/blob/main/antra-wails/frontend/src/App.svelte): `antra-wails/frontend/src/App.svelte`
- [Wails bindings](https://github.com/anandprtp/antra/blob/main/antra-wails/frontend/wailsjs/go/main/App.js): `antra-wails/frontend/wailsjs/go/main/App.js`
- [Desktop backend](https://github.com/anandprtp/antra/blob/main/antra-wails/app_backend.go): `antra-wails/app_backend.go`

### Application entry points

- [Python CLI](https://github.com/anandprtp/antra/blob/main/antra/__main__.py): `antra/__main__.py`
- [JSON interface](https://github.com/anandprtp/antra/blob/main/antra/json_cli.py): `antra/json_cli.py`
- [Application service](https://github.com/anandprtp/antra/blob/main/antra/core/service.py): `antra/core/service.py`

### Link metadata

- [Spotify client](https://github.com/anandprtp/antra/blob/main/antra/core/spotify.py): `antra/core/spotify.py`
- [Spotify library](https://github.com/anandprtp/antra/blob/main/antra/core/spotify_library.py): `antra/core/spotify_library.py`
- [Apple metadata](https://github.com/anandprtp/antra/blob/main/antra/core/apple_fetcher.py): `antra/core/apple_fetcher.py`
- [Amazon metadata](https://github.com/anandprtp/antra/blob/main/antra/core/amazon_music_fetcher.py): `antra/core/amazon_music_fetcher.py`
- [Track metadata](https://github.com/anandprtp/antra/blob/main/antra/core/models.py): `antra/core/models.py`

### Audio acquisition

- [Source resolver](https://github.com/anandprtp/antra/blob/main/antra/core/resolver.py): `antra/core/resolver.py`
- [Music source adapters](https://github.com/anandprtp/antra/tree/main/antra/sources): `antra/sources`
- [Download engine](https://github.com/anandprtp/antra/blob/main/antra/core/engine.py): `antra/core/engine.py`

### Library output

- [Lyrics lookup](https://github.com/anandprtp/antra/blob/main/antra/utils/lyrics.py): `antra/utils/lyrics.py`
- [Audio tagging](https://github.com/anandprtp/antra/blob/main/antra/utils/tagger.py): `antra/utils/tagger.py`
- [Library organizer](https://github.com/anandprtp/antra/blob/main/antra/utils/organizer.py): `antra/utils/organizer.py`
- **Local music library**

### Other components

- **Music library user**

## Connections

- Music library user → Desktop UI: submits links
- Desktop UI → Wails bindings: calls backend (evidence: `antra-wails/frontend/src/App.svelte`)
- Wails bindings → Desktop backend: invokes
- Music library user → Python CLI: runs CLI
- Python CLI → Application service: uses service (evidence: `antra/__main__.py`)
- JSON interface → Application service: uses service (evidence: `antra/json_cli.py`)
- Application service → Download engine: starts downloads (evidence: `antra/core/service.py`)
- Application service → Spotify client: fetches Spotify data (evidence: `antra/core/service.py`)
- Spotify client → Track metadata: creates metadata (evidence: `antra/core/spotify.py`)
- Spotify library → Track metadata: creates metadata (evidence: `antra/core/spotify_library.py`)
- Apple metadata → Track metadata: creates metadata (evidence: `antra/core/apple_fetcher.py`)
- Amazon metadata → Track metadata: creates metadata (evidence: `antra/core/amazon_music_fetcher.py`)
- Download engine → Source resolver: resolves tracks (evidence: `antra/core/engine.py`)
- Source resolver → Music source adapters: searches sources (evidence: `antra/core/resolver.py`)
- Download engine → Music source adapters: downloads audio (evidence: `antra/core/engine.py`)
- Download engine → Lyrics lookup: fetches lyrics (evidence: `antra/core/engine.py`)
- Download engine → Audio tagging: tags audio (evidence: `antra/core/engine.py`)
- Download engine → Library organizer: organizes files (evidence: `antra/core/engine.py`)
- Library organizer → Local music library: writes files
