# joaovitoramaral27/omni-multi-emulator architecture

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

- Interactive diagram: https://gitdiagram.com/joaovitoramaral27/omni-multi-emulator
- Repository: https://github.com/joaovitoramaral27/omni-multi-emulator

## Overview

Omni Multi-Emulator is a Kivy mobile app whose current workflow is to choose a system, browse ROMs from a configured folder, and select a game. Selection currently only prints the ROM path: the emulator modules are empty placeholders, and the README’s cartridge, memory, CPU, PPU, input, timer/audio, and game-loop stages are roadmap items, not implemented runtime capabilities. The profile screen separately lets the user choose and persist a picture. Edges reflect the sampled screen and settings calls; no unsampled emulator behavior is inferred.

Main entry points: [`APP/UI/Screens/gamelist.py`](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/gamelist.py) (Game list screen), [`APP/UI/Screens/profile.py`](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/profile.py) (Profile screen), [`APP/main.py`](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/main.py) (Kivy app), [`APP/UI/Screens/homepage.py`](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/homepage.py) (System home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_ui["App and navigation"]
  node_app["Kivy app<br/>[main.py]"]
  node_home["System home<br/>[homepage.py]"]
  node_emulator_card["System card<br/>[emulator_card.py]"]
end

subgraph group_rom_library["ROM library"]
  node_game_list["Game list screen<br/>[gamelist.py]"]
  node_game_card["Game card<br/>[game_card.py]"]
end

subgraph group_profile["Profile"]
  node_profile_screen["Profile screen<br/>[profile.py]"]
  node_profile_select["Profile selector<br/>[profile_select.py]"]
  node_profile_card["Home profile card<br/>[profile_card.py]"]
end

subgraph group_emulation["Emulation placeholders"]
  node_emulator_core["Emulator core placeholder<br/>[emulator.py]"]
  node_gb["Game Boy placeholder<br/>[gb.py]"]
  node_gbc["Game Boy Color placeholder<br/>[gbc.py]"]
  node_gba["Game Boy Advance placeholder<br/>[gba.py]"]
  node_nds["Nintendo DS placeholder<br/>[nds.py]"]
  node_three_ds["Nintendo 3DS placeholder<br/>[3ds.py]"]
end

subgraph group_settings["Local settings"]
  node_rom_folder_settings["ROM folder settings<br/>[rom_folders.py]"]
  node_rom_folder_data["ROM folder data<br/>[rom_folders.json]"]
  node_profile_settings["Profile picture settings<br/>[profilepic.py]"]
  node_profile_data["Profile picture data<br/>[profilepic.json]"]
end

node_user(("User"))
node_rom_files["User ROM folder"]
node_profile_files["Image chooser"]

node_user -->|"launches"| node_app
node_app -->|"registers screen"| node_home
node_app -->|"registers screen"| node_game_list
node_app -->|"registers screen"| node_profile_screen
node_home -->|"creates cards"| node_emulator_card
node_home -->|"sets system"| node_game_list
node_home -->|"opens profile"| node_profile_screen
node_user -->|"selects system"| node_emulator_card
node_game_list -->|"gets folder"| node_rom_folder_settings
node_game_list -->|"saves folder"| node_rom_folder_settings
node_rom_folder_settings -->|"reads and writes"| node_rom_folder_data
node_game_list -->|"scans folder"| node_rom_files
node_game_list -->|"creates cards"| node_game_card
node_user -->|"selects game"| node_game_card
node_game_list -.->|"not applicable"| node_profile_select
node_profile_screen -->|"creates selector"| node_profile_select
node_profile_screen -->|"gets and sets picture"| node_profile_settings
node_profile_settings -->|"reads and writes"| node_profile_data
node_user -->|"opens profile"| node_profile_card
node_profile_screen -->|"opens chooser"| node_profile_files

click node_app "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/main.py"
click node_home "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/homepage.py"
click node_emulator_card "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/emulator_card.py"
click node_game_list "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/gamelist.py"
click node_game_card "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/game_card.py"
click node_rom_folder_settings "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/rom_folders.py"
click node_rom_folder_data "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/rom_folders.json"
click node_profile_screen "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/profile.py"
click node_profile_select "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/profile_select.py"
click node_profile_settings "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/profilepic.py"
click node_profile_data "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/profilepic.json"
click node_profile_card "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/profile_card.py"
click node_emulator_core "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Core/emulator.py"
click node_gb "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/Gameboys/gb.py"
click node_gbc "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/Gameboys/gbc.py"
click node_gba "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/GBA/gba.py"
click node_nds "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/NDS/nds.py"
click node_three_ds "https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/3DS/3ds.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_app,node_home,node_emulator_card,node_user,node_rom_files toneBlue
class node_game_list,node_game_card toneAmber
class node_profile_screen,node_profile_select,node_profile_card toneMint
class node_emulator_core,node_gb,node_gbc,node_gba,node_nds,node_three_ds toneRose
class node_rom_folder_settings,node_rom_folder_data,node_profile_settings,node_profile_data,node_profile_files toneIndigo
```

## Components

### App and navigation

- [Kivy app](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/main.py): `APP/main.py`
- [System home](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/homepage.py): `APP/UI/Screens/homepage.py`
- [System card](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/emulator_card.py): `APP/UI/Components/emulator_card.py`

### ROM library

- [Game list screen](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/gamelist.py): `APP/UI/Screens/gamelist.py`
- [Game card](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/game_card.py): `APP/UI/Components/game_card.py`

### Profile

- [Profile screen](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Screens/profile.py): `APP/UI/Screens/profile.py`
- [Profile selector](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/profile_select.py): `APP/UI/Components/profile_select.py`
- [Home profile card](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/UI/Components/profile_card.py): `APP/UI/Components/profile_card.py`

### Emulation placeholders

- [Emulator core placeholder](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Core/emulator.py): `Core/emulator.py`
- [Game Boy placeholder](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/Gameboys/gb.py): `Systems/Gameboys/gb.py`
- [Game Boy Color placeholder](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/Gameboys/gbc.py): `Systems/Gameboys/gbc.py`
- [Game Boy Advance placeholder](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/GBA/gba.py): `Systems/GBA/gba.py`
- [Nintendo DS placeholder](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/NDS/nds.py): `Systems/NDS/nds.py`
- [Nintendo 3DS placeholder](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/Systems/3DS/3ds.py): `Systems/3DS/3ds.py`

### Local settings

- [ROM folder settings](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/rom_folders.py): `APP/Settings/rom_folders.py`
- [ROM folder data](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/rom_folders.json): `APP/Settings/rom_folders.json`
- [Profile picture settings](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/profilepic.py): `APP/Settings/profilepic.py`
- [Profile picture data](https://github.com/joaovitoramaral27/omni-multi-emulator/blob/main/APP/Settings/profilepic.json): `APP/Settings/profilepic.json`

### Other components

- **User**
- **User ROM folder**
- **Image chooser**

## Connections

- User → Kivy app: launches (evidence: `APP/main.py`)
- Kivy app → System home: registers screen (evidence: `APP/main.py`)
- Kivy app → Game list screen: registers screen (evidence: `APP/main.py`)
- Kivy app → Profile screen: registers screen (evidence: `APP/main.py`)
- System home → System card: creates cards (evidence: `APP/UI/Screens/homepage.py`)
- System home → Game list screen: sets system (evidence: `APP/UI/Screens/homepage.py`)
- System home → Profile screen: opens profile (evidence: `APP/UI/Screens/homepage.py`)
- User → System card: selects system (evidence: `APP/UI/Components/emulator_card.py`)
- Game list screen → ROM folder settings: gets folder (evidence: `APP/UI/Screens/gamelist.py`)
- Game list screen → ROM folder settings: saves folder (evidence: `APP/UI/Screens/gamelist.py`)
- ROM folder settings → ROM folder data: reads and writes (evidence: `APP/Settings/rom_folders.py`)
- Game list screen → User ROM folder: scans folder (evidence: `APP/UI/Screens/gamelist.py`)
- Game list screen → Game card: creates cards (evidence: `APP/UI/Screens/gamelist.py`)
- User → Game card: selects game (evidence: `APP/UI/Components/game_card.py`)
- Game list screen → Profile selector: not applicable
- Profile screen → Profile selector: creates selector (evidence: `APP/UI/Screens/profile.py`)
- Profile screen → Profile picture settings: gets and sets picture (evidence: `APP/UI/Screens/profile.py`)
- Profile picture settings → Profile picture data: reads and writes (evidence: `APP/Settings/profilepic.py`)
- User → Home profile card: opens profile (evidence: `APP/UI/Components/profile_card.py`)
- Profile screen → Image chooser: opens chooser (evidence: `APP/UI/Screens/profile.py`)
