Home | Citra Custom Layout

The goal of this site is to enable Citra (Nintendo 3DS Emulator) users more control over the emulated top & bottom screen positions with respect to any monitor size. Examples of generated layouts can be seen in the 'Gallery', the following are some use cases:

Separate the emulated screens with the landscape layout and a pixel gap.
- Similar to Citra's 'Default' layout but the screens aren't connected.
Set the bottom screen's scale & position for the Side by Side layout.
- Minimum scale & bottom position will look like Citra's 'Large Screen' layout.
- Medium scale & center position is the median scale amount of Minimum & Maximum. Bottom screen is placed midway through the top screen.
- Maximum scale is similar to Citra's 'Side by Side' layout.
Using the portrait layout on a display that can rotate (Screenshot).
- Larger emulated screens due to more display height to fill in.

Gallery

Display Resolution

1920x1080

2560x1440

3840x2160

Custom

Layout

Pixel Gap

Bottom Scale

Bottom Position

Overlap Screens

Citra Version

Choose a resolution in 'Display Resolution', select Custom if not listed.
Pick the layout for the emulated 3DS screens in 'Layout':
- 'Landscape' for screens to be stacked vertically.
- 'Side by Side' screens are horizontally adjacent to each other, with options to change the screen scale & position (top, center, bottom) or overlap the screens on top of each other.
  - Minimum: sets the bottom screen resolution to its original size (320x240), the rest of the space is filled in by the top screen.
  - Medium: the average of 'Minimum' & 'Maximum' scaling.
  - Maximum: both screens are scaled by the same amount, meaning they have the same height.
  - Overlap screens: place the bottom screen over the top screen, optimizing the top screen width/height.
- 'Portrait' for screens to be correctly stacked vertically on tall displays (ex. smartphone or a PC monitor that can rotate).
Select the version of Citra being used, Official & MMJ are supported.
Click 'Generate' and copy the text from 'Custom Layout Output'
Open the config file
- Windows: %appdata%/Citra/config/qt-config.ini
- Mac / Linux: ~/.local/share/citra-emu/config/qt-config.ini
- Android (Official): citra-emu/config/config.ini
- Android (MMJ): citra-emu/config/config-mmj.ini
If 'custom_layout\default' is true, change it to false. This will allow custom layouts, it's located in the 'Layout' section.
Replace 'custom_layout = true' until the end of the section.
- Example
Save the file and run Citra!
- Citra must be in full-screen for the layout to be accruate.

Custom Layout Output

(error message)