hub / github.com/amwatson/CitraVR

github.com/amwatson/CitraVR @playtest02.17.2024

repository ↗ · DeepWiki ↗ · release playtest02.17.2024 ↗ · + Follow

12,633 symbols 29,376 edges 1,276 files 1,248 documented · 10% ● updated 16d agov0.5.2 · 2026-06-29★ 89328 open issues

Browse by type

⨍ Functions 9,569◇ Types & classes 3,064

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

(Beta)

Play 3DS homebrew and personal game backups in 3D on the go with your Quest. CitraVR is a GPL-licensed, engineless OpenXR application with all source code publicly available.

Introduction

I originally created this project to a be a proof-of-concept of some techniques XR developers were curious about. Specifically: - Building a 2D/3D hybrid app - Creating a VR app to render 2D interactive windows without an engine - Using VR layers to get sharp, crisp text and visuals.

A Quest-native (i.e. OpenXR, without a third-party game engine) port of the Citra 3DS emulator Seemed like a great and fun way to demonstrate all these things at once.

The project is still small, but I'm looking for ways to improve it as time goes on.

Features

Stereoscopic rendering
Broad controller support
Large, moveable/resizeable screen
Playable in mixed reality
Low-overhead port
Fully GPL-licensed, 100% independent of the Meta SDK

Compatibillty

HMDs

CitraVR supports the following devices: - Meta Quest 2 - Meta Quest Pro - Meta Quest 3

Games

For a full list of games that work well on CitraVR, please visit the CitraVR Game Compatability List

Controllers/Input

Touch Controller Input Bindings Diagram

For games that need access to more inputs, or if a player needs to access more inputs faster, CitraVR also supports a multitude of 3rd party wired USB and wireless bluetooth controllers.

Releases

Grab the latest release here

Known Issues

See the CitraVR Known Issues

How to Install and Run

Building

Building for Quest

Discord

Join the Flat2VR discord and from there join cvr-join to get access to the CitraVR community and support forums

Need Help?

Please check our Troubleshooting and Known Issues pages to see if your issue is listed. To file a bug report or a feature request, please submit an issue. Otherwise, follow the instructions for Discord and post in cvr-support

Support

Buy me a beer

You can also buy the original (non-VR) Citra project a beer

License

CitraVR is licensed under the GPLv3 (or any later version). Refer to the LICENSE.txt file.

Extension points exported contracts — how you extend this code

SettingsFragmentView (Interface)

* Abstraction for a screen showing a list of settings. Instances of * this type of view will each display a layer of th

src/android/app/src/main/java/org/citra/citra_emu/features/settings/ui/SettingsFragmentView.kt

SettingsActivityView (Interface)

* Abstraction for the Activity that manages SettingsFragments. */

src/android/app/src/main/java/org/citra/citra_emu/features/settings/ui/SettingsActivityView.kt

ButtonConfig (Interface)

Corresponds to Frontend::ButtonConfig

src/android/app/src/main/java/org/citra/citra_emu/applets/SoftwareKeyboard.kt

CopyDirListener (Interface)

(no doc)

src/android/app/src/main/java/org/citra/citra_emu/utils/FileUtil.kt

Listener (Interface)

(no doc)

src/android/app/src/main/java/org/citra/citra_emu/fragments/CitraDirectoryDialogFragment.kt

Core symbols most depended-on inside this repo

Push

called by 1165

src/core/hle/ipc_helpers.h

data

called by 1002

src/core/file_sys/patch.cpp

size

called by 951

src/core/file_sys/patch.cpp

load

called by 938

src/common/serialization/atomic.h

MakeBuilder

called by 843

src/core/hle/ipc_helpers.h

GetValue

called by 464

src/core/hle/service/nfc/nfc_types.h

src/common/bit_field.h

Shape

Method 7,459

Class 2,655

Function 2,110

Enum 396

Interface 13

Languages

C++91%

Kotlin8%

C1%

Python1%

Modules by API surface

externals/json/json.hpp573 symbols

externals/httplib/httplib.h383 symbols

src/core/arm/dyncom/arm_dyncom_trans.cpp162 symbols

src/citra_qt/main.cpp134 symbols

externals/microprofile/microprofile.h127 symbols

src/core/hle/service/apt/apt.cpp90 symbols

src/core/hle/kernel/svc.cpp89 symbols

src/core/hle/service/am/am.cpp84 symbols

src/input_common/sdl/sdl_impl.cpp82 symbols

externals/microprofile/microprofileui.h81 symbols

src/core/hle/service/soc/soc_u.cpp77 symbols

src/android/app/src/main/java/org/citra/citra_emu/NativeLibrary.kt74 symbols

For agents

$ claude mcp add CitraVR \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact