Skip to content

Commit d2df584

Browse files
authored
Merge pull request #990 from zoltanvb/icon_thumbnails
Add mention of Named_Logos and non-PNG thumbnails.
2 parents cb903d2 + de27178 commit d2df584

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

docs/guides/roms-playlists-thumbnails.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# ROMs, Playlists, and Thumbnails
22

33
## Storing games and other content
4-
Game ROMs are the source media of the games that can be played using RetroArch cores, they can be actual dumps of read-only memory, but also tape/floppy/compact disc images or some other format. The ROM files may be placed anywhere in the file system where RetroArch has access - note that some platforms (notably Android) are not able to browse the full storage. It is practical if the file browser start directory is configured to the directory where ROMs are stored.
4+
Game ROMs are the source media of the games that can be played using RetroArch cores. They can be actual dumps of read-only memory, tape/floppy/compact disc images, or some other format. The ROM files may be placed anywhere in the file system where RetroArch has access - note that some platforms (notably Android) are not able to browse the full storage. It is practical if the file browser start directory is configured to the directory where ROMs are stored.
55

66
Many users sort their ROMs into subfolders named after the system which the ROMs belong to, which results in a folder arrangement such as:
77

@@ -173,7 +173,7 @@ Since playlists are managed in text-only JSON format, there are a few third-part
173173

174174

175175
## Custom thumbnails
176-
Users who wish to use their own thumbnails can do so by naming PNG image files according to the RetroArch naming convention.
176+
Users who wish to use their own thumbnails can do so by naming PNG image files according to the RetroArch naming convention. In RetroArch versions later than 1.19.1, other image formats can be also enabled (jpg, bmp, tga).
177177

178178
### Thumbnail paths and filenames
179179
Thumbnails should be stored in subfolders within the configured RetroArch `thumbnails` directory within a subfolder named exactly the same as the playlist, except without `.lpl` at the end. **Example: If your playlist is named `Atari - 2600.lpl`, then your Atari 2600 root thumbnail folder should be called `thumbnails/Atari - 2600/`.**
@@ -198,3 +198,8 @@ For RetroArch versions 1.17.0 or later, flexible naming is applied, up to 3 opti
198198
- ROM file name with .png extension: `Q-Bert's Qubes (1983)(Parker Bros)[b].png`
199199
- Database entry / playlist label with .png extension, as explained above: `Q_Bert's Qubes (USA).png`
200200
- Short name: same as previous, but only up to first round bracket: `Q_Bert's Qubes.png`
201+
202+
### Named logos
203+
In RetroArch versions later than 1.19.1, there is an option for the XMB menu driver to display custom images in the playlist, instead of the default content icon, see [this example](https://github.com/libretro/RetroArch/pull/16758#issuecomment-2211771227). For this to work, create a folder called `Named_Logos` in the same structure as above, and put the logo images there using the same file name convention as above.
204+
205+
Logo support is only possible with XMB menu driver, and the online thumbnail repositories do not contain logo collections.

0 commit comments

Comments
 (0)