# gerbilsoft/rom-properties architecture

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

## Overview

ROM Properties Page is a multi-platform shell extension for inspecting game ROMs and disc images in desktop file browsers. Its main user workflow is selecting a supported file, opening its properties or preview, and viewing parsed information and images; the README also documents metadata, columns, overlays, context-menu conversion, and command-line features. The graph preserves those product branches while showing sampled cache, image-export, and key-management internals. Parser and platform-adapter implementations are not sampled, so their internal call relationships are omitted.

Main entry points: [`src`](https://github.com/gerbilsoft/rom-properties/tree/master/src) (Desktop File Browsers), [`src/libromdata`](https://github.com/gerbilsoft/rom-properties/tree/master/src/libromdata) (ROM And Disc Parsing), [`src/libromdata/img/CacheManager.cpp`](https://github.com/gerbilsoft/rom-properties/blob/master/src/libromdata/img/CacheManager.cpp) (Online Image Cache), [`src/rpcli/rpcli.cpp`](https://github.com/gerbilsoft/rom-properties/blob/master/src/rpcli/rpcli.cpp) (Command-Line Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser Integration"]
  node_browser["Desktop File Browsers"]
  node_properties["Properties Tabs"]
  node_thumbnails["Thumbnails"]
  node_metadata["Metadata And Columns"]
  node_overlay["Dangerous Overlays"]
  node_texturemenu["Texture Conversion Menu"]
end

subgraph group_rom["ROM Information"]
  node_romdata["ROM And Disc Parsing"]
  node_rpcli["Command-Line Client<br/>[rpcli.cpp]"]
end

subgraph group_media["Images And Cache"]
  node_image["Image Display And Export<br/>[DragImage.cpp]"]
  node_kdeimage["KDE Image Display<br/>[DragImageLabel.cpp]"]
  node_pngwriter["PNG Writer<br/>[RpPngWriter.hpp]"]
  node_cache["Online Image Cache<br/>[CacheManager.cpp]"]
end

subgraph group_support["Utilities And Configuration"]
  node_keyui["Key Manager Settings<br/>[KeyManagerTab.cpp]"]
  node_keymanager["Encryption Key Manager<br/>[KeyManager.cpp]"]
  node_keyconfig["Key Configuration"]
  node_filesystem["File System<br/>[FileSystem.hpp]"]
end

node_user(("File Browser User"))
node_online["Online Image Databases"]

node_user -->|"selects file"| node_browser
node_browser -->|"opens properties"| node_properties
node_browser -->|"requests preview"| node_thumbnails
node_properties -.->|"shows parsed data"| node_romdata
node_thumbnails -.->|"reads image data"| node_romdata
node_browser -->|"displays metadata"| node_metadata
node_browser -->|"shows overlay"| node_overlay
node_browser -->|"offers conversion"| node_texturemenu
node_user -.->|"runs command"| node_rpcli
node_rpcli -.->|"queries ROM data"| node_romdata
node_image -->|"writes PNG"| node_pngwriter
node_kdeimage -->|"writes PNG"| node_pngwriter
node_cache -->|"checks and deletes files"| node_filesystem
node_cache -.->|"downloads images"| node_online
node_keyui -->|"uses key manager"| node_keymanager
node_keymanager -->|"loads configuration"| node_keyconfig

click node_browser "https://github.com/gerbilsoft/rom-properties/tree/master/src"
click node_properties "https://github.com/gerbilsoft/rom-properties/tree/master/src"
click node_thumbnails "https://github.com/gerbilsoft/rom-properties/tree/master/src"
click node_metadata "https://github.com/gerbilsoft/rom-properties/tree/master/src"
click node_overlay "https://github.com/gerbilsoft/rom-properties/tree/master/src"
click node_texturemenu "https://github.com/gerbilsoft/rom-properties/tree/master/src"
click node_romdata "https://github.com/gerbilsoft/rom-properties/tree/master/src/libromdata"
click node_rpcli "https://github.com/gerbilsoft/rom-properties/blob/master/src/rpcli/rpcli.cpp"
click node_image "https://github.com/gerbilsoft/rom-properties/blob/master/src/gtk/DragImage.cpp"
click node_kdeimage "https://github.com/gerbilsoft/rom-properties/blob/master/src/kde/DragImageLabel.cpp"
click node_pngwriter "https://github.com/gerbilsoft/rom-properties/blob/master/src/librpbase/img/RpPngWriter.hpp"
click node_cache "https://github.com/gerbilsoft/rom-properties/blob/master/src/libromdata/img/CacheManager.cpp"
click node_keyui "https://github.com/gerbilsoft/rom-properties/blob/master/src/win32/config/KeyManagerTab.cpp"
click node_keymanager "https://github.com/gerbilsoft/rom-properties/blob/master/src/librpbase/crypto/KeyManager.cpp"
click node_keyconfig "https://github.com/gerbilsoft/rom-properties/tree/master/src/librpbase/config"
click node_filesystem "https://github.com/gerbilsoft/rom-properties/blob/master/src/librpfile/FileSystem.hpp"

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_browser,node_properties,node_thumbnails,node_metadata,node_overlay,node_texturemenu,node_user toneBlue
class node_romdata,node_rpcli,node_online toneAmber
class node_image,node_kdeimage,node_pngwriter,node_cache toneMint
class node_keyui,node_keymanager,node_keyconfig,node_filesystem toneRose
```

## Components

### Browser Integration

- [Desktop File Browsers](https://github.com/gerbilsoft/rom-properties/tree/master/src): `src`
- [Properties Tabs](https://github.com/gerbilsoft/rom-properties/tree/master/src): `src`
- [Thumbnails](https://github.com/gerbilsoft/rom-properties/tree/master/src): `src`
- [Metadata And Columns](https://github.com/gerbilsoft/rom-properties/tree/master/src): `src`
- [Dangerous Overlays](https://github.com/gerbilsoft/rom-properties/tree/master/src): `src`
- [Texture Conversion Menu](https://github.com/gerbilsoft/rom-properties/tree/master/src): `src`

### ROM Information

- [ROM And Disc Parsing](https://github.com/gerbilsoft/rom-properties/tree/master/src/libromdata): `src/libromdata`
- [Command-Line Client](https://github.com/gerbilsoft/rom-properties/blob/master/src/rpcli/rpcli.cpp): `src/rpcli/rpcli.cpp`

### Images And Cache

- [Image Display And Export](https://github.com/gerbilsoft/rom-properties/blob/master/src/gtk/DragImage.cpp): `src/gtk/DragImage.cpp`
- [KDE Image Display](https://github.com/gerbilsoft/rom-properties/blob/master/src/kde/DragImageLabel.cpp): `src/kde/DragImageLabel.cpp`
- [PNG Writer](https://github.com/gerbilsoft/rom-properties/blob/master/src/librpbase/img/RpPngWriter.hpp): `src/librpbase/img/RpPngWriter.hpp`
- [Online Image Cache](https://github.com/gerbilsoft/rom-properties/blob/master/src/libromdata/img/CacheManager.cpp): `src/libromdata/img/CacheManager.cpp`

### Utilities And Configuration

- [Key Manager Settings](https://github.com/gerbilsoft/rom-properties/blob/master/src/win32/config/KeyManagerTab.cpp): `src/win32/config/KeyManagerTab.cpp`
- [Encryption Key Manager](https://github.com/gerbilsoft/rom-properties/blob/master/src/librpbase/crypto/KeyManager.cpp): `src/librpbase/crypto/KeyManager.cpp`
- [Key Configuration](https://github.com/gerbilsoft/rom-properties/tree/master/src/librpbase/config): `src/librpbase/config`
- [File System](https://github.com/gerbilsoft/rom-properties/blob/master/src/librpfile/FileSystem.hpp): `src/librpfile/FileSystem.hpp`

### Other components

- **File Browser User**
- **Online Image Databases**

## Connections

- File Browser User → Desktop File Browsers: selects file (evidence: `README.md`)
- Desktop File Browsers → Properties Tabs: opens properties (evidence: `README.md`)
- Desktop File Browsers → Thumbnails: requests preview (evidence: `README.md`)
- Properties Tabs → ROM And Disc Parsing: shows parsed data (evidence: `src/libromdata/img/CacheManager.cpp`)
- Thumbnails → ROM And Disc Parsing: reads image data (evidence: `src/libromdata/img/CacheManager.cpp`)
- Desktop File Browsers → Metadata And Columns: displays metadata (evidence: `README.md`)
- Desktop File Browsers → Dangerous Overlays: shows overlay (evidence: `README.md`)
- Desktop File Browsers → Texture Conversion Menu: offers conversion (evidence: `README.md`)
- File Browser User → Command-Line Client: runs command
- Command-Line Client → ROM And Disc Parsing: queries ROM data
- Image Display And Export → PNG Writer: writes PNG (evidence: `src/gtk/DragImage.cpp`)
- KDE Image Display → PNG Writer: writes PNG (evidence: `src/kde/DragImageLabel.cpp`)
- Online Image Cache → File System: checks and deletes files (evidence: `src/libromdata/img/CacheManager.cpp`)
- Online Image Cache → Online Image Databases: downloads images
- Key Manager Settings → Encryption Key Manager: uses key manager (evidence: `src/win32/config/KeyManagerTab.cpp`)
- Encryption Key Manager → Key Configuration: loads configuration (evidence: `src/librpbase/crypto/KeyManager.cpp`)
