3DS:Luma3DS/Rosalina: Difference between revisions

Revision as of 04:00, 25 September 2022

Rosalina is a system module for Luma3DS that can be accessed while your 3DS is powered on and in 3DS mode by pressing a keycombo specified in the file SD://luma/config.ini. By default, the keycombo is L + ↓ + Select.

Rosalina is not accessible from within payloads (such as GodMode9), from DS/DSi mode (such as when using a DS cartridge or when using TWiLightMenu++), or from GBA mode (such as when using GBA virtual console).

This menu offers many options for real-time configuration of the system, including but not limited to the following:

Take screenshots
Change system settings such as brightness, active cheats, wireless status, and clock speed & L2 cache (New 3DS/2DS only)
Activate a blue light filter

Our custom firmware installation guide uses the Rosalina menu for multiple functions. This page will contain explanations for all the options and information present in the Rosalina menu to enable easier navigation and usage.

Opening and navigating the Rosalina Menu

If your (L), (D-Pad Down), or (Select) keys are broken, you will not be able to open the Rosalina menu by default. To fix this, modify the SD://luma/config.ini file by editing the variable rosalina_menu_keycombo to two or more keys that work for you, such as X+Y. If you do not see the config.ini, update Luma3DS to version 11.0 or newer.

You can access Rosalina by pressing your chosen keycombo while in most areas of the system, excluding the following:

Safe Mode (can be bypassed, read Luma3DS Configuration for more details)
DS and GBA games, and homebrew that enters these modes (TWiLightMenu++ being a notable example)

Once in the Rosalina menu, use (D-Pad Up) and (D-Pad Down) to navigate the options. Press (A) to choose/enable/disable an option or view a submenu. Once in a submenu, press B to return to the main menu. The currently highlighted option is denoted by a > to the left of its text - the option highlighted when you first open the menu is Take screenshot.

Once you are done changing options, press B until you exit Rosalina and return to the system.

Rosalina Options

Take Screenshot

Takes a screenshot of both screens' content and saves it to SD://luma/screenshots as two .bmp files. Activates immediately after being pressed.

Change screen brightness

Shows the current luminance of the screen and allows you to change it with the D-Pad - (D-Pad Up) and (D-Pad Down) increment by 1, (D-Pad Left) and (D-Pad Right) increment by 10. The change in luminance takes effect instantly, including inside Rosalina. Note that any action that restarts the system or enters a place where Rosalina cannot function will reset brightness to the last chosen preset.

Cheats...

