libretro · fpscan · Oct 4, 2026 · Sep 25, 2026 · Sep 25, 2026 · Sep 25, 2026
diff --git a/docs/development/cores/developing-cores.md b/docs/development/cores/developing-cores.md
@@ -180,3 +180,11 @@ There are several steps before your core can be available to user via the Online
     - Add at least icons playlist and content for your core in [RetroArch assets repository](https://github.com/libretro/retroarch-assets/tree/master/src/xmb/monochrome)
     - Add your games to [Libretro database](https://github.com/libretro/libretro-database).
  4. Add documentation of your core following the instructions in [libretro-docs](https://github.com/libretro/docs#adding-a-new-core).
+
+### Core file names
+
+A core's file is named `<name>_libretro` followed by the platform's library extension, for example `snes9x_libretro.so`, `snes9x_libretro.dll` or `snes9x_libretro.dylib`. Its info file is `<name>_libretro.info`, and the name must match it for RetroArch to show the core's information and to offer it in the Online Updater.
+
+On some platforms the buildbot adds an OS suffix after `_libretro`, such as `snes9x_libretro_android.so`. The suffix is optional: many cores are built without one on Android, iOS and tvOS, and they work the same. RetroArch drops everything after the last underscore unless that part is `_libretro` itself, so `snes9x_libretro.so` and `snes9x_libretro_android.so` both match `snes9x_libretro.info`. Only one suffix is removed, so a file name must not carry more than one after `_libretro`.
+
+A core without an OS suffix is therefore not a mistake, and does not need an issue or a pull request to add one.
diff --git a/docs/development/licenses.md b/docs/development/licenses.md
@@ -59,7 +59,7 @@ See below for a summary of the licenses behind RetroArch and its cores:
 
 | Core                                             			           | License                                                                                   | Non-commercial |
 |----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|----------------|
-| [3D Engine](../library/3d_engine.md)             			           | [GPLv3](https://github.com/libretro/libretro-3dengine/blob/master/license)                |                |
+| [3D Engine](../library/3dengine.md)             			           | [GPLv3](https://github.com/libretro/libretro-3dengine/blob/master/license)                |                |
 | [2048](../library/2048.md)                       			           | [Public Domain](https://github.com/libretro/libretro-2048/blob/master/COPYING)            |                |
 | [Anarch](../library/anarch.md)                                                   | [CC0](https://codeberg.org/iyzsong/anarch-libretro/src/branch/master/LICENSE)             |                |
 | [Ardens](../library/ardens.md)                                       | [MIT](https://github.com/tiberiusbrown/Ardens/blob/master/LICENSE.txt)                         |                |
@@ -83,10 +83,10 @@ See below for a summary of the licenses behind RetroArch and its cores:
 | [bsnes-mercury Accuracy](../library/bsnes_mercury_accuracy.md)                   | [GPLv3](https://github.com/libretro/bsnes-mercury/blob/master/LICENSE)                    |                |
 | [bsnes-mercury Balanced](../library/bsnes_mercury_balanced.md)                   | [GPLv3](https://github.com/libretro/bsnes-mercury/blob/master/LICENSE)                    |                |
 | [bsnes-mercury Performance](../library/bsnes_mercury_performance.md)             | [GPLv3](https://github.com/libretro/bsnes-mercury/blob/master/LICENSE)                    |                |
-| [bsnes Accuracy](../library/bsnes_accuracy.md)                                   | [GPLv3](https://github.com/libretro/bsnes-libretro/blob/libretro/COPYING)                 |                |
-| [bsnes Balanced](../library/bsnes_balanced.md)                                   | [GPLv3](https://github.com/libretro/bsnes-libretro/blob/libretro/COPYING)                 |                |
+| [bsnes 2014 Accuracy](../library/bsnes2014_accuracy.md)                                   | [GPLv3](https://github.com/libretro/bsnes-libretro/blob/libretro/COPYING)                 |                |
+| [bsnes 2014 Balanced](../library/bsnes2014_balanced.md)                                   | [GPLv3](https://github.com/libretro/bsnes-libretro/blob/libretro/COPYING)                 |                |
 | [bsnes C++98 (v085)](../library/bsnes_cplusplus98.md)                            | [GPLv3](https://github.com/libretro/bsnes-libretro/blob/libretro/COPYING)                 |                |
-| [bsnes Performance](../library/bsnes_performance.md)                             | [GPLv3](https://github.com/libretro/bsnes-libretro/blob/libretro/COPYING)                 |                |
+| [bsnes 2014 Performance](../library/bsnes2014_performance.md)                             | [GPLv3](https://github.com/libretro/bsnes-libretro/blob/libretro/COPYING)                 |                |
 | [Caprice32](../library/caprice32.md)             			           | [GPLv2](https://github.com/ColinPitrat/caprice32/blob/master/COPYING.txt)                 |                |
 | [ChaiLove](../library/chailove.md)               			           | [MIT](https://github.com/libretro/libretro-chailove/blob/master/COPYING)                        |                |
 | [Citra](../library/citra.md)                     			           | [GPLv2](https://github.com/citra-emu/citra/blob/master/license.txt)                       |                |

diff --git a/docs/guides/core-list.md b/docs/guides/core-list.md
@@ -8,6 +8,7 @@
 | [Ardens](../library/ardens.md) | Arduboy                | A simulator for the Arduboy FX |
 | Arduous                   | Arduboy                | A emulator for Arduboy, a handheld game console with open source software, based on the Arduino hardware platform |
 | [Atari800](https://docs.libretro.com/library/atari800/) | Atari 5200             |                    |
+| [Azahar](../library/azahar.md) | Nintendo 3DS           | A port of the Azahar 3DS emulator to libretro, based on Citra |
 | [b2](../library/b2.md)    | Acorn BBC Micro        |                    |
 | [Beetle bsnes](../library/beetle_bsnes.md) | Nintendo SNES/SFC      |                    |
 | [Beetle Cygne](https://docs.libretro.com/library/beetle_cygne/) | Bandai WonderSwan/Color |                   |
@@ -30,9 +31,9 @@
 | boom 3                    | Game engine            | A port of the Doom 3 engine to libretro. There is a separate core for it's expansion pack 'Resurrection of Evil'. |
 | boom 3 xp                 | Game engine            | (See boom 3 note)  |
 | [bsnes](../library/bsnes.md) | Nintendo SNES/SFC      |                    |
-| [bsnes 2014 Accuracy](../library/bsnes_accuracy.md) | Nintendo SNES/SFC      |                    |
-| [bsnes 2014 Balanced](../library/bsnes_balanced.md) | Nintendo SNES/SFC      |                    |
-| [bsnes 2014 Performance](../library/bsnes_performance.md) | Nintendo SNES/SFC      |                    |
+| [bsnes 2014 Accuracy](../library/bsnes2014_accuracy.md) | Nintendo SNES/SFC      |                    |
+| [bsnes 2014 Balanced](../library/bsnes2014_balanced.md) | Nintendo SNES/SFC      |                    |
+| [bsnes 2014 Performance](../library/bsnes2014_performance.md) | Nintendo SNES/SFC      |                    |
 | [bsnes C++98 (v085)](../library/bsnes_cplusplus98.md) | Nintendo SNES/SFC      |                    |
 | bsnes-hd beta             | Nintendo SNES/SFC      |                    |
 | [bsnes-jg](../library/bsnes-jg.md) | Nintendo SNES/SFC      |                    |

diff --git a/docs/guides/install-facebookportal.md b/docs/guides/install-facebookportal.md
@@ -1,25 +1,10 @@
 <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/jBjBr2Zzfwk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 
-Facebook Portal is a device that allows you to have video calls with friends and family using Facebook Messenger. It has a built-in camera and microphone, and it's designed to make video chatting easier and more convenient.
-
-Now, if you want to use Facebook Portal for running RetroArch, we need to do a little tweaking. RetroArch is an emulator that allows you to play old video games on various platforms. While Facebook Portal is not specifically designed for gaming, it does have some capabilities that might make it possible.
-
-To run RetroArch on Facebook Portal, you would need to use browser. Remember that running RetroArch on Facebook Portal might not provide the best gaming experience. The device is primarily designed for video calling and might not have the same performance or compatibility as dedicated gaming devices or computers. So, while it's possible to run RetroArch on Facebook Portal, it might not be the ideal setup for gaming purposes.
+Facebook Portal is a video calling device. It runs Android, but without the Google Play Store, so RetroArch cannot be installed on it. It can run the web version of RetroArch in the Portal's browser instead. Expect lower performance than on a dedicated gaming device.
 
 # Running RetroArch on Facebook Portal
 
-Portal is built on an open-source Android platform but we can't access the Google Play Store.
-
-Sure! Here's a step-by-step guide to running RetroArch on Facebook Portal:
-
-1. Connect your controller: Start by connecting your controller to the Facebook Portal. You can do this by using via Bluetooth. Go to the settings, then Bluetooth settings. Put your controller into the Pairing mode. You will see your controller in the list.
-
-2. Open the web browser: On the Facebook Portal, locate the web browser app. It's usually represented by an icon that looks like a globe or compass. Tap on the icon to open the web browser.
-
-3. Visit web.libretro.com: In the web browser, enter the URL "web.libretro.com" in the address bar. This website is the official RetroArch website.
-
-4. Select a core: On the RetroArch website, you'll find a list of cores. Choose the core that corresponds to the console you want to emulate.
-
-5. Run the homebrews: After selecting the core, go to the "Downloads" section under the main menu. Look for the homebrews available for the console you selected. Homebrews are unofficial games or software created by independent developers. Select the file and it will load.
-
-Remember, running RetroArch on Facebook Portal might not offer the best gaming experience, as the device is primarily designed for video calling. So, manage your expectations accordingly, and have fun exploring the world of retro gaming!
+1. Pair a controller: open the Portal's Bluetooth settings, put the controller in pairing mode and select it in the list.
+2. Open the web browser and go to [web.libretro.com](https://web.libretro.com).
+3. Choose the core for the system you want to play.
+4. Load content. The web version offers homebrew games for each core under **Downloads** in its main menu.
diff --git a/docs/guides/softpatching.md b/docs/guides/softpatching.md
@@ -87,10 +87,10 @@ Cartridge content only — Jaguar CD images are loaded by path and are not softp
 | [bsnes-mercury Accuracy](../library/bsnes_mercury_accuracy.md)       | ✔         |
 | [bsnes-mercury Balanced](../library/bsnes_mercury_balanced.md)       | ✔         |
 | [bsnes-mercury Performance](../library/bsnes_mercury_performance.md) | ✔         |
-| [bsnes Accuracy](../library/bsnes_accuracy.md)                       | ✔         |
-| [bsnes Balanced](../library/bsnes_balanced.md)                       | ✔         |
+| [bsnes 2014 Accuracy](../library/bsnes2014_accuracy.md)                       | ✔         |
+| [bsnes 2014 Balanced](../library/bsnes2014_balanced.md)                       | ✔         |
 | [bsnes C++98 (v085)](../library/bsnes_cplusplus98.md)                | ✔         |
-| [bsnes Performance](../library/bsnes_performance.md)                 | ✔         |
+| [bsnes 2014 Performance](../library/bsnes2014_performance.md)                 | ✔         |
 | [higan Accuracy](../library/higan_accuracy.md)                       | ✔         |
 | [nSide Balanced](../library/nside_balanced.md)                       | ✔         |
 | [Mesen-S](../library/mesen-s.md)                                     | ✔         |

diff --git a/docs/image/controller/dc.png b/docs/image/controller/dc.png
diff --git a/docs/image/controller/saturn.png b/docs/image/controller/saturn.png
diff --git a/docs/library/3dengine.md b/docs/library/3dengine.md
@@ -2,7 +2,7 @@
 
 ## Contribute to this documentation
 
-In order to propose improvements to this document, [visit its corresponding source page on github](https://github.com/libretro/docs/tree/master/docs/library/3d_engine.md). Changes are proposed using "Pull Requests."
+In order to propose improvements to this document, [visit its corresponding source page on github](https://github.com/libretro/docs/tree/master/docs/library/3dengine.md). Changes are proposed using "Pull Requests."
 
 ## Background