# rubenspj/citra-mmj architecture

> Architecture diagram of the GitHub repository rubenspj/citra-mmj, 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/rubenspj/citra-mmj
- Repository: https://github.com/rubenspj/citra-mmj

## Overview

Citra is a Nintendo 3DS emulator and debugger. In the desktop workflow, a user selects a game in the Qt frontend; the frontend starts and controls emulation through the core, which models CPU, memory, system services, and graphics hardware before rendering output. The repository also includes Android frontend code, audio, input, camera, filesystem, debugger, and multiplayer subsystems. The sampled excerpts confirm only a subset of their runtime connections, so uncertain links are dashed and uncited rather than presented as verified calls.

Main entry points: [`src/core/core.cpp`](https://github.com/rubenspj/citra-mmj/blob/master/src/core/core.cpp) (System Core), [`src/citra_qt/main.cpp`](https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/main.cpp) (Qt Frontend), [`src/citra_qt/bootmanager.cpp`](https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/bootmanager.cpp) (Emulation Window), [`src/android/app/src/main/java/org/citra/emu/ui/MainActivity.java`](https://github.com/rubenspj/citra-mmj/blob/master/src/android/app/src/main/java/org/citra/emu/ui/MainActivity.java) (Android Frontend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontends["User Frontends"]
  node_qt["Qt Frontend<br/>[main.cpp]"]
  node_boot["Emulation Window<br/>[bootmanager.cpp]"]
  node_android["Android Frontend<br/>[MainActivity.java]"]
end

subgraph group_emulation["Emulation Core"]
  node_core["System Core<br/>[core.cpp]"]
  node_memory["Virtual Memory<br/>[vm_manager.cpp]"]
  node_apt["Applet Manager<br/>[applet_manager.cpp]"]
  node_geometry["Geometry Pipeline"]
  node_video["OpenGL Resources"]
  node_settings["System Settings<br/>[settings.h]"]
  node_filesystem["Game Filesystem"]
end

subgraph group_devices["Device Systems"]
  node_input["Input Backends<br/>[main.cpp]"]
  node_android_input["Android Input<br/>[input_manager.cpp]"]
  node_audio["Audio System<br/>[hle.cpp]"]
end

subgraph group_features["Product Features"]
  node_debugger["Debug Tools<br/>[graphics.cpp]"]
  node_multiplayer["Multiplayer<br/>[room.cpp]"]
  node_netplay_ui["Multiplayer UI<br/>[state.h]"]
  node_camera["Camera Emulation<br/>[factory.cpp]"]
end

node_user(("Player"))

node_user -.->|"selects game"| node_qt
node_qt -->|"opens window"| node_boot
node_boot -->|"runs loop"| node_core
node_user -.->|"chooses game"| node_android
node_android -.->|"starts emulation"| node_core
node_core -.->|"uses memory"| node_memory
node_core -.->|"loads game data"| node_filesystem
node_core -->|"services applets"| node_apt
node_core -.->|"processes graphics"| node_geometry
node_geometry -.->|"feeds rendering"| node_video
node_qt -.->|"configures"| node_settings
node_qt -->|"initializes input"| node_input
node_input -.->|"registers devices"| node_android_input
node_core -.->|"emulates audio"| node_audio
node_qt -.->|"offers debugging"| node_debugger
node_qt -->|"offers multiplayer"| node_netplay_ui
node_netplay_ui -.->|"joins rooms"| node_multiplayer
node_core -.->|"provides camera"| node_camera

click node_qt "https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/main.cpp"
click node_boot "https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/bootmanager.cpp"
click node_android "https://github.com/rubenspj/citra-mmj/blob/master/src/android/app/src/main/java/org/citra/emu/ui/MainActivity.java"
click node_core "https://github.com/rubenspj/citra-mmj/blob/master/src/core/core.cpp"
click node_memory "https://github.com/rubenspj/citra-mmj/blob/master/src/core/hle/kernel/vm_manager.cpp"
click node_apt "https://github.com/rubenspj/citra-mmj/blob/master/src/core/hle/service/apt/applet_manager.cpp"
click node_geometry "https://github.com/rubenspj/citra-mmj/blob/master/src/video_core/geometry_pipeline.cpp"
click node_video "https://github.com/rubenspj/citra-mmj/blob/master/src/video_core/renderer_opengl/gl_resource_manager.cpp"
click node_settings "https://github.com/rubenspj/citra-mmj/blob/master/src/core/settings.h"
click node_input "https://github.com/rubenspj/citra-mmj/blob/master/src/input_common/main.cpp"
click node_android_input "https://github.com/rubenspj/citra-mmj/blob/master/src/android/jni/input_manager.cpp"
click node_audio "https://github.com/rubenspj/citra-mmj/blob/master/src/audio_core/hle/hle.cpp"
click node_filesystem "https://github.com/rubenspj/citra-mmj/blob/master/src/core/file_sys/archive_backend.cpp"
click node_debugger "https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/debugger/graphics/graphics.cpp"
click node_multiplayer "https://github.com/rubenspj/citra-mmj/blob/master/src/network/room.cpp"
click node_netplay_ui "https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/multiplayer/state.h"
click node_camera "https://github.com/rubenspj/citra-mmj/blob/master/src/core/frontend/camera/factory.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_qt,node_boot,node_android toneBlue
class node_core,node_memory,node_apt,node_geometry,node_video,node_settings,node_filesystem toneAmber
class node_input,node_android_input,node_audio toneMint
class node_debugger,node_multiplayer,node_netplay_ui,node_camera toneRose
class node_user toneIndigo
```

## Components

### User Frontends

- [Qt Frontend](https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/main.cpp): `src/citra_qt/main.cpp`
- [Emulation Window](https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/bootmanager.cpp): `src/citra_qt/bootmanager.cpp`
- [Android Frontend](https://github.com/rubenspj/citra-mmj/blob/master/src/android/app/src/main/java/org/citra/emu/ui/MainActivity.java): `src/android/app/src/main/java/org/citra/emu/ui/MainActivity.java`

### Emulation Core

- [System Core](https://github.com/rubenspj/citra-mmj/blob/master/src/core/core.cpp): `src/core/core.cpp`
- [Virtual Memory](https://github.com/rubenspj/citra-mmj/blob/master/src/core/hle/kernel/vm_manager.cpp): `src/core/hle/kernel/vm_manager.cpp`
- [Applet Manager](https://github.com/rubenspj/citra-mmj/blob/master/src/core/hle/service/apt/applet_manager.cpp): `src/core/hle/service/apt/applet_manager.cpp`
- [Geometry Pipeline](https://github.com/rubenspj/citra-mmj/blob/master/src/video_core/geometry_pipeline.cpp): `src/video_core/geometry_pipeline.cpp`
- [OpenGL Resources](https://github.com/rubenspj/citra-mmj/blob/master/src/video_core/renderer_opengl/gl_resource_manager.cpp): `src/video_core/renderer_opengl/gl_resource_manager.cpp`
- [System Settings](https://github.com/rubenspj/citra-mmj/blob/master/src/core/settings.h): `src/core/settings.h`
- [Game Filesystem](https://github.com/rubenspj/citra-mmj/blob/master/src/core/file_sys/archive_backend.cpp): `src/core/file_sys/archive_backend.cpp`

### Device Systems

- [Input Backends](https://github.com/rubenspj/citra-mmj/blob/master/src/input_common/main.cpp): `src/input_common/main.cpp`
- [Android Input](https://github.com/rubenspj/citra-mmj/blob/master/src/android/jni/input_manager.cpp): `src/android/jni/input_manager.cpp`
- [Audio System](https://github.com/rubenspj/citra-mmj/blob/master/src/audio_core/hle/hle.cpp): `src/audio_core/hle/hle.cpp`

### Product Features

- [Debug Tools](https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/debugger/graphics/graphics.cpp): `src/citra_qt/debugger/graphics/graphics.cpp`
- [Multiplayer](https://github.com/rubenspj/citra-mmj/blob/master/src/network/room.cpp): `src/network/room.cpp`
- [Multiplayer UI](https://github.com/rubenspj/citra-mmj/blob/master/src/citra_qt/multiplayer/state.h): `src/citra_qt/multiplayer/state.h`
- [Camera Emulation](https://github.com/rubenspj/citra-mmj/blob/master/src/core/frontend/camera/factory.cpp): `src/core/frontend/camera/factory.cpp`

### Other components

- **Player**

## Connections

- Player → Qt Frontend: selects game
- Qt Frontend → Emulation Window: opens window (evidence: `src/citra_qt/main.cpp`)
- Emulation Window → System Core: runs loop (evidence: `src/citra_qt/bootmanager.cpp`)
- Player → Android Frontend: chooses game
- Android Frontend → System Core: starts emulation
- System Core → Virtual Memory: uses memory
- System Core → Game Filesystem: loads game data
- System Core → Applet Manager: services applets (evidence: `src/core/hle/service/apt/applet_manager.cpp`)
- System Core → Geometry Pipeline: processes graphics
- Geometry Pipeline → OpenGL Resources: feeds rendering
- Qt Frontend → System Settings: configures
- Qt Frontend → Input Backends: initializes input
- Input Backends → Android Input: registers devices
- System Core → Audio System: emulates audio
- Qt Frontend → Debug Tools: offers debugging
- Qt Frontend → Multiplayer UI: offers multiplayer (evidence: `src/citra_qt/main.cpp`)
- Multiplayer UI → Multiplayer: joins rooms
- System Core → Camera Emulation: provides camera
