# ioannisarmamentos/1055rock architecture

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

- Interactive diagram: https://gitdiagram.com/ioannisarmamentos/1055rock
- Repository: https://github.com/ioannisarmamentos/1055rock

## Overview

1055Rock is an Android radio-streaming app. The main workflow opens the home screen, starts or stops live playback through a foreground service, and periodically fetches track metadata for display and the media notification. Its navigation also exposes program, producer, contact, and about screens plus station links and sharing actions. The source excerpts establish the main playback, metadata, and producer-data flows; unsampled screens and integrations are included only where the README or inspected caller establishes them.

Main entry points: [`app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java) (Home screen), [`app/src/main/java/com/desertovercrowded/rock1055/ISongTitleFetcher.java`](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/ISongTitleFetcher.java) (Metadata callback), [`app/src/main/java/com/desertovercrowded/rock1055/StreamService.java`](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/StreamService.java) (Stream service), [`app/src/main/java/com/desertovercrowded/rock1055/PlayingSongTitleFetcher.java`](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/PlayingSongTitleFetcher.java) (Title fetcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_playback["Radio playback"]
  node_playtoggle["Playback control"]
  node_streamservice["Stream service<br/>[StreamService.java]"]
  node_radio(("Radio stream"))
end

subgraph group_metadata["Track metadata"]
  node_fetcher["Title fetcher"]
  node_fetchcontract["Metadata callback"]
  node_nowplaying["Now playing UI<br/>[MainActivity.java]"]
  node_notification["Playback notification<br/>[StreamService.java]"]
  node_trackfeed(("Track metadata feed"))
end

subgraph group_station["Station content"]
  node_program["Program screen<br/>[Program.java]"]
  node_producerpage["Producer listing<br/>[Producers.java]"]
  node_produceradapter["Producer list UI"]
  node_producerdata["Producer data<br/>[DataSingleton.java]"]
  node_producerlist["Producer records<br/>[ProducerList.java]"]
  node_producer["Producer model<br/>[Producer.java]"]
end

subgraph group_navigation["App navigation"]
  node_home["Home screen<br/>[MainActivity.java]"]
  node_contact["Contact screen<br/>[Contact.java]"]
  node_about["About screen<br/>[AboutMe.java]"]
  node_actions["Station actions<br/>[Extensions.java]"]
  node_startup["App initialization<br/>[Application.java]"]
  node_splash["Splash screen<br/>[Splash.java]"]
end

node_listener(("Radio listener"))

node_listener -->|"opens"| node_home
node_home -->|"sets listener"| node_playtoggle
node_playtoggle -->|"controls"| node_streamservice
node_streamservice -->|"plays stream"| node_radio
node_home -->|"starts polling"| node_fetcher
node_streamservice -->|"starts polling"| node_fetcher
node_fetcher -->|"reads metadata"| node_trackfeed
node_fetcher -->|"calls callback"| node_fetchcontract
node_home -->|"implements"| node_fetchcontract
node_streamservice -->|"implements"| node_fetchcontract
node_fetchcontract -->|"updates"| node_nowplaying
node_fetchcontract -->|"updates"| node_notification
node_home -->|"opens"| node_program
node_home -->|"opens"| node_producerpage
node_home -->|"opens"| node_contact
node_home -->|"opens"| node_about
node_home -->|"invokes"| node_actions
node_startup -->|"loads JSON"| node_producerdata
node_producerdata -->|"parses into"| node_producerlist
node_producerpage -->|"gets records"| node_producerdata
node_producerpage -->|"configures"| node_produceradapter
node_produceradapter -->|"renders"| node_producer
node_producerlist -.->|"contains"| node_producer
node_splash -->|"launches"| node_home

click node_home "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java"
click node_playtoggle "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/PlayPauseButtonListener.java"
click node_streamservice "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/StreamService.java"
click node_fetcher "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/PlayingSongTitleFetcher.java"
click node_fetchcontract "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/ISongTitleFetcher.java"
click node_nowplaying "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java"
click node_notification "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/StreamService.java"
click node_program "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Program.java"
click node_producerpage "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Producers.java"
click node_produceradapter "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/adapter/ProducerAdapter.java"
click node_producerdata "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/DataSingleton.java"
click node_producerlist "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/ProducerList.java"
click node_producer "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Producer.java"
click node_contact "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Contact.java"
click node_about "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/AboutMe.java"
click node_actions "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Extensions.java"
click node_startup "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Application.java"
click node_splash "https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Splash.java"

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_playtoggle,node_streamservice,node_radio toneBlue
class node_fetcher,node_fetchcontract,node_nowplaying,node_notification,node_trackfeed toneAmber
class node_program,node_producerpage,node_produceradapter,node_producerdata,node_producerlist,node_producer toneMint
class node_home,node_contact,node_about,node_actions,node_startup,node_splash toneRose
class node_listener toneIndigo
```

## Components

### Radio playback

- [Playback control](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/PlayPauseButtonListener.java): `app/src/main/java/com/desertovercrowded/rock1055/PlayPauseButtonListener.java`
- [Stream service](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/StreamService.java): `app/src/main/java/com/desertovercrowded/rock1055/StreamService.java`
- **Radio stream**

### Track metadata

- [Title fetcher](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/PlayingSongTitleFetcher.java): `app/src/main/java/com/desertovercrowded/rock1055/PlayingSongTitleFetcher.java`
- [Metadata callback](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/ISongTitleFetcher.java): `app/src/main/java/com/desertovercrowded/rock1055/ISongTitleFetcher.java`
- [Now playing UI](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java): `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`
- [Playback notification](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/StreamService.java): `app/src/main/java/com/desertovercrowded/rock1055/StreamService.java`
- **Track metadata feed**

### Station content

- [Program screen](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Program.java): `app/src/main/java/com/desertovercrowded/rock1055/Program.java`
- [Producer listing](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Producers.java): `app/src/main/java/com/desertovercrowded/rock1055/Producers.java`
- [Producer list UI](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/adapter/ProducerAdapter.java): `app/src/main/java/com/desertovercrowded/rock1055/adapter/ProducerAdapter.java`
- [Producer data](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/DataSingleton.java): `app/src/main/java/com/desertovercrowded/rock1055/DataSingleton.java`
- [Producer records](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/ProducerList.java): `app/src/main/java/com/desertovercrowded/rock1055/ProducerList.java`
- [Producer model](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Producer.java): `app/src/main/java/com/desertovercrowded/rock1055/Producer.java`

### App navigation

- [Home screen](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java): `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`
- [Contact screen](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Contact.java): `app/src/main/java/com/desertovercrowded/rock1055/Contact.java`
- [About screen](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/AboutMe.java): `app/src/main/java/com/desertovercrowded/rock1055/AboutMe.java`
- [Station actions](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Extensions.java): `app/src/main/java/com/desertovercrowded/rock1055/Extensions.java`
- [App initialization](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Application.java): `app/src/main/java/com/desertovercrowded/rock1055/Application.java`
- [Splash screen](https://github.com/ioannisarmamentos/1055rock/blob/master/app/src/main/java/com/desertovercrowded/rock1055/Splash.java): `app/src/main/java/com/desertovercrowded/rock1055/Splash.java`

### Other components

- **Radio listener**

## Connections

- Radio listener → Home screen: opens (evidence: `README.md`)
- Home screen → Playback control: sets listener (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Playback control → Stream service: controls (evidence: `app/src/main/java/com/desertovercrowded/rock1055/PlayPauseButtonListener.java`)
- Stream service → Radio stream: plays stream (evidence: `app/src/main/java/com/desertovercrowded/rock1055/StreamService.java`)
- Home screen → Title fetcher: starts polling (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Stream service → Title fetcher: starts polling (evidence: `app/src/main/java/com/desertovercrowded/rock1055/StreamService.java`)
- Title fetcher → Track metadata feed: reads metadata (evidence: `app/src/main/java/com/desertovercrowded/rock1055/PlayingSongTitleFetcher.java`)
- Title fetcher → Metadata callback: calls callback (evidence: `app/src/main/java/com/desertovercrowded/rock1055/PlayingSongTitleFetcher.java`)
- Home screen → Metadata callback: implements (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Stream service → Metadata callback: implements (evidence: `app/src/main/java/com/desertovercrowded/rock1055/StreamService.java`)
- Metadata callback → Now playing UI: updates (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Metadata callback → Playback notification: updates (evidence: `app/src/main/java/com/desertovercrowded/rock1055/StreamService.java`)
- Home screen → Program screen: opens (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Home screen → Producer listing: opens (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Home screen → Contact screen: opens (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Home screen → About screen: opens (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- Home screen → Station actions: invokes (evidence: `app/src/main/java/com/desertovercrowded/rock1055/MainActivity.java`)
- App initialization → Producer data: loads JSON (evidence: `app/src/main/java/com/desertovercrowded/rock1055/Application.java`)
- Producer data → Producer records: parses into (evidence: `app/src/main/java/com/desertovercrowded/rock1055/DataSingleton.java`)
- Producer listing → Producer data: gets records (evidence: `app/src/main/java/com/desertovercrowded/rock1055/Producers.java`)
- Producer listing → Producer list UI: configures (evidence: `app/src/main/java/com/desertovercrowded/rock1055/Producers.java`)
- Producer list UI → Producer model: renders (evidence: `app/src/main/java/com/desertovercrowded/rock1055/adapter/ProducerAdapter.java`)
- Producer records → Producer model: contains (evidence: `app/src/main/java/com/desertovercrowded/rock1055/ProducerList.java`)
- Splash screen → Home screen: launches (evidence: `app/src/main/java/com/desertovercrowded/rock1055/Splash.java`)
