# adlerzz/pree architecture

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

- Interactive diagram: https://gitdiagram.com/adlerzz/pree
- Repository: https://github.com/adlerzz/pree

## Overview

This Android app processes live microphone audio with adjustable distortion, frequency filtering and pitch shifting, then plays the result and displays its spectrum. The user starts or stops processing and adjusts parameters with custom sliders. MainActivity owns the audio loop and invokes each DSP operation in Engine; Ruchka implements the sliders. The source excerpts show these calls and UI relationships, but do not establish details beyond the sampled runtime code.

Main entry points: [`app/src/main/java/org/adlerzz/pree/MainActivity.kt`](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/MainActivity.kt) (MainActivity), [`app/src/main/java/org/adlerzz/pree/Ruchka.kt`](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Ruchka.kt) (Parameter sliders), [`app/src/main/res/layout/activity_main.xml`](https://github.com/adlerzz/pree/blob/master/app/src/main/res/layout/activity_main.xml) (Main screen), [`app/src/main/res/layout/layout_ruchka.xml`](https://github.com/adlerzz/pree/blob/master/app/src/main/res/layout/layout_ruchka.xml) (Slider layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Controls and display"]
  node_activity["MainActivity<br/>[MainActivity.kt]"]
  node_screen["Main screen<br/>[activity_main.xml]"]
  node_sliders["Parameter sliders<br/>[Ruchka.kt]"]
  node_slider_layout["Slider layout<br/>[layout_ruchka.xml]"]
  node_spectrum["Spectrum graph<br/>[MainActivity.kt]"]
end

subgraph group_processing["Audio processing"]
  node_distortion["Distortion<br/>[Engine.kt]"]
  node_fft["FFT transform<br/>[Engine.kt]"]
  node_filter["Frequency cut<br/>[Engine.kt]"]
  node_pitch["Pitch shift<br/>[Engine.kt]"]
  node_ifft["Inverse FFT<br/>[Engine.kt]"]
  node_magnitude["Magnitude data<br/>[Engine.kt]"]
end

subgraph group_audio["Audio runtime"]
  node_microphone["Android microphone"]
  node_playback["Android audio output"]
end

node_user(("User"))

node_user -->|"controls"| node_activity
node_activity -->|"sets content"| node_screen
node_activity -->|"reads values"| node_sliders
node_sliders -->|"inflates"| node_slider_layout
node_activity -->|"reads samples"| node_microphone
node_activity -->|"calls"| node_distortion
node_activity -->|"calls"| node_fft
node_activity -->|"calls"| node_filter
node_activity -->|"calls"| node_pitch
node_activity -->|"calls"| node_ifft
node_activity -->|"calls"| node_magnitude
node_activity -->|"writes samples"| node_playback
node_activity -->|"renders data"| node_spectrum

click node_activity "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/MainActivity.kt"
click node_screen "https://github.com/adlerzz/pree/blob/master/app/src/main/res/layout/activity_main.xml"
click node_sliders "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Ruchka.kt"
click node_slider_layout "https://github.com/adlerzz/pree/blob/master/app/src/main/res/layout/layout_ruchka.xml"
click node_spectrum "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/MainActivity.kt"
click node_distortion "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt"
click node_fft "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt"
click node_filter "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt"
click node_pitch "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt"
click node_ifft "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt"
click node_magnitude "https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt"

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_activity,node_screen,node_sliders,node_slider_layout,node_spectrum,node_user toneBlue
class node_distortion,node_fft,node_filter,node_pitch,node_ifft,node_magnitude toneAmber
class node_microphone,node_playback toneMint
```

## Components

### Controls and display

- [MainActivity](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/MainActivity.kt): `app/src/main/java/org/adlerzz/pree/MainActivity.kt`
- [Main screen](https://github.com/adlerzz/pree/blob/master/app/src/main/res/layout/activity_main.xml): `app/src/main/res/layout/activity_main.xml`
- [Parameter sliders](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Ruchka.kt): `app/src/main/java/org/adlerzz/pree/Ruchka.kt`
- [Slider layout](https://github.com/adlerzz/pree/blob/master/app/src/main/res/layout/layout_ruchka.xml): `app/src/main/res/layout/layout_ruchka.xml`
- [Spectrum graph](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/MainActivity.kt): `app/src/main/java/org/adlerzz/pree/MainActivity.kt`

### Audio processing

- [Distortion](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt): `app/src/main/java/org/adlerzz/pree/Engine.kt`
- [FFT transform](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt): `app/src/main/java/org/adlerzz/pree/Engine.kt`
- [Frequency cut](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt): `app/src/main/java/org/adlerzz/pree/Engine.kt`
- [Pitch shift](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt): `app/src/main/java/org/adlerzz/pree/Engine.kt`
- [Inverse FFT](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt): `app/src/main/java/org/adlerzz/pree/Engine.kt`
- [Magnitude data](https://github.com/adlerzz/pree/blob/master/app/src/main/java/org/adlerzz/pree/Engine.kt): `app/src/main/java/org/adlerzz/pree/Engine.kt`

### Audio runtime

- **Android microphone**
- **Android audio output**

### Other components

- **User**

## Connections

- User → MainActivity: controls (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Main screen: sets content (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Parameter sliders: reads values (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- Parameter sliders → Slider layout: inflates (evidence: `app/src/main/java/org/adlerzz/pree/Ruchka.kt`)
- MainActivity → Android microphone: reads samples (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Distortion: calls (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → FFT transform: calls (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Frequency cut: calls (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Pitch shift: calls (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Inverse FFT: calls (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Magnitude data: calls (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Android audio output: writes samples (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
- MainActivity → Spectrum graph: renders data (evidence: `app/src/main/java/org/adlerzz/pree/MainActivity.kt`)
