# noword/emu4vitaplus architecture

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

- Interactive diagram: https://gitdiagram.com/noword/emu4vitaplus
- Repository: https://github.com/noword/emu4vitaplus

## Overview

Emu4Vita++ is a PlayStation Vita Libretro emulator frontend. Its principal workflow is selecting a console/core, browsing to a ROM, and launching it into the emulator; gameplay then uses the frontend’s input, audio, video, and state features. The graph also preserves documented extras such as favorites, cheats, shaders/overlays, BIOS checks, and achievements. Some subsystem links are documented capabilities rather than sampled calls; those are cited to the README, and unsampled implementation details are not inferred.

Main entry points: [`frontend/source/emu/emulator.cpp`](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/emulator.cpp) (Libretro emulator), [`frontend/source/ui/tabs/tab_browser.cpp`](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/ui/tabs/tab_browser.cpp) (ROM browser), [`arch/source/app.cpp`](https://github.com/noword/emu4vitaplus/blob/master/arch/source/app.cpp) (Core selector), [`frontend/source/emu/archive_manager.cpp`](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/archive_manager.cpp) (Archive access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_selection["Core selection"]
  node_arch["Core selector<br/>[app.cpp]"]
  node_core_button["Core entries<br/>[core_button.cpp]"]
end

subgraph group_frontend["Frontend navigation"]
  node_frontend_app["Frontend app<br/>[app.cpp]"]
  node_browser["ROM browser<br/>[tab_browser.cpp]"]
  node_favorites[("Favorites<br/>[favorite.cpp]")]
  node_archives["Archive access"]
  node_archive_readers["Archive readers"]
  node_configuration[("Configuration<br/>[config.cpp]")]
end

subgraph group_runtime["Emulation runtime"]
  node_emulator["Libretro emulator<br/>[emulator.cpp]"]
  node_input["Controller input<br/>[input.cpp]"]
  node_video["Video output<br/>[video.cpp]"]
  node_audio["Audio output<br/>[audio.cpp]"]
end

subgraph group_features["Gameplay features"]
  node_save_states[("Save states<br/>[state_manager.cpp]")]
  node_cheats["Cheats<br/>[cheat.cpp]"]
  node_graphics["Shaders and overlays<br/>[shader.cpp]"]
  node_bios["BIOS checks<br/>[bios_checker.cpp]"]
  node_achievements["Achievements"]
  node_network["Network services<br/>[network.cpp]"]
end

node_user(("Player"))

node_user -->|"selects core"| node_arch
node_arch -->|"shows entries"| node_core_button
node_user -->|"chooses ROM"| node_browser
node_browser -->|"launches game"| node_emulator
node_browser -->|"updates favorites"| node_favorites
node_browser -.->|"opens archive ROM"| node_archives
node_archives -->|"extracts entries"| node_archive_readers
node_frontend_app -->|"loads settings"| node_configuration
node_emulator -.->|"polls controls"| node_input
node_emulator -.->|"produces frames"| node_video
node_emulator -.->|"produces audio"| node_audio
node_user -->|"manages states"| node_save_states
node_save_states -->|"serializes core"| node_emulator
node_user -->|"edits cheats"| node_cheats
node_user -->|"configures graphics"| node_graphics
node_user -->|"checks BIOS"| node_bios
node_user -.->|"uses achievements"| node_achievements
node_user -.->|"uses network"| node_network

click node_arch "https://github.com/noword/emu4vitaplus/blob/master/arch/source/app.cpp"
click node_core_button "https://github.com/noword/emu4vitaplus/blob/master/arch/source/core_button.cpp"
click node_frontend_app "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/app.cpp"
click node_browser "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/ui/tabs/tab_browser.cpp"
click node_favorites "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/favorite.cpp"
click node_archives "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/archive_manager.cpp"
click node_archive_readers "https://github.com/noword/emu4vitaplus/blob/master/share/source/archive_reader_factory.cpp"
click node_configuration "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/config.cpp"
click node_emulator "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/emulator.cpp"
click node_input "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/input.cpp"
click node_video "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/video/video.cpp"
click node_audio "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/audio/audio.cpp"
click node_save_states "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/state_manager.cpp"
click node_cheats "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/cheat.cpp"
click node_graphics "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/shader.cpp"
click node_bios "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/bios_checker.cpp"
click node_achievements "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/retro_achievements/retro_achievements.cpp"
click node_network "https://github.com/noword/emu4vitaplus/blob/master/frontend/source/network.cpp"

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_arch,node_core_button toneBlue
class node_frontend_app,node_browser,node_favorites,node_archives,node_archive_readers,node_configuration toneAmber
class node_emulator,node_input,node_video,node_audio toneMint
class node_save_states,node_cheats,node_graphics,node_bios,node_achievements,node_network toneRose
class node_user toneIndigo
```

## Components

### Core selection

- [Core selector](https://github.com/noword/emu4vitaplus/blob/master/arch/source/app.cpp): `arch/source/app.cpp`
- [Core entries](https://github.com/noword/emu4vitaplus/blob/master/arch/source/core_button.cpp): `arch/source/core_button.cpp`

### Frontend navigation

- [Frontend app](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/app.cpp): `frontend/source/app.cpp`
- [ROM browser](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/ui/tabs/tab_browser.cpp): `frontend/source/ui/tabs/tab_browser.cpp`
- [Favorites](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/favorite.cpp): `frontend/source/favorite.cpp`
- [Archive access](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/archive_manager.cpp): `frontend/source/emu/archive_manager.cpp`
- [Archive readers](https://github.com/noword/emu4vitaplus/blob/master/share/source/archive_reader_factory.cpp): `share/source/archive_reader_factory.cpp`
- [Configuration](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/config.cpp): `frontend/source/config.cpp`

### Emulation runtime

- [Libretro emulator](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/emulator.cpp): `frontend/source/emu/emulator.cpp`
- [Controller input](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/input.cpp): `frontend/source/emu/input.cpp`
- [Video output](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/video/video.cpp): `frontend/source/emu/video/video.cpp`
- [Audio output](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/emu/audio/audio.cpp): `frontend/source/emu/audio/audio.cpp`

### Gameplay features

- [Save states](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/state_manager.cpp): `frontend/source/state_manager.cpp`
- [Cheats](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/cheat.cpp): `frontend/source/cheat.cpp`
- [Shaders and overlays](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/shader.cpp): `frontend/source/shader.cpp`
- [BIOS checks](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/bios_checker.cpp): `frontend/source/bios_checker.cpp`
- [Achievements](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/retro_achievements/retro_achievements.cpp): `frontend/source/retro_achievements/retro_achievements.cpp`
- [Network services](https://github.com/noword/emu4vitaplus/blob/master/frontend/source/network.cpp): `frontend/source/network.cpp`

### Other components

- **Player**

## Connections

- Player → Core selector: selects core (evidence: `README.md`)
- Core selector → Core entries: shows entries (evidence: `arch/source/app.cpp`)
- Player → ROM browser: chooses ROM (evidence: `README.md`)
- ROM browser → Libretro emulator: launches game (evidence: `README.md`)
- ROM browser → Favorites: updates favorites (evidence: `README.md`)
- ROM browser → Archive access: opens archive ROM
- Archive access → Archive readers: extracts entries (evidence: `frontend/source/emu/archive_manager.cpp`)
- Frontend app → Configuration: loads settings (evidence: `frontend/source/app.cpp`)
- Libretro emulator → Controller input: polls controls
- Libretro emulator → Video output: produces frames
- Libretro emulator → Audio output: produces audio
- Player → Save states: manages states (evidence: `README.md`)
- Save states → Libretro emulator: serializes core (evidence: `frontend/source/state_manager.cpp`)
- Player → Cheats: edits cheats (evidence: `README.md`)
- Player → Shaders and overlays: configures graphics (evidence: `README.md`)
- Player → BIOS checks: checks BIOS (evidence: `README.md`)
- Player → Achievements: uses achievements
- Player → Network services: uses network
