# google/ringdroid architecture

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

## Overview

Ringdroid is an Android audio recorder and ringtone editor. The primary workflow selects or records audio, decodes it for waveform navigation and playback, lets users mark a clip, then saves and classifies the result; users can also assign a ringtone to a contact. README-described capabilities include deleting audio, audio-picker intents and multiple formats. Edges follow excerpted calls or README statements; unsampled implementation details are represented only where documented.

Main entry points: [`app/src/main/java/com/ringdroid/RingdroidEditActivity.java`](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/RingdroidEditActivity.java) (Editor workflow), [`app/src/main/java/com/ringdroid/RingdroidSelectActivity.java`](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/RingdroidSelectActivity.java) (Audio browser), [`app/src/main/java/com/ringdroid/soundfile/SoundFile.java`](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/soundfile/SoundFile.java) (Audio decoding), [`app/src/main/java/com/ringdroid/SamplePlayer.java`](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/SamplePlayer.java) (Sample playback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Audio library"]
  node_soundfile["Audio decoding<br/>[SoundFile.java]"]
  node_mp4["MP4 headers<br/>[MP4Header.java]"]
  node_wav["WAV headers<br/>[WAVHeader.java]"]
  node_metadata["Song metadata"]
end

subgraph group_browse["Audio selection"]
  node_selector["Audio browser"]
end

subgraph group_edit["Clip editing"]
  node_editor["Editor workflow"]
  node_waveform["Waveform view<br/>[WaveformView.java]"]
  node_markers["Clip markers<br/>[MarkerView.java]"]
  node_player["Sample playback<br/>[SamplePlayer.java]"]
end

subgraph group_output["Save and assign"]
  node_save_dialog["Save options"]
  node_after_save["After-save actions"]
  node_contacts["Contact assignment"]
end

node_user(("User"))
node_audio[("Audio files")]
node_android_media[("Android media catalog")]
node_android_audio["Device audio system"]
node_recording["Microphone recording"]
node_other_apps(("Other apps"))

node_user -->|"browses"| node_selector
node_selector -->|"queries catalog"| node_android_media
node_selector -->|"deletes audio"| node_audio
node_selector -->|"opens audio"| node_editor
node_user -->|"records clip"| node_editor
node_editor -->|"captures audio"| node_recording
node_editor -->|"loads audio"| node_soundfile
node_editor -->|"updates display"| node_waveform
node_editor -->|"handles markers"| node_markers
node_editor -->|"starts playback"| node_player
node_editor -->|"requests save options"| node_save_dialog
node_editor -->|"offers next actions"| node_after_save
node_waveform -->|"reads frame gains"| node_soundfile
node_player -->|"uses decoded samples"| node_soundfile
node_player -->|"plays samples"| node_android_audio
node_soundfile -->|"builds MP4 header"| node_mp4
node_soundfile -->|"builds WAV header"| node_wav
node_editor -->|"writes clipped file"| node_audio
node_editor -.->|"reads track details"| node_metadata
node_audio -.->|"cataloged audio"| node_android_media
node_editor -->|"classifies saved audio"| node_after_save
node_editor -->|"launches assignment"| node_contacts
node_contacts -->|"updates contact ringtone"| node_android_media
node_other_apps -->|"requests audio picker"| node_selector

click node_selector "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/RingdroidSelectActivity.java"
click node_editor "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/RingdroidEditActivity.java"
click node_waveform "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/WaveformView.java"
click node_markers "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/MarkerView.java"
click node_player "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/SamplePlayer.java"
click node_soundfile "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/soundfile/SoundFile.java"
click node_mp4 "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/soundfile/MP4Header.java"
click node_wav "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/soundfile/WAVHeader.java"
click node_metadata "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/SongMetadataReader.java"
click node_save_dialog "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/FileSaveDialog.java"
click node_after_save "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/AfterSaveActionDialog.java"
click node_contacts "https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/ChooseContactActivity.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_soundfile,node_mp4,node_wav,node_metadata,node_user toneBlue
class node_selector,node_audio,node_android_media toneAmber
class node_editor,node_waveform,node_markers,node_player toneMint
class node_save_dialog,node_after_save,node_contacts toneRose
class node_android_audio,node_recording,node_other_apps toneIndigo
```

## Components

### Audio library

- [Audio decoding](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/soundfile/SoundFile.java): `app/src/main/java/com/ringdroid/soundfile/SoundFile.java`
- [MP4 headers](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/soundfile/MP4Header.java): `app/src/main/java/com/ringdroid/soundfile/MP4Header.java`
- [WAV headers](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/soundfile/WAVHeader.java): `app/src/main/java/com/ringdroid/soundfile/WAVHeader.java`
- [Song metadata](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/SongMetadataReader.java): `app/src/main/java/com/ringdroid/SongMetadataReader.java`

### Audio selection

- [Audio browser](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/RingdroidSelectActivity.java): `app/src/main/java/com/ringdroid/RingdroidSelectActivity.java`

### Clip editing

- [Editor workflow](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/RingdroidEditActivity.java): `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`
- [Waveform view](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/WaveformView.java): `app/src/main/java/com/ringdroid/WaveformView.java`
- [Clip markers](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/MarkerView.java): `app/src/main/java/com/ringdroid/MarkerView.java`
- [Sample playback](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/SamplePlayer.java): `app/src/main/java/com/ringdroid/SamplePlayer.java`

### Save and assign

- [Save options](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/FileSaveDialog.java): `app/src/main/java/com/ringdroid/FileSaveDialog.java`
- [After-save actions](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/AfterSaveActionDialog.java): `app/src/main/java/com/ringdroid/AfterSaveActionDialog.java`
- [Contact assignment](https://github.com/google/ringdroid/blob/master/app/src/main/java/com/ringdroid/ChooseContactActivity.java): `app/src/main/java/com/ringdroid/ChooseContactActivity.java`

### Other components

- **User**
- **Audio files**
- **Android media catalog**
- **Device audio system**
- **Microphone recording**
- **Other apps**

## Connections

- User → Audio browser: browses (evidence: `README.md`)
- Audio browser → Android media catalog: queries catalog (evidence: `app/src/main/java/com/ringdroid/RingdroidSelectActivity.java`)
- Audio browser → Audio files: deletes audio (evidence: `app/src/main/java/com/ringdroid/RingdroidSelectActivity.java`)
- Audio browser → Editor workflow: opens audio (evidence: `app/src/main/java/com/ringdroid/RingdroidSelectActivity.java`)
- User → Editor workflow: records clip (evidence: `README.md`)
- Editor workflow → Microphone recording: captures audio
- Editor workflow → Audio decoding: loads audio (evidence: `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`)
- Editor workflow → Waveform view: updates display (evidence: `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`)
- Editor workflow → Clip markers: handles markers (evidence: `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`)
- Editor workflow → Sample playback: starts playback (evidence: `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`)
- Editor workflow → Save options: requests save options (evidence: `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`)
- Editor workflow → After-save actions: offers next actions (evidence: `app/src/main/java/com/ringdroid/AfterSaveActionDialog.java`)
- Waveform view → Audio decoding: reads frame gains (evidence: `app/src/main/java/com/ringdroid/WaveformView.java`)
- Sample playback → Audio decoding: uses decoded samples (evidence: `app/src/main/java/com/ringdroid/SamplePlayer.java`)
- Sample playback → Device audio system: plays samples (evidence: `app/src/main/java/com/ringdroid/SamplePlayer.java`)
- Audio decoding → MP4 headers: builds MP4 header (evidence: `app/src/main/java/com/ringdroid/soundfile/SoundFile.java`)
- Audio decoding → WAV headers: builds WAV header (evidence: `app/src/main/java/com/ringdroid/soundfile/SoundFile.java`)
- Editor workflow → Audio files: writes clipped file (evidence: `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`)
- Editor workflow → Song metadata: reads track details (evidence: `app/src/main/java/com/ringdroid/RingdroidEditActivity.java`)
- Audio files → Android media catalog: cataloged audio
- Editor workflow → After-save actions: classifies saved audio (evidence: `README.md`)
- Editor workflow → Contact assignment: launches assignment (evidence: `app/src/main/java/com/ringdroid/RingdroidSelectActivity.java`)
- Contact assignment → Android media catalog: updates contact ringtone (evidence: `app/src/main/java/com/ringdroid/ChooseContactActivity.java`)
- Other apps → Audio browser: requests audio picker (evidence: `README.md`)
