# ferman333/java-deb-installer architecture

> Architecture diagram of the GitHub repository ferman333/java-deb-installer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ferman333/java-deb-installer
- Repository: https://github.com/ferman333/java-deb-installer

## Overview

This small desktop utility guides a user from choosing a .deb file and entering a superuser password to running `sudo dpkg -i`. The installer captures the process output and exit code and displays them in a terminal-style window. The source excerpts show the GUI workflow and process handling; the README documents launching the jar and installing packages. The Debian package manager is external to the repository.

Main entry points: [`DebInstaller.java`](https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java) (Installer workflow), [`ProcessFrame.java`](https://github.com/ferman333/java-deb-installer/blob/main/ProcessFrame.java) (Output window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Installer GUI"]
  node_workflow["Installer workflow<br/>[DebInstaller.java]"]
  node_file_picker["Package picker<br/>[DebInstaller.java]"]
  node_password_prompt["Password prompt<br/>[DebInstaller.java]"]
  node_process_window["Output window<br/>[ProcessFrame.java]"]
end

subgraph group_execution["Package execution"]
  node_installer["dpkg runner<br/>[DebInstaller.java]"]
  node_dpkg["sudo dpkg"]
end

node_user(("Desktop user"))

node_user -->|"launches"| node_workflow
node_workflow -->|"opens"| node_file_picker
node_workflow -->|"requests password"| node_password_prompt
node_workflow -->|"starts install"| node_installer
node_installer -->|"runs command"| node_dpkg
node_dpkg -->|"writes output"| node_installer
node_installer -->|"streams logs"| node_process_window

click node_workflow "https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java"
click node_file_picker "https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java"
click node_password_prompt "https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java"
click node_installer "https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java"
click node_process_window "https://github.com/ferman333/java-deb-installer/blob/main/ProcessFrame.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_workflow,node_file_picker,node_password_prompt,node_process_window,node_user toneBlue
class node_installer,node_dpkg toneAmber
```

## Components

### Installer GUI

- [Installer workflow](https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java): `DebInstaller.java`
- [Package picker](https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java): `DebInstaller.java`
- [Password prompt](https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java): `DebInstaller.java`
- [Output window](https://github.com/ferman333/java-deb-installer/blob/main/ProcessFrame.java): `ProcessFrame.java`

### Package execution

- [dpkg runner](https://github.com/ferman333/java-deb-installer/blob/main/DebInstaller.java): `DebInstaller.java`
- **sudo dpkg**

### Other components

- **Desktop user**

## Connections

- Desktop user → Installer workflow: launches (evidence: `README.md`)
- Installer workflow → Package picker: opens (evidence: `DebInstaller.java`)
- Installer workflow → Password prompt: requests password (evidence: `DebInstaller.java`)
- Installer workflow → dpkg runner: starts install (evidence: `DebInstaller.java`)
- dpkg runner → sudo dpkg: runs command (evidence: `DebInstaller.java`)
- sudo dpkg → dpkg runner: writes output (evidence: `DebInstaller.java`)
- dpkg runner → Output window: streams logs (evidence: `DebInstaller.java`)
