# digimezzo/dopamine architecture

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

## Overview

Dopamine is a cross-platform Electron music player. Its user-facing purpose is to organize a music collection and play tracks; the tree shows distinct collection indexing, library/data, playback and playlist, and supporting discovery/presentation capabilities. The renderer’s startup component explicitly initializes several application services. Source excerpts are limited, so other subsystem relationships are not inferred from filenames or imports alone.

Main entry points: [`src/app/app.component.ts`](https://github.com/digimezzo/dopamine/blob/master/src/app/app.component.ts) (Application startup), [`src/app/services/navigation/navigation.service.ts`](https://github.com/digimezzo/dopamine/blob/master/src/app/services/navigation/navigation.service.ts) (Navigation service), [`src/app/services/rating-backup/rating-backup.service.ts`](https://github.com/digimezzo/dopamine/blob/master/src/app/services/rating-backup/rating-backup.service.ts) (Rating backup), [`src/app/services/scrobbling/scrobbling.service.ts`](https://github.com/digimezzo/dopamine/blob/master/src/app/services/scrobbling/scrobbling.service.ts) (Scrobbling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_renderer["Renderer and navigation"]
  node_app["Application startup<br/>[app.component.ts]"]
  node_collection_ui["Collection browsing"]
  node_navigation["Navigation service"]
end

subgraph group_library["Library and indexing"]
  node_indexing["Collection indexing"]
  node_worker_indexing["Background indexing"]
  node_library_data[("Library database")]
  node_repositories["Library repositories"]
  node_track_model["Track model<br/>[track-model.ts]"]
end

subgraph group_listening["Playback and playlists"]
  node_playback["Audio playback"]
  node_playlist["Playlists"]
  node_playlist_session["Playlist sessions"]
  node_ratings["Rating backup"]
end

subgraph group_integrations["Metadata and integrations"]
  node_lyrics["Lyrics"]
  node_scrobbling["Scrobbling"]
  node_online_apis["Music information APIs"]
end

subgraph group_desktop["Desktop runtime"]
  node_media_session["Media session"]
  node_electron_main["Electron main process<br/>[main.ts]"]
  node_settings[("Application settings<br/>[settings-store.ts]")]
end

node_user(("Music listener"))

node_app -->|"navigates to loading"| node_navigation
node_app -->|"initializes"| node_media_session
node_app -->|"initializes"| node_scrobbling
node_app -->|"creates initial backup"| node_ratings
node_user -->|"uses player"| node_app

click node_app "https://github.com/digimezzo/dopamine/blob/master/src/app/app.component.ts"
click node_collection_ui "https://github.com/digimezzo/dopamine/tree/master/src/app/ui/components/collection"
click node_navigation "https://github.com/digimezzo/dopamine/blob/master/src/app/services/navigation/navigation.service.ts"
click node_indexing "https://github.com/digimezzo/dopamine/tree/master/src/app/services/indexing"
click node_worker_indexing "https://github.com/digimezzo/dopamine/tree/master/main/background-work/indexing"
click node_library_data "https://github.com/digimezzo/dopamine/blob/master/src/app/data/database-factory.ts"
click node_repositories "https://github.com/digimezzo/dopamine/tree/master/src/app/data/repositories"
click node_track_model "https://github.com/digimezzo/dopamine/blob/master/src/app/services/track/track-model.ts"
click node_playback "https://github.com/digimezzo/dopamine/blob/master/src/app/services/playback/playback.service.ts"
click node_playlist "https://github.com/digimezzo/dopamine/blob/master/src/app/services/playlist/playlist.service.base.ts"
click node_playlist_session "https://github.com/digimezzo/dopamine/blob/master/src/app/services/playlist-session/playlist-session.ts"
click node_ratings "https://github.com/digimezzo/dopamine/blob/master/src/app/services/rating-backup/rating-backup.service.ts"
click node_lyrics "https://github.com/digimezzo/dopamine/tree/master/src/app/services/lyrics"
click node_scrobbling "https://github.com/digimezzo/dopamine/blob/master/src/app/services/scrobbling/scrobbling.service.ts"
click node_online_apis "https://github.com/digimezzo/dopamine/tree/master/src/app/common/api"
click node_media_session "https://github.com/digimezzo/dopamine/blob/master/src/app/services/media-session/media-session.service.ts"
click node_electron_main "https://github.com/digimezzo/dopamine/blob/master/main.ts"
click node_settings "https://github.com/digimezzo/dopamine/blob/master/main/common/settings/settings-store.ts"

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_app,node_collection_ui,node_navigation toneBlue
class node_indexing,node_worker_indexing,node_library_data,node_repositories,node_track_model toneAmber
class node_playback,node_playlist,node_playlist_session,node_ratings toneMint
class node_lyrics,node_scrobbling,node_online_apis toneRose
class node_media_session,node_electron_main,node_settings,node_user toneIndigo
```

## Components

### Renderer and navigation

- [Application startup](https://github.com/digimezzo/dopamine/blob/master/src/app/app.component.ts): `src/app/app.component.ts`
- [Collection browsing](https://github.com/digimezzo/dopamine/tree/master/src/app/ui/components/collection): `src/app/ui/components/collection`
- [Navigation service](https://github.com/digimezzo/dopamine/blob/master/src/app/services/navigation/navigation.service.ts): `src/app/services/navigation/navigation.service.ts`

### Library and indexing

- [Collection indexing](https://github.com/digimezzo/dopamine/tree/master/src/app/services/indexing): `src/app/services/indexing`
- [Background indexing](https://github.com/digimezzo/dopamine/tree/master/main/background-work/indexing): `main/background-work/indexing`
- [Library database](https://github.com/digimezzo/dopamine/blob/master/src/app/data/database-factory.ts): `src/app/data/database-factory.ts`
- [Library repositories](https://github.com/digimezzo/dopamine/tree/master/src/app/data/repositories): `src/app/data/repositories`
- [Track model](https://github.com/digimezzo/dopamine/blob/master/src/app/services/track/track-model.ts): `src/app/services/track/track-model.ts`

### Playback and playlists

- [Audio playback](https://github.com/digimezzo/dopamine/blob/master/src/app/services/playback/playback.service.ts): `src/app/services/playback/playback.service.ts`
- [Playlists](https://github.com/digimezzo/dopamine/blob/master/src/app/services/playlist/playlist.service.base.ts): `src/app/services/playlist/playlist.service.base.ts`
- [Playlist sessions](https://github.com/digimezzo/dopamine/blob/master/src/app/services/playlist-session/playlist-session.ts): `src/app/services/playlist-session/playlist-session.ts`
- [Rating backup](https://github.com/digimezzo/dopamine/blob/master/src/app/services/rating-backup/rating-backup.service.ts): `src/app/services/rating-backup/rating-backup.service.ts`

### Metadata and integrations

- [Lyrics](https://github.com/digimezzo/dopamine/tree/master/src/app/services/lyrics): `src/app/services/lyrics`
- [Scrobbling](https://github.com/digimezzo/dopamine/blob/master/src/app/services/scrobbling/scrobbling.service.ts): `src/app/services/scrobbling/scrobbling.service.ts`
- [Music information APIs](https://github.com/digimezzo/dopamine/tree/master/src/app/common/api): `src/app/common/api`

### Desktop runtime

- [Media session](https://github.com/digimezzo/dopamine/blob/master/src/app/services/media-session/media-session.service.ts): `src/app/services/media-session/media-session.service.ts`
- [Electron main process](https://github.com/digimezzo/dopamine/blob/master/main.ts): `main.ts`
- [Application settings](https://github.com/digimezzo/dopamine/blob/master/main/common/settings/settings-store.ts): `main/common/settings/settings-store.ts`

### Other components

- **Music listener**

## Connections

- Application startup → Navigation service: navigates to loading (evidence: `src/app/app.component.ts`)
- Application startup → Media session: initializes (evidence: `src/app/app.component.ts`)
- Application startup → Scrobbling: initializes (evidence: `src/app/app.component.ts`)
- Application startup → Rating backup: creates initial backup (evidence: `src/app/app.component.ts`)
- Music listener → Application startup: uses player (evidence: `README.md`)