When inside a title where cheats have been selected for use (either through Checkpoint or through manually adding them to Luma, this menu shows the selected cheats. Press A on a cheat to change the ( ) to a (x), at which point they will be activated when you leave Rosalina. If the title you are currently in has no cheats selected for it, the menu will instead display No suitable title found.

Plugin Loader

This option is only usable on the Luma3DS 3GX Loader fork of Luma.

When enabled, this option will allow for the use of .3GX plugins in games.

Process list

Be very careful when editing system memory, as unintended consequences may happen.

Shows a list of all system processes currently running, and allows you to view & edit their memory by pressing A on a process name.

Debugger options...

This option can potentially cause system instability or even crashes - don't use it unless you know what you're doing and why.

Allows you to enable/disable a debugger for apps, including forcibly debugging the next application launched. Also shows the system's local IP address in Rosalina while enabled.

System configuration...

Allows you to control various elements of the system's hardware.

Control Wireless connection

Forcibly enables a connection to a chosen WiFi slot - once active, this connection will not drop unless the signal becomes unavailable until manually disabled.

Toggle LEDs

Disables the power LED and wireless LED until re-enabled manually or the system is closed while in the POWER button menu. The menu states that entering sleep mode by closing the system will always reset the LED state, but this is erroneous.

Toggle Wireless

Turns off the 3DS' ability to connect to WiFi networks. While toggled off, this stops Control Wireless connection from connecting to a slot. This setting's chosen option is saved and reapplied on next boot automatically.

Toggle power button

Turns off the power button's ability to enter the power-off menu. While disabled, the power button can still be held for ~7 seconds to forcibly power off the system.

Toggle power to card slot

Turns off the 3DS' ability to read cartridges while active. This prevents the passive power drain from having a cartridge inserted, but requires you re-enable this setting or remove and reinsert the cartridge to be able to play it again.

Screen filters

Allows you to enable a blue-light filter with settings at certain degrees Kelvin, the default setting being 6500K and the range being from 1200K-10000K - if edited through config.ini instead, the range is 1000K-25100K. This setting's chosen option will be saved and applied on boot if you choose Save settings under Miscellaneous options... or edit it via the config.ini.

New 3DS Menu...

This option can only be used on a New 3DS/2DS.

Allows you to manually change how much CPU and L2 cache is given to the active title - this can also be changed in Luma3DS Configuration for all games. Enabling both extra clock speed and L2 cache may reveal hidden bugs in games, to unknown effect.

Miscellaneous options...

Allows for various system tweaks. Three of these, which will be noted as they appear for reference, are used on our custom firmware installation guide.

Switch the hb. title to the current app.

When inside a title, modifies its icon on the Home Menu to open the Homebrew Menu instead until another title is chosen or the system reboots. This is used in our custom firmware guide to switch Download Play to the Homebrew Menu, though most system apps will work for this purpose and it is unneeded after the Homebrew Launcher Wrapper is installed.

Change the menu combo

Changes the keycombo used to access Rosalina. The change will not be preserved across a reboot unless you use the Save settings button.

Start InputRedirection

Starts the InputRedirection service to allow for the use of external controllers.

Update date and time via NTP

Connects to a time server to remotely sync the 3DS' date and time, after a UTC offset in the form of+0000 is chosen. The chosen time zone can be saved to Luma3DS Configuration via the Save settings option.

Nullify user time offset

Changes the 3DS' current date and time to match the embedded RTC clock. This is done in our custom firmware guide as a part of Finalizing Setup.

Dump DSP firmware

Copies the file dspfirm.cdc to SD://3ds to allow homebrew apps to use the 3ds' audio. This is done in our custom firmware guide as a part of Finalizing Setup.

Save settings

Saves the current NTP time zone, the active screen filter, and any changes to the Rosalina keycombo to SD://luma/config.ini.

Power off

After a confirmation, powers off your console. The console takes longer to fully shut down this way compared to doing it from the POWER button menu, but this has the advantage of being faster to access.

Reboot

After a confirmation, reboots your console. This is notably faster than both the Power off Rosalina option and manually rebooting via the POWER button.

Credits

Displays a credits page for the creation of Luma3DS and all its contributors.

Rosalina Info

In addition to system functionality, Rosalina also displays multiple pieces of system information. At the bottom of the Rosalina menu, in order from left-to-right, the following are displayed:

The Luma3DS version number

Unlike the Luma3DS configuration menu, this will not display the full commit name for Luma3DS forks

The current battery temperature, in C°
The current battery voltage
The current charge percentage, displayed to the nearest 0.1%

@@ Line 1: / Line 1: @@
-{{hatnote|1=This article is about Rosalina, accessible when booted into the HOME Menu. For information about the Luma3DS configuration menu (accessible by holding SELECT on boot), see [[3DS:Luma3DS/Configuration|this page]].}}
+{{hatnote|1=This article is about Rosalina, accessible when booted into HOME Menu. For information about the Luma3DS configuration menu (accessible by holding SELECT on boot), see [[3DS:Luma3DS/Configuration|Luma3DS/Configuration]].}}
-Rosalina is a system module for Luma3DS that can be accessed while your 3DS is powered on and in 3DS mode by pressing a keycombo specified in the file <code>sd:/luma/config.ini</code>. By default, the keycombo is {{B|L}} + {{B|Down}} + {{B|Select}}.
+Rosalina is a system module for Luma3DS that can be accessed while your 3DS is powered on and in 3DS mode by pressing a keycombo specified in the file <code>SD://luma/config.ini</code>. By default, the keycombo is {{B|L}} + {{B|Down}} + {{B|Select}}.
 Rosalina is ''not'' accessible from within payloads (such as GodMode9), from DS/DSi mode (such as when using a DS cartridge or when using TWiLightMenu++), or from GBA mode (such as when using GBA virtual console).
@@ Line 7: / Line 7: @@
 This menu offers many options for real-time configuration of the system, including but not limited to the following:
 * Take screenshots
-* Change system settings such as brightness, active cheats, wireless status, and (on New 3DS/2DS only) clock speed & L2 cache
+* Change system settings such as brightness, active cheats, wireless status, and clock speed & L2 cache (New 3DS/2DS only)
 * Activate a blue light filter
@@ Line 13: / Line 13: @@
 ==Opening and navigating the Rosalina Menu==
-{{info|If your {{B|L}}, {{B|D-Pad Down}}, or {{B|Select}} keys are broken, you will not be able to open the Rosalina menu by default. To fix this, modify the <code>sd:/luma/config.ini</code> file by editing the variable <code>rosalina_menu_keycombo</code> to two or more keys that work for you, such as <code>X+Y</code>. If you do not see the <code>config.ini</code>, [[3dsguide:checking-for-cfw|update Luma3DS to version 11.0 or newer]].}}
+{{info|If your (L), (D-Pad Down), or (Select) keys are broken, you will not be able to open the Rosalina menu by default. To fix this, modify the <code>SD://luma/config.ini</code> file by editing the variable <code>rosalina_menu_keycombo</code> to two or more keys that work for you, such as <code>X+Y</code>. If you do not see the <code>config.ini</code>, [[3dsguide:checking-for-cfw|update Luma3DS to version 11.0 or newer]].}}
 You can access Rosalina by pressing your chosen keycombo while in most areas of the system, excluding the following:
@@ Line 19: / Line 19: @@
 * DS and GBA games, and homebrew that enters these modes ([[3DS:DS games#TwilightMenu++|TWiLightMenu++]] being a notable example)
-Once in the Rosalina menu, use {{B|D-Pad Up}} and {{B|D-Pad Down}} to navigate the options. Press {{B|A}} to choose/enable/disable an option or view a submenu. Once in a submenu, press B to return to the main menu. The currently highlighted option is denoted by a <code>></code> to the left of its text - the option highlighted when you first open the menu is <code>Take screenshot</code>.
+Once in the Rosalina menu, use (D-Pad Up) and (D-Pad Down) to navigate the options. Press (A) to choose/enable/disable an option or view a submenu. Once in a submenu, press B to return to the main menu. The currently highlighted option is denoted by a <code>></code> to the left of its text - the option highlighted when you first open the menu is <code>Take screenshot</code>.
-While the Rosalina menu is launched, whatever is actively will pause until you exit the Rosalina menu. If you are playing a game online, this will cause your session to disconnect.
+Once you are done changing options, press B until you exit Rosalina and return to the system.
-Once you are done changing options, press B until you exit Rosalina and return to the system, unpausing what is currently running.
 ==Rosalina Options==
 ===Take Screenshot===
-Takes a screenshot of both screens' content and saves it to <code>sd:/luma/screenshots</code> as two <code>.bmp</code> files. Activates immediately after being pressed.
+Takes a screenshot of both screens' content and saves it to <code>SD://luma/screenshots</code> as two <code>.bmp</code> files. Activates immediately after being pressed.
-===Screen filters...===
+===Change screen brightness===
-Allows you to enable a blue-light filter with settings at certain degrees Kelvin, the default setting being 6500K and the range being from 1200K-10000K - if edited through <code>Advanced configuration...</code> instead, the range is 1000K-25100K. The <code>Enhance (top/bottom) screen colors</code> option edits the screens color curve for IPS displays to be more in-line with normal sRGB displays. The <code>Advanced configuration...</code> option also allows you to edit other values; gamma range 0.00-8.00, contrast range 0.00-255.00, brightness range -1.00-1.00, or invert colors. This setting's chosen option will not be saved and applied on boot unless you select the <code>Save settings</code> option or edit it via the <code>config.ini</code>.
+Shows the current luminance of the screen and allows you to change it with the D-Pad - (D-Pad Up) and (D-Pad Down) increment by 1, (D-Pad Left) and (D-Pad Right) increment by 10. The change in luminance takes effect instantly, including inside Rosalina. Note that any action that restarts the system or enters a place where Rosalina cannot function will reset brightness to the last chosen preset.
 ===Cheats...===
-When inside a title where cheats have been selected for use (either through [[Checkpoint]] or through {{GitHub|LumaTeam/Luma3DS/wiki/Cheat-Engine|manually adding them to Luma}}, this menu shows the selected cheats. Press A on a cheat to change the <code>( )</code> to a <code>(x)</code>, at which point they will be activated when you leave Rosalina.
+When inside a title where cheats have been selected for use (either through [[Checkpoint]] or through [https://github.com/LumaTeam/Luma3DS/wiki/Cheat-Engine manually adding them to Luma], this menu shows the selected cheats. Press A on a cheat to change the <code>( )</code> to a <code>(x)</code>, at which point they will be activated when you leave Rosalina.
 If the title you are currently in has no cheats selected for it, the menu will instead display <code>No suitable title found</code>.
 ===Plugin Loader===
+{{info|This option is only usable on the [[3DS:Luma3DS_forks|Luma3DS 3GX Loader fork]] of Luma.}}
 When enabled, this option will [[3DS:Game plugins/3GX|allow for the use of .3GX plugins in games.]]
-===New 3DS Menu...===
-{{info|This option can only be used on a New 3DS/2DS.}}
-A menu with New 3DS specific hardware and software options. Allows you to manually change how much CPU and L2 cache is given to the active title - this can also be changed in Luma3DS Configuration for all games. Enabling both extra clock speed and L2 cache may reveal hidden bugs in games, to unknown effect. Allows you to temporarily disable Super-Stable 3D; permanent disabling can still be done in System Settings. You can also test parallax barrier positions, or calibrate Super-Stable 3D's center position.
 ===Process list===
@@ Line 55: / Line 50: @@
 ===System configuration...===
 Allows you to control various elements of the system's hardware.
-====Control volume====
-Allows you to set the volume of the console, overriding the physical volume slider. Because Luma3DS only directly affects NATIVE_FIRM, this will not work in DS games, GBA games, payloads such as GodMode9, or [[3DS:Safe Mode|Safe Mode]].
 ====Control Wireless connection====
@@ Line 64: / Line 56: @@
 ====Toggle LEDs====
 {{Section WIP|notes=Make sure the list of disabled LEDs is accurate, and verify if the info regarding closing the system is actually erroneous or just bugged on one system.}}
-When first pressed, disables the power LED and wireless LED until re-enabled manually or the system is closed while in the POWER button menu. The menu states that entering sleep mode by closing the system will always reset the LED state, but this is erroneous.
+Disables the power LED and wireless LED until re-enabled manually or the system is closed while in the POWER button menu. The menu states that entering sleep mode by closing the system will always reset the LED state, but this is erroneous.
 ====Toggle Wireless====
-Toggles the 3DS' ability to connect to WiFi networks. While toggled off, this stops <code>Control Wireless connection</code> from connecting to a slot. This setting's chosen option is saved and reapplied on next boot automatically.
+Turns off the 3DS' ability to connect to WiFi networks. While toggled off, this stops <code>Control Wireless connection</code> from connecting to a slot. This setting's chosen option is saved and reapplied on next boot automatically.
 ====Toggle power button====
-Toggles the power button's ability to enter the power-off menu. While toggled off, the power button can still be held for ~7 seconds to forcibly power off the system.
+Turns off the power button's ability to enter the power-off menu. While disabled, the power button can still be held for ~7 seconds to forcibly power off the system.
 ====Toggle power to card slot====
-Toggles the 3DS' ability to read cartridges while active. This prevents the passive power drain from having a cartridge inserted, but requires you re-enable this setting or remove and reinsert the cartridge to be able to play it again.
+Turns off the 3DS' ability to read cartridges while active. This prevents the passive power drain from having a cartridge inserted, but requires you re-enable this setting or remove and reinsert the cartridge to be able to play it again.
+===Screen filters===
+Allows you to enable a blue-light filter with settings at certain degrees Kelvin, the default setting being 6500K and the range being from 1200K-10000K - if edited through <code>config.ini</code> instead, the range is 1000K-25100K. This setting's chosen option will be saved and applied on boot if you choose <code>Save settings</code> under <code>Miscellaneous options...</code> or edit it via the <code>config.ini</code>.
-====Change screen brightness====
+===New 3DS Menu...===
-Shows the current luminance of the screen and allows you to change it with the D-Pad - {{B|D-Pad Up}} and {{B|D-Pad Down}} increment by 1, {{B|D-Pad Left}} and {{B|D-Pad Right}} increment by 10. The change in luminance takes effect instantly, including inside Rosalina. Note that any action that restarts the system or enters a place where Rosalina cannot function will reset brightness to the last chosen preset.
+{{info|This option can only be used on a New 3DS/2DS.}}
+Allows you to manually change how much CPU and L2 cache is given to the active title - this can also be changed in Luma3DS Configuration for all games. Enabling both extra clock speed and L2 cache may reveal hidden bugs in games, to unknown effect.
 ===Miscellaneous options...===
@@ Line 82: / Line 78: @@
 ====Switch the hb. title to the current app.====
-When inside a title, changes the active title's HOME Menu icon to open the Homebrew Launcher instead until another title is chosen or the system reboots. This is used in our custom firmware guide as a part of [[3dsguide:finalizing-setup|Finalizing Setup]] to access the Homebrew Launcher, though most system apps will work for this purpose and it is unneeded after the Homebrew Launcher Wrapper is installed.
+When inside a title, modifies its icon on the Home Menu to open the Homebrew Menu instead until another title is chosen or the system reboots. This is used in our custom firmware guide to switch Download Play to the Homebrew Menu, though most system apps will work for this purpose and it is unneeded after the Homebrew Launcher Wrapper is installed.
 ====Change the menu combo====
@@ Line 94: / Line 90: @@
 ====Nullify user time offset====
-Changes the embedded RTC clock to match the 3DS' current date and time (RTC + user time offset), then sets the offset to 0. This is done in our custom firmware guide as a part of [[3dsguide:finalizing-setup|Finalizing Setup]].
+Changes the 3DS' current date and time to match the embedded RTC clock. This is done in our custom firmware guide as a part of Finalizing Setup.
 ====Dump DSP firmware====
-Copies the file <code>dspfirm.cdc</code> to <code>sd:/3ds</code> to allow homebrew apps to use the 3ds' audio. This is done in our custom firmware guide as a part of [[3dsguide:finalizing-setup|Finalizing Setup]].
+Copies the file <code>dspfirm.cdc</code> to <code>SD://3ds</code> to allow homebrew apps to use the 3ds' audio. This is done in our custom firmware guide as a part of Finalizing Setup.
-===Save settings===
+====Save settings====
-Saves the current NTP time zone, the active screen filter, and any changes to the Rosalina keycombo to <code>sd:/luma/config.ini</code>.
+Saves the current NTP time zone, the active screen filter, and any changes to the Rosalina keycombo to <code>SD://luma/config.ini</code>.
-===Power off / reboot===
+===Power off===
-After a confirmation button press, powers off ({{B|A}}) or reboot ({{B|Y}}) your console. Note that powering off this way takes longer to fully shut down compared to doing it from the POWER button menu, however the reboot option takes far less time than both the <code>Power off</code> Rosalina option and manually rebooting via the POWER button.
+After a confirmation, powers off your console. The console takes longer to fully shut down this way compared to doing it from the POWER button menu, but this has the advantage of being faster to access.
-===System info===
+===Reboot===
-Displays various system info including: screen type (top and bottom), [[3dbrew:FIRM#NATIVE_FIRM|Kernel version]], [[3dbrew:MCU_Services#MCU_firmware_versions|MCU FW version]], PMIC vendor, and Battery vendor.
+After a confirmation, reboots your console. This is notably faster than both the <code>Power off</code> Rosalina option and manually rebooting via the POWER button.
 ===Credits===
@@ Line 116: / Line 112: @@
 * The Luma3DS version number
 :* Unlike the Luma3DS configuration menu, this will not display the full commit name for [[3DS:Luma3DS forks|Luma3DS forks]]
-* The current battery temperature, in °C
+* The current battery temperature, in C°
 * The current battery voltage
 * The current charge percentage, displayed to the nearest 0.1%
-[[Category:Nintendo 3DS information]]