diff --git a/docs/guides/download-cores.md b/docs/guides/download-cores.md index b85987363c..e95b350a66 100644 --- a/docs/guides/download-cores.md +++ b/docs/guides/download-cores.md @@ -29,6 +29,18 @@ Cores are essentially other programs and games that run through RetroArch. Retro !!! note If you're using the Ubuntu PPA version of RetroArch and have enabled "Show Core Downloader" manually, your changes will not be reflected unless your the Cores directory setting is set to a writable location in the [Directory Configuration](change-directories.md#cores). +## Installing cores manually + +When the Core Downloader is not available, or you want a specific build, a core can be installed by hand from the [buildbot](https://buildbot.libretro.com/nightly/): + +1. Open the folder for your platform and architecture, then `latest/`, for example `nightly/windows/x86_64/latest/`, `nightly/linux/x86_64/latest/`, `nightly/linux/aarch64/latest/` or `nightly/apple/osx/arm64/latest/`. Android cores are in `nightly/android/latest//`, for example `arm64-v8a`. +2. Download the core's zip, for example `snes9x_libretro.so.zip`, and extract it. The file inside is the core: `.dll` on Windows, `.so` on Linux and Android, `.dylib` on macOS. +3. Copy it into RetroArch's cores folder. Its location is shown in **Settings > Directory > Cores**; see [Directory Configuration](change-directories.md#cores). +4. Make sure RetroArch also has the core's info file. Without it the core still loads, but RetroArch does not know its name, supported extensions, firmware or which features (save states, rewind, run-ahead) it supports. Use **Online Updater > Update Core Info Files**, or download [info.zip](https://buildbot.libretro.com/assets/frontend/info.zip) and extract it into the folder shown in **Settings > Directory > Core Info**. +5. Restart RetroArch. + +Instead of step 3 you can put the extracted core in the folder shown in **Settings > Directory > Downloads** and use **Load Core > Install or Restore a Core**, which copies it into the cores folder. + ## Installing cores through package manager (Ubuntu PPA only) !!! note diff --git a/docs/guides/xmb.md b/docs/guides/xmb.md index 7628b5cebd..0cb76d35e8 100644 --- a/docs/guides/xmb.md +++ b/docs/guides/xmb.md @@ -36,9 +36,19 @@ XMB has a number of styles built-in. They can be changed in the `Settings > User * The background color can be changed: Scroll through `Color Theme` to select a color. * The animated background "wallpaper" can also be changed (`Shader Pipeline`), the default being a PlayStation-style animated ribbon. - * XMB can even show different wallpapers depending on the playlist selected: [Follow this guide](https://github.com/libretro/Lakka-LibreELEC/wiki/Dynamic-Wallpapers) using [these files](https://github.com/libretro/retroarch-assets/tree/master/wallpapers). + * XMB can even show different wallpapers depending on the playlist selected, see [Dynamic backgrounds](#dynamic-backgrounds) below. * XMB also has a selection of icon sets to choose from (`Icon Theme`). ![XMB with an alternative background color, background animation, and icon set](../image/retroarch/xmb/theme_alt.png) -*XMB with an alternative background color, background animation, and icon set.* \ No newline at end of file +*XMB with an alternative background color, background animation, and icon set.* + +### Dynamic backgrounds + +XMB can show a different background for each tab of the horizontal menu, for example one per system playlist. + +1. Enable `Settings > User Interface > Appearance > Dynamic Background`. +2. Point `Settings > Directory > Dynamic Backgrounds` to a folder with the images. +3. Name each image after the title XMB shows in the top-left corner when that tab is selected, with a `.png` extension, for example `Nintendo - Super Nintendo Entertainment System.png` for the SNES playlist. + +Ready-made sets, named this way, are in the [wallpapers folder of retroarch-assets](https://github.com/libretro/retroarch-assets/tree/master/wallpapers); each set has a subfolder per resolution. A tab without a matching image keeps the regular background (`Background Image`, or the color theme's). If an animated `Shader Pipeline` covers the image, set it to `Off`. diff --git a/docs/library/mame2015.md b/docs/library/mame2015.md index 44eba1f89a..099be4774f 100644 --- a/docs/library/mame2015.md +++ b/docs/library/mame2015.md @@ -27,6 +27,8 @@ RetroArch database(s) that are associated with the MAME 2015 core: - [MAME 2015](https://github.com/libretro/libretro-database/blob/master/rdb/MAME%202015.rdb) +Romsets must match MAME 0.160. The XML DAT describing them is kept in the core's repository: [mame2015-xml.zip](https://github.com/libretro/mame2015-libretro/blob/master/metadata/mame2015-xml.zip). + ## Features Frontend-level settings or features that the MAME 2015 core respects. diff --git a/docs/library/vba_m.md b/docs/library/vba_m.md index 0c89fb810c..29df4a8766 100644 --- a/docs/library/vba_m.md +++ b/docs/library/vba_m.md @@ -90,6 +90,9 @@ The VBA-M core saves/loads to/from these directories. |:-----:|:----------------------:| | *.srm | Cartridge battery save | +!!! tip "Converting saves to .sav" + This core's `.srm` is the libretro VBA format (always 139,264 bytes), not the plain `.sav` most other emulators and flash carts use. [GBA 4gz, 4gs and sav Converter](https://thysbelon.github.io/gbaconv-web/) converts it to `.sav` and back, in the browser. + **Frontend's State directory** | File | Description | diff --git a/docs/library/vba_next.md b/docs/library/vba_next.md index 22cc6a77bf..0f1fb71348 100644 --- a/docs/library/vba_next.md +++ b/docs/library/vba_next.md @@ -83,6 +83,9 @@ The VBA Next core saves/loads to/from these directories. - 'content-name'.srm (Cartridge battery save) +!!! tip "Converting saves to .sav" + This core's `.srm` is the libretro VBA format (always 139,264 bytes), not the plain `.sav` most other emulators and flash carts use. [GBA 4gz, 4gs and sav Converter](https://thysbelon.github.io/gbaconv-web/) converts it to `.sav` and back, in the browser. + **Frontend's State directory** - 'content-name'.state# (State) diff --git a/docs/support/quick-informations.md b/docs/support/quick-informations.md index c06386f132..a82b3f8e2a 100644 --- a/docs/support/quick-informations.md +++ b/docs/support/quick-informations.md @@ -30,7 +30,6 @@ It is {{ unit.stable }}. You can find it here [here](http://buildbot.libretro.co - [Patreon](https://www.patreon.com/libretro) - [YouTube Membership](https://www.youtube.com/channel/UCjAimkVp-G_o6HK5MXujk9A/join) - [Liberapay](https://liberapay.com/Libretro/donate) - - [BountySource](https://salt.bountysource.com/checkout/amount?team=libretro) - [Service status](https://mnt.gds.im/status/retroarch) === "Video"