App Details
Notice: This is a fairly large package, so it may take some time to download! Therefore, in order to keep file sizes down, this package contains only six cores: melonds, mgba, gambatte, mupen64plus_next, snes9x, and nestopia. For other cores, use the built-in Online Updater. For more themes, use the built-in Online Updater.
Additionally, if you are seeing asset/icon issues with your theme, try: Main menu -> online updater -> update assets, and restarting.
Courtesy of m4xw
----------------------------------------------------
For more information regarding RetroArch, the location/names of BIOS files, and compatibility with ROMs, please refer to the official Libretro documentation at:
https://docs.libretro.com/
Use the sidebar under "Core Documentation" to read more about the core you're looking for.
F.A.Q.
Q: My Switch has crashed/softlocked, and RetroArch doesn't work properly!
A: First, make sure you are on a Horizon OS version (I.E. Nintendo's Switch OS) higher than 1.0.0. Second, no matter which firmware you are on, ALWAYS FORMAT YOUR SD CARD AS FAT32; NO EXCEPTIONS. If you continue to use RetroNX under the ExFAT filesystem, we cannot provide additional support beyond the previously elaborated-upon disclaimer.
Q: I'm trying to save changes to the settings, but it doesn't commit!
A: Save the current configuration with no content loaded. You can do this from any core.
Q: My question is not listed here/where can I go for additional support?
A: The fastest method for support and staying up-to-date on progress for RetroNX, you can join the Discord server with the following link:
https://discord.gg/jTmfAEx
When you are posting about issues related to the cores (assuming you have read through this readme and identified your problem is uncommon/unrelated to the above), please list the following pieces of information in your report alongside the issue:
- Horizon OS version (I.E. Switch OS firmware version)
- Core used
- Whether core used is a Master/Stable or Nightly/Unstable; what is the builddate of said core?
- Version of the Hekate payload used
Make sure to post in the channel listed #retroarch-homebrew.
----------------------------------------------------
Credits:
m4wx - Primary developer of RetroNX/Libretro-NX.
lifajucejo, others - Supporting developers/contributers to the RetroNX project.
Switchbrew - Developers/contributors for the LibNX project and API which RetroNX is built on.
Original Libretro Team - Primary developer of the Libretro/RetroArch project that RetroNX is built upon.
All the testers and users that report notable issues.
An Average Seong - Packaging the build in a convenient pack/writer of the very README you're reading! Thanks for reading to the end.
Changelog
v1.22.0 from RA's buildbot
3DS: Add 800px mode for New 3DS models
JPEG: Fix clamping bug in JPEG decode
MENU/XMB: Improvements for mobile/touch. More natural horizontal/vertical scrolling
CAMERA: Use ffmpeg libavfilter virtual input device as default
CLOUDSYNC: Enable icloud_drive cloud sync backend on MacOS / iOS
CLOUDSYNC: Don't always trust the server hash
CLOUDSYNC: Enable WebDAV support for Android
CLOUDSYNC: Speed up cloudsync on Apple
DATABASE: Improve multidisk game scanning
DATABASE: Filter in Database Manager now works for genre and region
INPUT: Default key and mouse binds for lightgun Start and Select buttons
INPUT: Turbo mode corrections
INPUT: Turbo fire settings are now saved to remaps, not to overrides
INPUT: Fix menu usage when OK/Cancel has mouse binds
INPUT: Ignore menu mouse startup position before moving
INPUT: Fix heavy slowdown when using Bluetooth XInput controllers with rumble
INPUT: Reset and close content hotkeys now require confirmation, similar to quit
INPUT: Menu toggle and hotkey enable can now be assigned to the same key
INPUT: Option to have hotkeys follow the port mapped first to the core
INPUT/ANDROID: Favor mouse coordinates for lightgun
INPUT/UDEV: Fix lost terminal settings after restart from menu
INPUT/BSV/REPLAY: Bumped replay format version to 2. Old replays will still play back fine.
INPUT/BSV/REPLAY: Add option to skip deserializing checkpoints from replay files (it introduces jank in some emulators).
INPUT/BSV/REPLAY: Add checkpoint and initial savestate compression, following the savestate_file_compression config boolean. Use zstd if available, or fall back to zlib.
INPUT/BSV/REPLAY: Add incremental checkpoints based on statestreams (depending on HAVE_STATESTREAM compile time flag). As an example, 60 pcsx_rearmed savestates would take 267MB uncompressed; with incremental encoding this is reduced to 77MB. Compressing the result can reduce the size to just 4MB.
INPUT/BSV/REPLAY: Checkpoint compression and encoding can be combined. For example, 60 pcsx_rearmed checkpoints can take up just 15MB if each state is incremental and compressed. This is not as optimal as using incremental states without save state compression followed by offline compression, but is a good compromise in many use cases.
INPUT/BSV/REPLAY: Add hotkeys and text commands to force a checkpoint insertion into the currently recording replay, and to seek backwards to the previous checkpoint and forwards to the next checkpoint.
INPUT/BSV/REPLAY: Add a text command to seek to a specific frame of the currently playing/recording replay; it will return via the command replier the actual seeked-to frame (right now it only supports seeking to checkpoints).
INTL: Add Irish Gaelic to selectable languages
LIBRETRO: Deprecate intfstream_open_writable_memory
LIBRETRO: New environment function RETRO_ENVIRONMENT_GET_TARGET_SAMPLE_RATE
MENU: Common Thumbnail Background option for all menu drivers
MENU: Move core options reset from Settings/Configuration to Main Menu / Configuration Files
MENU: Use right analog stick for thumbnail cycling in playlists
MENU: Option to always suggest cores, even when a core is already loaded
MENU: Option to show Favorites before History
MENU: Media history playlists are now visible in playlist manager
MENU: Import Content visibility defaults reverted
MENU: Update CRTSwitchRes menu options for future use
MENU: Debug builds are indicated in Information menu
MENU: Save As / Save Main options for configuration file
MENU: Unwanted input is prevented when menu is triggered by toggle combo
MENU: 32-bit values in cheats and rumble are not presented as huge lists
MENU: Less important widgets are now sized like task notifications
MENU: Play count is added to runtime log
MENU: Configurable startup page (several options beside default Main Menu)
MENU: Shader menu rework, combined save/remove menus, save current, Y and Start hotkeys for shader parameters and background opacity toggle
MENU: Single-click start option from playlists and Explore view
MENU: Allow kiosk mode and hiding of Settings menu also in GLUI and RGUI
MENU: Task widget improvements
MENU/GLUI: Show thumbnails in Explore view
MENU/XMB: Select button toggles thumbnails in playlists
MENU/XMB,OZONE: Fix content icons when playlist tabs are hidden
MENU/OZONE: Horizontal padding factor option
MENU/OZONE: Custom font selection and scaling factor
MENU/RGUI: Clock format is now configurable and moved to top header
NETPLAY: Push room info to lobby
NETWORK: Fixes for nmcli wifi driver
NETWORK: Network command interface enabled for Android, iOS, TVOS
OTHER: ZStandard support and libchdr update for support of chd files converted with createdvd option
OVERLAY: Speed limit on touch pointer tracking
OVERLAY: Dedicate each touch pointer to hitboxes or pointing devices
OVERLAY: Fix overlay turbo fire
PLAYLIST: Built-in playlists are now stored under playlists/builtin
PLAYLIST: Fix subsystem information in playlists
REPLAY: Bugs fixed regarding rewind
REPLAY: Same timeline check and future state check for replays vs. savestates
SAVESTATES: Savestate thumbnails are default enabled for x86_64 builds
SAVESTATES: Slot is now remembered using the runtime log file
SAVESTATES: Slot hotkey widget shows save state thumbnail
SCAN: Fix crash with Sega CD
SCAN: Log files without database match
SCAN: Optimization of database queries by content file size
VIDEO: Fix auto swap interval setup
VIDEO: Improvements for integer scale half scaling
VIDEO: Adjustments to smart integer scaling, considering title safe area
VIDEO: Frame delay improvements for the automatic setting
VIDEO: Auto-enable GPU recording with HW context cores
VIDEO: Fix viewport bias when using custom aspect ratio
VIDEO/D3D11/D3D12: snappy extra vsync presentation mode
VIDEO/GL: Fallback OpenGL symbol loader for Linux devices with EGL < 1.5
VIDEO/GL: Support for Cg and GLSL shaders in the GLCore video driver
VIDEO/GL: Improve GLES version detection
VIDEO/SHADER: Shader hold function, useful for some lightguns and shader comparison
VIDEO/SWITCHRES: Horizontal and vertical geometry adjustment options added
VIDEO/SWITCHRES: Game overrides
VIDEO/WAYLAND: Support for xdg-toplevel-icon-v1
VIDEO/WAYLAND: Fix deadlock when using Wayland Vulkan driver
VIDEO/WAYLAND: Fix fullscreen on auto monitor index (partial)
