# frogging-family/wine-tkg-git architecture

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

- Interactive diagram: https://gitdiagram.com/frogging-family/wine-tkg-git
- Repository: https://github.com/frogging-family/wine-tkg-git

## Overview

Wine-tkg is a configurable build system for custom Wine and Proton distributions. The main workflow is to select a Wine base and patch set, build Wine through the PKGBUILD or standalone path, and optionally use proton-tkg’s wrapper and template for a custom Proton build. Profiles, bundled patches, and user patches are customization inputs; generated builds are installed as Steam compatibility tools. The README documents these capabilities, but sampled source does not expose the build scripts’ call sequence, so internal build edges are left unasserted.

Main entry points: [`proton-tkg/proton_template`](https://github.com/frogging-family/wine-tkg-git/tree/master/proton-tkg/proton_template) (Proton template), [`proton-tkg/proton-tkg.sh`](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton-tkg.sh) (Proton wrapper), [`wine-tkg-git/PKGBUILD`](https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/PKGBUILD) (Wine build), [`wine-tkg-git/non-makepkg-build.sh`](https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/non-makepkg-build.sh) (Standalone build)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["Build entrypoints"]
  node_builder["Wine build"]
  node_standalone["Standalone build"]
  node_protonwrap["Proton wrapper<br/>[proton-tkg.sh]"]
end

subgraph group_custom["Build customization"]
  node_wineconfig["Wine settings<br/>[customization.cfg]"]
  node_wineprofiles["Wine profiles"]
  node_winepatches["Wine patches"]
  node_wineuserpatches["User patches"]
  node_protonconfig["Proton settings<br/>[proton-tkg.cfg]"]
  node_protonprofiles["Proton profiles"]
  node_protonpatches["Proton patches"]
end

subgraph group_proton["Proton runtime"]
  node_template["Proton template"]
  node_user_settings["Runtime settings<br/>[user_settings.py]"]
  node_default_pfx["Default prefix<br/>[default_pfx.py]"]
  node_steampipe["Steampipe fixups"]
  node_pefixup["PE fixups<br/>[pefixup.py]"]
  node_filelock["File locking<br/>[filelock.py]"]
end

node_steam(("Steam user"))
node_wineoutput["Wine build output"]
node_protonoutput["Proton tool"]

node_wineconfig -.->|"configures"| node_builder
node_wineprofiles -.->|"configures"| node_builder
node_winepatches -.->|"patches"| node_builder
node_wineuserpatches -.->|"customizes"| node_builder
node_builder -.->|"builds"| node_wineoutput
node_standalone -.->|"builds"| node_wineoutput
node_protonconfig -.->|"configures"| node_protonwrap
node_protonprofiles -.->|"configures"| node_protonwrap
node_protonpatches -.->|"patches"| node_protonwrap
node_protonwrap -.->|"wraps"| node_template
node_protonwrap -.->|"builds"| node_protonoutput
node_steam -.->|"installs"| node_protonoutput
node_protonoutput -.->|"runs games"| node_steam
node_template -.->|"includes"| node_user_settings
node_template -.->|"includes"| node_default_pfx
node_template -.->|"includes"| node_steampipe
node_template -.->|"includes"| node_pefixup
node_template -.->|"includes"| node_filelock

click node_builder "https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/PKGBUILD"
click node_standalone "https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/non-makepkg-build.sh"
click node_protonwrap "https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton-tkg.sh"
click node_wineconfig "https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/customization.cfg"
click node_wineprofiles "https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-profiles"
click node_winepatches "https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-patches"
click node_wineuserpatches "https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-userpatches"
click node_protonconfig "https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton-tkg.cfg"
click node_protonprofiles "https://github.com/frogging-family/wine-tkg-git/tree/master/proton-tkg/proton-tkg-profiles"
click node_protonpatches "https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-patches/proton-tkg-specific"
click node_template "https://github.com/frogging-family/wine-tkg-git/tree/master/proton-tkg/proton_template"
click node_user_settings "https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/conf/user_settings.py"
click node_default_pfx "https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/default_pfx.py"
click node_steampipe "https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/steampipe_fixups.py"
click node_pefixup "https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/pefixup.py"
click node_filelock "https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/conf/filelock.py"

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_builder,node_standalone,node_protonwrap,node_steam toneBlue
class node_wineconfig,node_wineprofiles,node_winepatches,node_wineuserpatches,node_protonconfig,node_protonprofiles,node_protonpatches toneAmber
class node_template,node_user_settings,node_default_pfx,node_steampipe,node_pefixup,node_filelock toneMint
class node_wineoutput,node_protonoutput toneIndigo
```

## Components

### Build entrypoints

- [Wine build](https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/PKGBUILD): `wine-tkg-git/PKGBUILD`
- [Standalone build](https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/non-makepkg-build.sh): `wine-tkg-git/non-makepkg-build.sh`
- [Proton wrapper](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton-tkg.sh): `proton-tkg/proton-tkg.sh`

### Build customization

- [Wine settings](https://github.com/frogging-family/wine-tkg-git/blob/master/wine-tkg-git/customization.cfg): `wine-tkg-git/customization.cfg`
- [Wine profiles](https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-profiles): `wine-tkg-git/wine-tkg-profiles`
- [Wine patches](https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-patches): `wine-tkg-git/wine-tkg-patches`
- [User patches](https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-userpatches): `wine-tkg-git/wine-tkg-userpatches`
- [Proton settings](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton-tkg.cfg): `proton-tkg/proton-tkg.cfg`
- [Proton profiles](https://github.com/frogging-family/wine-tkg-git/tree/master/proton-tkg/proton-tkg-profiles): `proton-tkg/proton-tkg-profiles`
- [Proton patches](https://github.com/frogging-family/wine-tkg-git/tree/master/wine-tkg-git/wine-tkg-patches/proton-tkg-specific): `wine-tkg-git/wine-tkg-patches/proton-tkg-specific`

### Proton runtime

- [Proton template](https://github.com/frogging-family/wine-tkg-git/tree/master/proton-tkg/proton_template): `proton-tkg/proton_template`
- [Runtime settings](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/conf/user_settings.py): `proton-tkg/proton_template/conf/user_settings.py`
- [Default prefix](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/default_pfx.py): `proton-tkg/proton_template/default_pfx.py`
- [Steampipe fixups](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/steampipe_fixups.py): `proton-tkg/proton_template/steampipe_fixups.py`
- [PE fixups](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/pefixup.py): `proton-tkg/proton_template/pefixup.py`
- [File locking](https://github.com/frogging-family/wine-tkg-git/blob/master/proton-tkg/proton_template/conf/filelock.py): `proton-tkg/proton_template/conf/filelock.py`

### Other components

- **Steam user**
- **Wine build output**
- **Proton tool**

## Connections

- Wine settings → Wine build: configures (evidence: `README.md`)
- Wine profiles → Wine build: configures (evidence: `README.md`)
- Wine patches → Wine build: patches (evidence: `README.md`)
- User patches → Wine build: customizes (evidence: `README.md`)
- Wine build → Wine build output: builds (evidence: `README.md`)
- Standalone build → Wine build output: builds
- Proton settings → Proton wrapper: configures
- Proton profiles → Proton wrapper: configures
- Proton patches → Proton wrapper: patches (evidence: `README.md`)
- Proton wrapper → Proton template: wraps (evidence: `README.md`)
- Proton wrapper → Proton tool: builds (evidence: `README.md`)
- Steam user → Proton tool: installs (evidence: `README.md`)
- Proton tool → Steam user: runs games (evidence: `README.md`)
- Proton template → Runtime settings: includes
- Proton template → Default prefix: includes
- Proton template → Steampipe fixups: includes
- Proton template → PE fixups: includes
- Proton template → File locking: includes
