# ahmed18032025/streamify architecture

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

- Interactive diagram: https://gitdiagram.com/ahmed18032025/streamify
- Repository: https://github.com/ahmed18032025/streamify

## Overview

Streamify provides a browser search interface backed by a Flask JioSaavn API. Users submit song names or JioSaavn links, choose a result/song/album/playlist/lyrics endpoint, and view returned metadata or lyrics. The API routes requests into search, ID resolution, and content retrieval; the client formats JSON for display. The sampled source shows these calls and formatting, while the README documents the broader user workflow. The UI/API connection is based on the documented setup and the client’s relative fetch; unsampled template behavior is not inferred.

Main entry points: [`JioSaavnAPI-master/app.py`](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/app.py) (HTTP routes), [`JioSaavnAPI-master/jiosaavn.py`](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py) (Song search), [`JioSaavnAPI-master/helper.py`](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/helper.py) (Content formatting), [`JioSaavnAPI-master/endpoints.py`](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/endpoints.py) (API endpoint config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser interface"]
  node_browser["Search interface<br/>[script.js]"]
  node_page["Search page<br/>[index.html]"]
end

subgraph group_api["Flask API"]
  node_routes["HTTP routes<br/>[app.py]"]
end

subgraph group_domain["Music data logic"]
  node_search["Song search<br/>[jiosaavn.py]"]
  node_song["Song details<br/>[jiosaavn.py]"]
  node_album["Album lookup<br/>[jiosaavn.py]"]
  node_playlist["Playlist lookup<br/>[jiosaavn.py]"]
  node_lyrics["Lyrics lookup<br/>[jiosaavn.py]"]
  node_result["Link dispatcher<br/>[app.py]"]
  node_format["Content formatting<br/>[helper.py]"]
end

subgraph group_integration["JioSaavn integration"]
  node_endpoint_config["API endpoint config<br/>[endpoints.py]"]
end

node_user(("Listener"))
node_saavn["JioSaavn service"]

node_user -->|"enters query"| node_browser
node_browser -->|"fetches endpoint"| node_routes
node_routes -->|"renders page"| node_page
node_routes -->|"calls search"| node_search
node_routes -->|"gets song"| node_song
node_routes -->|"gets album"| node_album
node_routes -->|"gets playlist"| node_playlist
node_routes -->|"gets lyrics"| node_lyrics
node_routes -->|"dispatches link"| node_result
node_search -->|"resolves song link"| node_song
node_search -->|"formats details"| node_format
node_song -->|"formats song"| node_format
node_album -->|"formats album"| node_format
node_playlist -->|"formats playlist"| node_format
node_format -->|"fetches lyrics"| node_lyrics
node_search -->|"uses URLs"| node_endpoint_config
node_song -->|"uses URLs"| node_endpoint_config
node_album -->|"uses URLs"| node_endpoint_config
node_playlist -->|"uses URLs"| node_endpoint_config
node_lyrics -->|"uses URL"| node_endpoint_config
node_search -->|"requests data"| node_saavn
node_song -->|"requests data"| node_saavn
node_album -->|"requests data"| node_saavn
node_playlist -->|"requests data"| node_saavn
node_lyrics -->|"requests lyrics"| node_saavn

click node_browser "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/static/script.js"
click node_page "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/templates/index.html"
click node_routes "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/app.py"
click node_search "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py"
click node_song "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py"
click node_album "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py"
click node_playlist "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py"
click node_lyrics "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py"
click node_result "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/app.py"
click node_format "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/helper.py"
click node_endpoint_config "https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/endpoints.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_browser,node_page toneBlue
class node_routes toneAmber
class node_search,node_song,node_album,node_playlist,node_lyrics,node_result,node_format toneMint
class node_endpoint_config toneRose
class node_user,node_saavn toneIndigo
```

## Components

### Browser interface

- [Search interface](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/static/script.js): `JioSaavnAPI-master/static/script.js`
- [Search page](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/templates/index.html): `JioSaavnAPI-master/templates/index.html`

### Flask API

- [HTTP routes](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/app.py): `JioSaavnAPI-master/app.py`

### Music data logic

- [Song search](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py): `JioSaavnAPI-master/jiosaavn.py`
- [Song details](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py): `JioSaavnAPI-master/jiosaavn.py`
- [Album lookup](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py): `JioSaavnAPI-master/jiosaavn.py`
- [Playlist lookup](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py): `JioSaavnAPI-master/jiosaavn.py`
- [Lyrics lookup](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/jiosaavn.py): `JioSaavnAPI-master/jiosaavn.py`
- [Link dispatcher](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/app.py): `JioSaavnAPI-master/app.py`
- [Content formatting](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/helper.py): `JioSaavnAPI-master/helper.py`

### JioSaavn integration

- [API endpoint config](https://github.com/ahmed18032025/streamify/blob/main/JioSaavnAPI-master/endpoints.py): `JioSaavnAPI-master/endpoints.py`

### Other components

- **Listener**
- **JioSaavn service**

## Connections

- Listener → Search interface: enters query (evidence: `JioSaavnAPI-master/static/script.js`)
- Search interface → HTTP routes: fetches endpoint (evidence: `JioSaavnAPI-master/static/script.js`)
- HTTP routes → Search page: renders page (evidence: `JioSaavnAPI-master/app.py`)
- HTTP routes → Song search: calls search (evidence: `JioSaavnAPI-master/app.py`)
- HTTP routes → Song details: gets song (evidence: `JioSaavnAPI-master/app.py`)
- HTTP routes → Album lookup: gets album (evidence: `JioSaavnAPI-master/app.py`)
- HTTP routes → Playlist lookup: gets playlist (evidence: `JioSaavnAPI-master/app.py`)
- HTTP routes → Lyrics lookup: gets lyrics (evidence: `JioSaavnAPI-master/app.py`)
- HTTP routes → Link dispatcher: dispatches link (evidence: `JioSaavnAPI-master/app.py`)
- Song search → Song details: resolves song link (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Song search → Content formatting: formats details (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Song details → Content formatting: formats song (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Album lookup → Content formatting: formats album (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Playlist lookup → Content formatting: formats playlist (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Content formatting → Lyrics lookup: fetches lyrics (evidence: `JioSaavnAPI-master/helper.py`)
- Song search → API endpoint config: uses URLs (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Song details → API endpoint config: uses URLs (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Album lookup → API endpoint config: uses URLs (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Playlist lookup → API endpoint config: uses URLs (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Lyrics lookup → API endpoint config: uses URL (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Song search → JioSaavn service: requests data (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Song details → JioSaavn service: requests data (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Album lookup → JioSaavn service: requests data (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Playlist lookup → JioSaavn service: requests data (evidence: `JioSaavnAPI-master/jiosaavn.py`)
- Lyrics lookup → JioSaavn service: requests lyrics (evidence: `JioSaavnAPI-master/jiosaavn.py`)
