# sozercan/kaset architecture

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

## Overview

Kaset is a native macOS client for YouTube Music and YouTube. Users browse or search music and video, choose content, and play it through native player controls; they can also manage queues and their library. The app adds lyrics, equalization, podcasts, discovery, Apple Intelligence features, and macOS integrations. The graph groups these capabilities by product subsystem. Several internal connections are documented by the README or SOURCE INDEX; unsampled implementations limit confidence about finer call paths.

Main entry points: [`Sources/Kaset/Views`](https://github.com/sozercan/kaset/tree/main/Sources/Kaset/Views) (Music interface), [`Sources/Kaset/Views/YouTube`](https://github.com/sozercan/kaset/tree/main/Sources/Kaset/Views/YouTube) (YouTube interface), [`Sources/Kaset/Services/Player/PlayerService.swift`](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Player/PlayerService.swift) (Music playback), [`Sources/Kaset/ViewModels`](https://github.com/sozercan/kaset/tree/main/Sources/Kaset/ViewModels) (Screen state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and interface"]
  node_app_entry["App lifecycle<br/>[KasetApp.swift]"]
  node_music_ui["Music interface"]
  node_youtube_ui["YouTube interface"]
  node_viewmodels["Screen state"]
end

subgraph group_content["Content and discovery"]
  node_models["Music models<br/>[Song.swift]"]
  node_music_api["Music API client"]
  node_youtube_api["YouTube API client"]
  node_youtube(("YouTube services"))
  node_library[("Library and favorites")]
end

subgraph group_playback["Playback and audio"]
  node_player["Music playback"]
  node_youtube_player["Video playback"]
  node_queue["Queue management"]
  node_equalizer["System equalizer"]
  node_lyrics["Lyrics services"]
end

subgraph group_platform["Accounts and platform"]
  node_auth["Authentication<br/>[AuthService.swift]"]
  node_webkit["WebKit sessions"]
  node_settings[("Preferences")]
  node_extensions["Web extensions"]
  node_scrobbling["Scrobbling"]
end

subgraph group_intelligence["AI features"]
  node_ai["On-device AI"]
  node_ask_core["Ask parser"]
end

node_user(("User"))

node_user -->|"opens"| node_app_entry
node_app_entry -.->|"presents"| node_music_ui
node_user -->|"browses"| node_music_ui
node_user -->|"browses"| node_youtube_ui
node_music_ui -.->|"uses state"| node_viewmodels
node_youtube_ui -.->|"uses state"| node_viewmodels
node_viewmodels -.->|"requests content"| node_music_api
node_viewmodels -.->|"requests content"| node_youtube_api
node_music_api -->|"fetches content"| node_youtube
node_youtube_api -->|"fetches content"| node_youtube
node_music_api -->|"decodes"| node_models
node_music_ui -->|"manages library"| node_library
node_music_ui -->|"controls playback"| node_player
node_youtube_ui -->|"controls playback"| node_youtube_player
node_player -->|"manages queue"| node_queue
node_player -->|"processes audio"| node_equalizer
node_music_ui -->|"shows lyrics"| node_lyrics
node_auth -->|"restores cookies"| node_webkit
node_music_ui -->|"configures"| node_settings
node_webkit -->|"loads extensions"| node_extensions
node_player -.->|"tracks playback"| node_scrobbling
node_music_ui -->|"requests explanations"| node_ai
node_youtube_ui -.->|"parses Ask"| node_ask_core

click node_app_entry "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/KasetApp.swift"
click node_music_ui "https://github.com/sozercan/kaset/tree/main/Sources/Kaset/Views"
click node_youtube_ui "https://github.com/sozercan/kaset/tree/main/Sources/Kaset/Views/YouTube"
click node_viewmodels "https://github.com/sozercan/kaset/tree/main/Sources/Kaset/ViewModels"
click node_models "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Models/Song.swift"
click node_music_api "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/API/YTMusicClient.swift"
click node_youtube_api "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/API/YouTubeClient.swift"
click node_library "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/FavoritesManager.swift"
click node_player "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Player/PlayerService.swift"
click node_youtube_player "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Player/YouTubePlayerService.swift"
click node_queue "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Player/PlayerService%2BQueue.swift"
click node_equalizer "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Audio/EqualizerAudioEngine.swift"
click node_lyrics "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Lyrics/LyricsProvider.swift"
click node_auth "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Auth/AuthService.swift"
click node_webkit "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/WebKit/WebKitManager.swift"
click node_settings "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/SettingsManager.swift"
click node_extensions "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/ExtensionsManager.swift"
click node_scrobbling "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Scrobbling/ScrobblingCoordinator.swift"
click node_ai "https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/AI/FoundationModelsService.swift"
click node_ask_core "https://github.com/sozercan/kaset/blob/main/Sources/YouTubeAskCore/YouTubeAskParser.swift"

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_entry,node_music_ui,node_youtube_ui,node_viewmodels,node_user toneBlue
class node_models,node_music_api,node_youtube_api,node_youtube,node_library toneAmber
class node_player,node_youtube_player,node_queue,node_equalizer,node_lyrics toneMint
class node_auth,node_webkit,node_settings,node_extensions,node_scrobbling toneRose
class node_ai,node_ask_core toneIndigo
```

## Components

### App and interface

- [App lifecycle](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/KasetApp.swift): `Sources/Kaset/KasetApp.swift`
- [Music interface](https://github.com/sozercan/kaset/tree/main/Sources/Kaset/Views): `Sources/Kaset/Views`
- [YouTube interface](https://github.com/sozercan/kaset/tree/main/Sources/Kaset/Views/YouTube): `Sources/Kaset/Views/YouTube`
- [Screen state](https://github.com/sozercan/kaset/tree/main/Sources/Kaset/ViewModels): `Sources/Kaset/ViewModels`

### Content and discovery

- [Music models](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Models/Song.swift): `Sources/Kaset/Models/Song.swift`
- [Music API client](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/API/YTMusicClient.swift): `Sources/Kaset/Services/API/YTMusicClient.swift`
- [YouTube API client](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/API/YouTubeClient.swift): `Sources/Kaset/Services/API/YouTubeClient.swift`
- **YouTube services**
- [Library and favorites](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/FavoritesManager.swift): `Sources/Kaset/Services/FavoritesManager.swift`

### Playback and audio

- [Music playback](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Player/PlayerService.swift): `Sources/Kaset/Services/Player/PlayerService.swift`
- [Video playback](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Player/YouTubePlayerService.swift): `Sources/Kaset/Services/Player/YouTubePlayerService.swift`
- [Queue management](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Player/PlayerService%2BQueue.swift): `Sources/Kaset/Services/Player/PlayerService+Queue.swift`
- [System equalizer](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Audio/EqualizerAudioEngine.swift): `Sources/Kaset/Services/Audio/EqualizerAudioEngine.swift`
- [Lyrics services](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Lyrics/LyricsProvider.swift): `Sources/Kaset/Services/Lyrics/LyricsProvider.swift`

### Accounts and platform

- [Authentication](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Auth/AuthService.swift): `Sources/Kaset/Services/Auth/AuthService.swift`
- [WebKit sessions](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/WebKit/WebKitManager.swift): `Sources/Kaset/Services/WebKit/WebKitManager.swift`
- [Preferences](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/SettingsManager.swift): `Sources/Kaset/Services/SettingsManager.swift`
- [Web extensions](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/ExtensionsManager.swift): `Sources/Kaset/Services/ExtensionsManager.swift`
- [Scrobbling](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/Scrobbling/ScrobblingCoordinator.swift): `Sources/Kaset/Services/Scrobbling/ScrobblingCoordinator.swift`

### AI features

- [On-device AI](https://github.com/sozercan/kaset/blob/main/Sources/Kaset/Services/AI/FoundationModelsService.swift): `Sources/Kaset/Services/AI/FoundationModelsService.swift`
- [Ask parser](https://github.com/sozercan/kaset/blob/main/Sources/YouTubeAskCore/YouTubeAskParser.swift): `Sources/YouTubeAskCore/YouTubeAskParser.swift`

### Other components

- **User**

## Connections

- User → App lifecycle: opens (evidence: `README.md`)
- App lifecycle → Music interface: presents
- User → Music interface: browses (evidence: `README.md`)
- User → YouTube interface: browses (evidence: `README.md`)
- Music interface → Screen state: uses state
- YouTube interface → Screen state: uses state
- Screen state → Music API client: requests content
- Screen state → YouTube API client: requests content
- Music API client → YouTube services: fetches content (evidence: `README.md`)
- YouTube API client → YouTube services: fetches content (evidence: `README.md`)
- Music API client → Music models: decodes (evidence: `Sources/APIExplorer/main.swift`)
- Music interface → Library and favorites: manages library (evidence: `README.md`)
- Music interface → Music playback: controls playback (evidence: `README.md`)
- YouTube interface → Video playback: controls playback (evidence: `README.md`)
- Music playback → Queue management: manages queue (evidence: `README.md`)
- Music playback → System equalizer: processes audio (evidence: `README.md`)
- Music interface → Lyrics services: shows lyrics (evidence: `README.md`)
- Authentication → WebKit sessions: restores cookies (evidence: `Sources/Kaset/Services/Auth/AuthService.swift`)
- Music interface → Preferences: configures (evidence: `README.md`)
- WebKit sessions → Web extensions: loads extensions (evidence: `Sources/Kaset/Services/WebKit/WebKitManager.swift`)
- Music playback → Scrobbling: tracks playback
- Music interface → On-device AI: requests explanations (evidence: `README.md`)
- YouTube interface → Ask parser: parses Ask
