# negan-0/portalstreampro architecture

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

- Interactive diagram: https://gitdiagram.com/negan-0/portalstreampro
- Repository: https://github.com/negan-0/portalstreampro

## Overview

PortalStreamPro is an Android IPTV/streaming-player app. The main evidenced runtime flow is that a user opens PlayerActivity, which creates ExoPlayer, detects the device to select a Compose player UI, and asks AdaptiveBitrateManager to assess network bandwidth. PlayerActivity also creates PiP support and a network-sniffer helper. README-listed features not represented in sampled implementation are retained as documented capability nodes; their internal wiring is not established by the excerpts.

Main entry points: [`app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt) (Player Activity), [`app/src/main/java/com/portalstream/app/streaming/AdaptiveBitrateManager.kt`](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/streaming/AdaptiveBitrateManager.kt) (Adaptive Bitrate), [`app/src/main/java/com/portalstream/app/ui/player/PlayerUIs.kt`](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PlayerUIs.kt) (Player UIs), [`app/src/main/java/com/portalstream/app/ui/player/PipManager.kt`](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PipManager.kt) (PiP Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_playback["Playback"]
  node_player_activity["Player Activity<br/>[PlayerActivity.kt]"]
  node_media3_player["ExoPlayer"]
  node_player_ui["Player UIs<br/>[PlayerUIs.kt]"]
  node_pip_manager["PiP Manager<br/>[PipManager.kt]"]
end

subgraph group_device_network["Device and Network"]
  node_device_detector["Device Detector<br/>[DeviceDetector.kt]"]
  node_bitrate_manager["Adaptive Bitrate"]
  node_connectivity["Android Connectivity"]
  node_network_sniffer["Network Sniffer<br/>[NetworkSniffer.kt]"]
end

subgraph group_capabilities["Documented Capabilities"]
  node_mag_portal["MAG Portals"]
  node_playlists["Playlist Formats"]
  node_stream_extraction["Stream Extraction"]
  node_torrent_support["Torrent and Magnet"]
  node_recording["FFmpeg Recording"]
  node_casting["Casting"]
  node_epg["EPG and Guide"]
  node_credentials[("Encrypted Credentials")]
  node_dark_mode["Dark Mode"]
  node_analytics_history[("Analytics and History")]
end

node_user(("Viewer"))

node_user -->|"opens"| node_player_activity
node_player_activity -->|"creates"| node_media3_player
node_player_activity -->|"detects device"| node_device_detector
node_player_activity -->|"selects UI"| node_player_ui
node_player_activity -->|"creates"| node_pip_manager
node_player_activity -->|"creates and invokes"| node_bitrate_manager
node_player_activity -->|"creates"| node_network_sniffer
node_bitrate_manager -->|"reads bandwidth"| node_connectivity
node_player_activity -->|"supports"| node_mag_portal
node_player_activity -->|"supports"| node_playlists
node_player_activity -->|"supports"| node_stream_extraction
node_player_activity -->|"supports"| node_torrent_support
node_player_activity -->|"supports"| node_recording
node_player_activity -->|"supports"| node_casting
node_player_activity -->|"supports"| node_epg
node_player_activity -->|"supports"| node_credentials
node_player_activity -->|"supports"| node_dark_mode
node_player_activity -->|"supports"| node_analytics_history

click node_player_activity "https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt"
click node_player_ui "https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PlayerUIs.kt"
click node_pip_manager "https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PipManager.kt"
click node_device_detector "https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/utils/DeviceDetector.kt"
click node_bitrate_manager "https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/streaming/AdaptiveBitrateManager.kt"
click node_network_sniffer "https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/network/NetworkSniffer.kt"
click node_mag_portal "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_playlists "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_stream_extraction "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_torrent_support "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_recording "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_casting "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_epg "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_credentials "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_dark_mode "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"
click node_analytics_history "https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app"

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_player_activity,node_media3_player,node_player_ui,node_pip_manager,node_user toneBlue
class node_device_detector,node_bitrate_manager,node_connectivity,node_network_sniffer toneAmber
class node_mag_portal,node_playlists,node_stream_extraction,node_torrent_support,node_recording,node_casting,node_epg,node_credentials,node_dark_mode,node_analytics_history toneMint
```

## Components

### Playback

- [Player Activity](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt): `app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`
- **ExoPlayer**
- [Player UIs](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PlayerUIs.kt): `app/src/main/java/com/portalstream/app/ui/player/PlayerUIs.kt`
- [PiP Manager](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/ui/player/PipManager.kt): `app/src/main/java/com/portalstream/app/ui/player/PipManager.kt`

### Device and Network

- [Device Detector](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/utils/DeviceDetector.kt): `app/src/main/java/com/portalstream/app/utils/DeviceDetector.kt`
- [Adaptive Bitrate](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/streaming/AdaptiveBitrateManager.kt): `app/src/main/java/com/portalstream/app/streaming/AdaptiveBitrateManager.kt`
- **Android Connectivity**
- [Network Sniffer](https://github.com/negan-0/portalstreampro/blob/main/app/src/main/java/com/portalstream/app/network/NetworkSniffer.kt): `app/src/main/java/com/portalstream/app/network/NetworkSniffer.kt`

### Documented Capabilities

- [MAG Portals](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [Playlist Formats](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [Stream Extraction](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [Torrent and Magnet](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [FFmpeg Recording](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [Casting](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [EPG and Guide](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [Encrypted Credentials](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [Dark Mode](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`
- [Analytics and History](https://github.com/negan-0/portalstreampro/tree/main/app/src/main/java/com/portalstream/app): `app/src/main/java/com/portalstream/app`

### Other components

- **Viewer**

## Connections

- Viewer → Player Activity: opens (evidence: `README.md`)
- Player Activity → ExoPlayer: creates (evidence: `app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`)
- Player Activity → Device Detector: detects device (evidence: `app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`)
- Player Activity → Player UIs: selects UI (evidence: `app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`)
- Player Activity → PiP Manager: creates (evidence: `app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`)
- Player Activity → Adaptive Bitrate: creates and invokes (evidence: `app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`)
- Player Activity → Network Sniffer: creates (evidence: `app/src/main/java/com/portalstream/app/ui/player/PlayerActivity.kt`)
- Adaptive Bitrate → Android Connectivity: reads bandwidth (evidence: `app/src/main/java/com/portalstream/app/streaming/AdaptiveBitrateManager.kt`)
- Player Activity → MAG Portals: supports (evidence: `README.md`)
- Player Activity → Playlist Formats: supports (evidence: `README.md`)
- Player Activity → Stream Extraction: supports (evidence: `README.md`)
- Player Activity → Torrent and Magnet: supports (evidence: `README.md`)
- Player Activity → FFmpeg Recording: supports (evidence: `README.md`)
- Player Activity → Casting: supports (evidence: `README.md`)
- Player Activity → EPG and Guide: supports (evidence: `README.md`)
- Player Activity → Encrypted Credentials: supports (evidence: `README.md`)
- Player Activity → Dark Mode: supports (evidence: `README.md`)
- Player Activity → Analytics and History: supports (evidence: `README.md`)
