# rudra00434/soulplayer architecture

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

- Interactive diagram: https://gitdiagram.com/rudra00434/soulplayer
- Repository: https://github.com/rudra00434/soulplayer

## Overview

SoulPlayer is a Django music-streaming application. Users browse or search a catalog, select music for playback, and can build playlists, track listening activity, and receive recommendations. Django views own the documented request flow and connect user-facing features to the catalog and services. Separate branches support radio, podcasts, events, and real-time listening rooms and collaborative playlists. The graph reflects README statements and sampled source references; several feature details are documented but their implementation was not sampled.

Main entry points: [`SPOTIFY/music/views.py`](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py) (Music views), [`SPOTIFY/music/models.py`](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/models.py) (Music data), [`SPOTIFY/music/ml_Pipeline/hybrid.py`](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/hybrid.py) (Hybrid recommender), [`SPOTIFY/music/consumers.py`](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/consumers.py) (Playlist updates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_django["Django request routing<br/>[urls.py]"]
  node_views["Music views<br/>[views.py]"]
  node_templates["Music pages"]
  node_forms["Music forms<br/>[forms.py]"]
end

subgraph group_catalog["Music catalog"]
  node_catalogdb[("Music data<br/>[models.py]")]
  node_playback["Playback tracking<br/>[views.py]"]
  node_search["Catalog search<br/>[views.py]"]
  node_radio["Radio discovery<br/>[radio_api.py]"]
  node_podcasts["Podcast discovery<br/>[views.py]"]
end

subgraph group_personal["Personalization"]
  node_recommendations["Recommendations<br/>[recommendation.py]"]
  node_preprocess["Listening data prep"]
  node_content["Content filtering<br/>[content_based.py]"]
  node_collaborative["Collaborative filtering"]
  node_hybrid["Hybrid recommender<br/>[hybrid.py]"]
end

subgraph group_realtime["Live collaboration"]
  node_rooms["Listening rooms<br/>[consumers.py]"]
  node_playlistlive["Playlist updates<br/>[consumers.py]"]
  node_wsroutes["WebSocket routing<br/>[routing.py]"]
end

subgraph group_integrations["External services"]
  node_jiosaavn["JioSaavn service<br/>[jiosavan.py]"]
  node_ticketmaster["Concert discovery"]
end

node_listener(("Listener"))
node_ticketmasterapi{{"Ticketmaster API"}}
node_youtube{{"YouTube Data API"}}
node_browser(("Browser"))

node_listener -->|"uses"| node_browser
node_browser -->|"requests pages"| node_django
node_django -->|"routes requests"| node_views
node_views -->|"renders pages"| node_templates
node_views -->|"uses forms"| node_forms
node_views -->|"queries catalog"| node_catalogdb
node_views -->|"records plays"| node_playback
node_playback -->|"updates history"| node_catalogdb
node_views -->|"handles search"| node_search
node_search -->|"searches remotely"| node_jiosaavn
node_views -.->|"gets radio data"| node_radio
node_views -->|"finds podcasts"| node_podcasts
node_podcasts -->|"queries videos"| node_youtube
node_views -->|"requests suggestions"| node_recommendations
node_recommendations -->|"generates results"| node_hybrid
node_hybrid -->|"combines scores"| node_content
node_hybrid -->|"combines scores"| node_collaborative
node_content -->|"loads features"| node_preprocess
node_collaborative -->|"loads interactions"| node_preprocess
node_preprocess -->|"reads listening data"| node_catalogdb
node_views -->|"gets event listings"| node_ticketmaster
node_ticketmaster -.->|"fetches events"| node_ticketmasterapi
node_browser -->|"opens WebSocket"| node_wsroutes
node_wsroutes -->|"routes room sockets"| node_rooms
node_wsroutes -->|"routes playlist sockets"| node_playlistlive
node_rooms -.->|"syncs room state"| node_catalogdb
node_playlistlive -.->|"broadcasts playlist changes"| node_catalogdb
node_playlistlive -->|"pushes updates"| node_browser

click node_django "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/urls.py"
click node_views "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py"
click node_templates "https://github.com/rudra00434/soulplayer/tree/main/SPOTIFY/template"
click node_forms "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/forms.py"
click node_catalogdb "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/models.py"
click node_playback "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py"
click node_search "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py"
click node_jiosaavn "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/jiosavan.py"
click node_radio "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/radio_api.py"
click node_podcasts "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py"
click node_recommendations "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/recommendation.py"
click node_preprocess "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/data_preprocessing.py"
click node_content "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/content_based.py"
click node_collaborative "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/collaborative_filtering.py"
click node_hybrid "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/hybrid.py"
click node_rooms "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/consumers.py"
click node_playlistlive "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/consumers.py"
click node_wsroutes "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/routing.py"
click node_ticketmaster "https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ticketmaster_api.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_django,node_views,node_templates,node_forms,node_browser toneBlue
class node_catalogdb,node_playback,node_search,node_radio,node_podcasts toneAmber
class node_recommendations,node_preprocess,node_content,node_collaborative,node_hybrid,node_ticketmasterapi,node_youtube toneMint
class node_rooms,node_playlistlive,node_wsroutes toneRose
class node_jiosaavn,node_ticketmaster,node_listener toneIndigo
```

## Components

### Web experience

- [Django request routing](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/urls.py): `SPOTIFY/music/urls.py`
- [Music views](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py): `SPOTIFY/music/views.py`
- [Music pages](https://github.com/rudra00434/soulplayer/tree/main/SPOTIFY/template): `SPOTIFY/template`
- [Music forms](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/forms.py): `SPOTIFY/music/forms.py`

### Music catalog

- [Music data](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/models.py): `SPOTIFY/music/models.py`
- [Playback tracking](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py): `SPOTIFY/music/views.py`
- [Catalog search](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py): `SPOTIFY/music/views.py`
- [Radio discovery](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/radio_api.py): `SPOTIFY/music/radio_api.py`
- [Podcast discovery](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/views.py): `SPOTIFY/music/views.py`

### Personalization

- [Recommendations](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/recommendation.py): `SPOTIFY/music/recommendation.py`
- [Listening data prep](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/data_preprocessing.py): `SPOTIFY/music/ml_Pipeline/data_preprocessing.py`
- [Content filtering](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/content_based.py): `SPOTIFY/music/ml_Pipeline/content_based.py`
- [Collaborative filtering](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/collaborative_filtering.py): `SPOTIFY/music/ml_Pipeline/collaborative_filtering.py`
- [Hybrid recommender](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ml_Pipeline/hybrid.py): `SPOTIFY/music/ml_Pipeline/hybrid.py`

### Live collaboration

- [Listening rooms](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/consumers.py): `SPOTIFY/music/consumers.py`
- [Playlist updates](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/consumers.py): `SPOTIFY/music/consumers.py`
- [WebSocket routing](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/routing.py): `SPOTIFY/music/routing.py`

### External services

- [JioSaavn service](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/jiosavan.py): `SPOTIFY/music/jiosavan.py`
- [Concert discovery](https://github.com/rudra00434/soulplayer/blob/main/SPOTIFY/music/ticketmaster_api.py): `SPOTIFY/music/ticketmaster_api.py`

### Other components

- **Listener**
- **Ticketmaster API**
- **YouTube Data API**
- **Browser**

## Connections

- Listener → Browser: uses (evidence: `README.md`)
- Browser → Django request routing: requests pages (evidence: `README.md`)
- Django request routing → Music views: routes requests (evidence: `SPOTIFY/music/urls.py`)
- Music views → Music pages: renders pages (evidence: `README.md`)
- Music views → Music forms: uses forms (evidence: `SPOTIFY/music/views.py`)
- Music views → Music data: queries catalog (evidence: `SPOTIFY/music/views.py`)
- Music views → Playback tracking: records plays (evidence: `README.md`)
- Playback tracking → Music data: updates history (evidence: `README.md`)
- Music views → Catalog search: handles search (evidence: `SPOTIFY/music/views.py`)
- Catalog search → JioSaavn service: searches remotely (evidence: `SPOTIFY/music/views.py`)
- Music views → Radio discovery: gets radio data (evidence: `SPOTIFY/music/views.py`)
- Music views → Podcast discovery: finds podcasts (evidence: `SPOTIFY/music/views.py`)
- Podcast discovery → YouTube Data API: queries videos (evidence: `README.md`)
- Music views → Recommendations: requests suggestions (evidence: `SPOTIFY/music/views.py`)
- Recommendations → Hybrid recommender: generates results (evidence: `SPOTIFY/music/recommendation.py`)
- Hybrid recommender → Content filtering: combines scores (evidence: `SPOTIFY/music/ml_Pipeline/hybrid.py`)
- Hybrid recommender → Collaborative filtering: combines scores (evidence: `SPOTIFY/music/ml_Pipeline/hybrid.py`)
- Content filtering → Listening data prep: loads features (evidence: `SPOTIFY/music/ml_Pipeline/content_based.py`)
- Collaborative filtering → Listening data prep: loads interactions (evidence: `SPOTIFY/music/ml_Pipeline/collaborative_filtering.py`)
- Listening data prep → Music data: reads listening data (evidence: `SPOTIFY/music/ml_Pipeline/data_preprocessing.py`)
- Music views → Concert discovery: gets event listings (evidence: `SPOTIFY/music/views.py`)
- Concert discovery → Ticketmaster API: fetches events
- Browser → WebSocket routing: opens WebSocket (evidence: `README.md`)
- WebSocket routing → Listening rooms: routes room sockets (evidence: `SPOTIFY/music/routing.py`)
- WebSocket routing → Playlist updates: routes playlist sockets (evidence: `SPOTIFY/music/routing.py`)
- Listening rooms → Music data: syncs room state
- Playlist updates → Music data: broadcasts playlist changes (evidence: `README.md`)
- Playlist updates → Browser: pushes updates (evidence: `README.md`)
