# m-obeid/mixtapes architecture

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

- Interactive diagram: https://gitdiagram.com/m-obeid/mixtapes
- Repository: https://github.com/m-obeid/mixtapes

## Overview

Mixtapes is a desktop YouTube Music player. Listeners browse or search music, select tracks, and control playback; the app also supports account-backed library and playlist operations, local playlists and likes, downloads, lyrics, and system media controls. The graph shows the main UI, network, playback, and offline-data layers, plus those documented feature branches. Some connections come from source-index references rather than inspected call sites, so only excerpted or README-supported relationships are drawn; unsampled internals are not expanded.

Main entry points: [`src/ui/context.rs`](https://github.com/m-obeid/mixtapes/blob/main/src/ui/context.rs) (UI context), [`src/player.rs`](https://github.com/m-obeid/mixtapes/blob/main/src/player.rs) (Playback controller), [`src/net/search.rs`](https://github.com/m-obeid/mixtapes/blob/main/src/net/search.rs) (Music search), [`src/net/browse.rs`](https://github.com/m-obeid/mixtapes/blob/main/src/net/browse.rs) (Browse results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_entry["App startup<br/>[main.rs]"]
  node_window["App window<br/>[window.rs]"]
  node_ui["GTK interface<br/>[mod.rs]"]
  node_context["UI context<br/>[context.rs]"]
  node_playlist_page["Playlist page<br/>[playlist.rs]"]
end

subgraph group_music["Music services"]
  node_net["Network runtime<br/>[mod.rs]"]
  node_ytmusic["YouTube Music session<br/>[ytmusic.rs]"]
  node_search["Music search<br/>[search.rs]"]
  node_browse["Browse results<br/>[browse.rs]"]
  node_items["Item parsing<br/>[items.rs]"]
  node_playlists["Playlist operations<br/>[playlists.rs]"]
end

subgraph group_playback["Playback"]
  node_player["Playback controller<br/>[player.rs]"]
  node_queue["Play queue<br/>[queue.rs]"]
  node_audio["Audio engine<br/>[mod.rs]"]
end

subgraph group_offline["Offline features"]
  node_downloads["Offline downloads<br/>[mod.rs]"]
  node_download_store[("Download catalog<br/>[store.rs]")]
  node_local_library[("Local library<br/>[local_library.rs]")]
  node_lyrics["Lyrics service<br/>[mod.rs]"]
  node_lyric_providers["Lyrics providers<br/>[mod.rs]"]
  node_lyric_cache[("Lyrics cache<br/>[cache.rs]")]
end

node_listener(("Listener"))

node_listener -->|"uses"| node_window
node_entry -->|"creates"| node_window
node_window -.->|"hosts"| node_ui
node_ui -->|"shares context"| node_context
node_context -->|"provides"| node_player
node_context -->|"provides"| node_net
node_context -->|"provides"| node_downloads
node_context -->|"provides"| node_lyrics
node_context -->|"provides"| node_local_library
node_playlist_page -->|"uses"| node_playlists
node_net -->|"builds client"| node_ytmusic
node_search -->|"uses client"| node_ytmusic
node_search -->|"uses"| node_browse
node_search -->|"parses with"| node_items
node_browse -->|"uses client"| node_ytmusic
node_browse -->|"parses with"| node_items
node_player -->|"drives"| node_audio
node_player -->|"manages"| node_queue
node_player -->|"requests streams"| node_net
node_downloads -->|"records files"| node_download_store
node_downloads -->|"updates library"| node_local_library
node_lyrics -->|"queries"| node_lyric_providers
node_lyrics -->|"reads and writes"| node_lyric_cache

click node_entry "https://github.com/m-obeid/mixtapes/blob/main/src/main.rs"
click node_window "https://github.com/m-obeid/mixtapes/blob/main/src/ui/window.rs"
click node_ui "https://github.com/m-obeid/mixtapes/blob/main/src/ui/mod.rs"
click node_context "https://github.com/m-obeid/mixtapes/blob/main/src/ui/context.rs"
click node_playlist_page "https://github.com/m-obeid/mixtapes/blob/main/src/ui/pages/playlist.rs"
click node_net "https://github.com/m-obeid/mixtapes/blob/main/src/net/mod.rs"
click node_ytmusic "https://github.com/m-obeid/mixtapes/blob/main/src/net/ytmusic.rs"
click node_search "https://github.com/m-obeid/mixtapes/blob/main/src/net/search.rs"
click node_browse "https://github.com/m-obeid/mixtapes/blob/main/src/net/browse.rs"
click node_items "https://github.com/m-obeid/mixtapes/blob/main/src/net/items.rs"
click node_playlists "https://github.com/m-obeid/mixtapes/blob/main/src/net/playlists.rs"
click node_player "https://github.com/m-obeid/mixtapes/blob/main/src/player.rs"
click node_queue "https://github.com/m-obeid/mixtapes/blob/main/src/queue.rs"
click node_audio "https://github.com/m-obeid/mixtapes/blob/main/src/audio/mod.rs"
click node_downloads "https://github.com/m-obeid/mixtapes/blob/main/src/downloads/mod.rs"
click node_download_store "https://github.com/m-obeid/mixtapes/blob/main/src/downloads/store.rs"
click node_local_library "https://github.com/m-obeid/mixtapes/blob/main/src/local_library.rs"
click node_lyrics "https://github.com/m-obeid/mixtapes/blob/main/src/lyrics/mod.rs"
click node_lyric_providers "https://github.com/m-obeid/mixtapes/blob/main/src/lyrics/providers/mod.rs"
click node_lyric_cache "https://github.com/m-obeid/mixtapes/blob/main/src/lyrics/cache.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_entry,node_window,node_ui,node_context,node_playlist_page toneBlue
class node_net,node_ytmusic,node_search,node_browse,node_items,node_playlists toneAmber
class node_player,node_queue,node_audio toneMint
class node_downloads,node_download_store,node_local_library,node_lyrics,node_lyric_providers,node_lyric_cache toneRose
class node_listener toneIndigo
```

## Components

### App and UI

- [App startup](https://github.com/m-obeid/mixtapes/blob/main/src/main.rs): `src/main.rs`
- [App window](https://github.com/m-obeid/mixtapes/blob/main/src/ui/window.rs): `src/ui/window.rs`
- [GTK interface](https://github.com/m-obeid/mixtapes/blob/main/src/ui/mod.rs): `src/ui/mod.rs`
- [UI context](https://github.com/m-obeid/mixtapes/blob/main/src/ui/context.rs): `src/ui/context.rs`
- [Playlist page](https://github.com/m-obeid/mixtapes/blob/main/src/ui/pages/playlist.rs): `src/ui/pages/playlist.rs`

### Music services

- [Network runtime](https://github.com/m-obeid/mixtapes/blob/main/src/net/mod.rs): `src/net/mod.rs`
- [YouTube Music session](https://github.com/m-obeid/mixtapes/blob/main/src/net/ytmusic.rs): `src/net/ytmusic.rs`
- [Music search](https://github.com/m-obeid/mixtapes/blob/main/src/net/search.rs): `src/net/search.rs`
- [Browse results](https://github.com/m-obeid/mixtapes/blob/main/src/net/browse.rs): `src/net/browse.rs`
- [Item parsing](https://github.com/m-obeid/mixtapes/blob/main/src/net/items.rs): `src/net/items.rs`
- [Playlist operations](https://github.com/m-obeid/mixtapes/blob/main/src/net/playlists.rs): `src/net/playlists.rs`

### Playback

- [Playback controller](https://github.com/m-obeid/mixtapes/blob/main/src/player.rs): `src/player.rs`
- [Play queue](https://github.com/m-obeid/mixtapes/blob/main/src/queue.rs): `src/queue.rs`
- [Audio engine](https://github.com/m-obeid/mixtapes/blob/main/src/audio/mod.rs): `src/audio/mod.rs`

### Offline features

- [Offline downloads](https://github.com/m-obeid/mixtapes/blob/main/src/downloads/mod.rs): `src/downloads/mod.rs`
- [Download catalog](https://github.com/m-obeid/mixtapes/blob/main/src/downloads/store.rs): `src/downloads/store.rs`
- [Local library](https://github.com/m-obeid/mixtapes/blob/main/src/local_library.rs): `src/local_library.rs`
- [Lyrics service](https://github.com/m-obeid/mixtapes/blob/main/src/lyrics/mod.rs): `src/lyrics/mod.rs`
- [Lyrics providers](https://github.com/m-obeid/mixtapes/blob/main/src/lyrics/providers/mod.rs): `src/lyrics/providers/mod.rs`
- [Lyrics cache](https://github.com/m-obeid/mixtapes/blob/main/src/lyrics/cache.rs): `src/lyrics/cache.rs`

### Other components

- **Listener**

## Connections

- Listener → App window: uses (evidence: `README.md`)
- App startup → App window: creates (evidence: `src/main.rs`)
- App window → GTK interface: hosts (evidence: `src/ui/mod.rs`)
- GTK interface → UI context: shares context (evidence: `src/ui/mod.rs`)
- UI context → Playback controller: provides (evidence: `src/ui/context.rs`)
- UI context → Network runtime: provides (evidence: `src/ui/context.rs`)
- UI context → Offline downloads: provides (evidence: `src/ui/context.rs`)
- UI context → Lyrics service: provides (evidence: `src/ui/context.rs`)
- UI context → Local library: provides (evidence: `src/ui/context.rs`)
- Playlist page → Playlist operations: uses (evidence: `src/ui/pages/playlist.rs`)
- Network runtime → YouTube Music session: builds client (evidence: `src/net/mod.rs`)
- Music search → YouTube Music session: uses client (evidence: `src/net/search.rs`)
- Music search → Browse results: uses (evidence: `src/net/search.rs`)
- Music search → Item parsing: parses with (evidence: `src/net/search.rs`)
- Browse results → YouTube Music session: uses client (evidence: `src/net/browse.rs`)
- Browse results → Item parsing: parses with (evidence: `src/net/browse.rs`)
- Playback controller → Audio engine: drives (evidence: `src/player.rs`)
- Playback controller → Play queue: manages (evidence: `src/player.rs`)
- Playback controller → Network runtime: requests streams (evidence: `src/player.rs`)
- Offline downloads → Download catalog: records files (evidence: `src/downloads/mod.rs`)
- Offline downloads → Local library: updates library (evidence: `src/downloads/mod.rs`)
- Lyrics service → Lyrics providers: queries (evidence: `src/lyrics/mod.rs`)
- Lyrics service → Lyrics cache: reads and writes (evidence: `src/lyrics/mod.rs`)
