RetroArch

RetroArch

42 ratings
How to manually add thumbnails for your favourite ROMs
By +-
If you’re not a fan of the automatic playlist sorting, or if you have ROMs that are not on the database
   
Award
Favorite
Favorited
Unfavorite
Overview
To get thumbnails to work the ROMs must be in a playlist. RetroArch has an automatic way to do this by automatically sorting your ROMs based on name and system into different playlists, one for each system. I don’t care for playlists so the method I will show will work by adding your ROMs to favourites, copying the favourites lpl file -- which is in itself a playlist -- and making a playlist out of that. Thereafter, you can make the thumbnails appear in the Favorites list too by "Add to Favorites" again via the interface.

If you are interested in the automatic way instead, see the resources linked in the "Further reading" section.
1. Mark ROMs as favourites
With a game running in RetroArch, open the Quick Menu with F1 and select "Add to Favorites". Each game added in this way will automatically be added to a special playlist located in `content_favorites.lpl` in your RetroArch directory.
2. Locate your RetroArch directory
Access your RetroArch directory; on Steam right click on RetroArch → Properties → Local Files → Browse
3. Copy content_favorites.lpl
In your RetroArch directory, locate and copy the file called
content_favorites.lpl
4. Paste in playlists folder and modify file
In your RetroArch directory, access the `playlists` subfolder and paste `content_favorites.lpl` in there.

Now rename it what you want your playlist to be called, e.g. to `Playlist.lpl`.

Edit this file in your text editor of choice. Use your editor’s find & replace function to change every instance of
"db_name": ""
to
"db_name": "Playlist.lpl"
, where `Playlist.lpl` is whatever you chose to name your playlist file.
5. Add thumbnails
In your RetroArch directory, access the `thumbnails` subfolder and create a folder within it that has the same name as your playlist, without the extension. So in our example the folder should be called `Playlist`.

Inside this folder, create 3 subfolders:

  1. Named_Boxarts
  2. Named_Snaps
  3. Named_Titles

In these folders you can add boxart, screenshots, and titlescreen screenshots respectively to your games. The images should be in `png` format and named exactly the same as the ROM. You don’t have to add all three, only what you want; by default RetroArch shows only boxarts but you can change this in the settings.

For example, to get a thumbnail for my ROM `Metal Gear (1987)(Konami)(jp)[RC-750].rom` I put an image named `Metal Gear (1987)(Konami)(jp)[RC-750].png` in `thumbnails/Playlist/Named_Boxarts`.

Some places you could get images from:

6. Optional: Re-add to Favorites list
Now in RetroArch you should be able to see your playlist, and the games therein should show boxart when hovered over / selected. However, the images will still not show in the Favorites list. You might be ok with this if you are launching your games from your playlist anyway, but if you prefer to use the Favorites list like I do, read on.

In this GitHub issue[github.com], RetroArch contributor jdgleaver says this:

Originally posted by jdgleaver:
if you want thumbnails in your favourites playlist, you need to select Add to Favorites via an existing playlist entry that already has working thumbnails.

and, indeed, if in RetroArch you select your playlist, select a game on there and click "Add to Favorites", the old entry for this game in the Favorites list will be replaced with one that has the thumbnails.

Why not modify `content_favorites.lpl` directly, you ask? Because this file is generated automatically, and your changes will be reverted every time you add or remove a game from the Favorites list. If you add it as stated, it will keep the thumbnails forevermore.
Further reading
36 Comments
Hexagon_Sashimi 7 Jun, 2024 @ 12:07am 
thank you so much bro :Ashhat:
Tempest 10 Jul, 2023 @ 11:49pm 
I had renamed some of my games so that the names were different from the respective ROMs and discovered that the filenames of the thumbnails must match the names of the games rather than the ROMs.
Tempest 10 Jul, 2023 @ 11:23pm 
Thanks for making the guide. There is one correction needed. The filename of the thumbnail should match the name of the game as listed in the playlist or favorites list, not the ROM. This excerpt is from the RetroArch website: "...The thumbnail filename should exactly match the game's title as listed in the playlist with an important exception. The following characters in playlist titles must be replaced with _ in the corresponding thumbnail filename: &*/:`<>?\|

Example: If your content is named Q*bert's Qubes in the playlist, then its thumbnails should be named Q_bert's Qubes.png..."
↑↑↓↓←→←→BASelect 23 Jan, 2023 @ 10:59pm 
Yea i noticed that when i went to history it had the thumbnail. it also works for the original favorites from the side bar if you add it to favorites from the play list.

Again thanks for all your help i really appreciate it.

Now i just got to figure out why the scan directory to make a playlist for dreamcast added all my games for dreamcast except one rayman 2. If i load it manually it works and plays fine but it's not showing up in the play list from the scan i made.
+-  [author] 23 Jan, 2023 @ 10:55pm 
it seems to sometimes get the wrong db_name
+-  [author] 23 Jan, 2023 @ 10:50pm 
@SnakeFist it should still work in history if you launch it from the playlist. it inherits the "db_name" so it should get the thumbnails from the same place
↑↑↓↓←→←→BASelect 23 Jan, 2023 @ 10:41pm 
I made playlists with the scan directory feature for a few consoles and clicked on a game and download thumbnails and it makes its own folder in the thumbnails folder where it downloads the box art. To bad it's probably a lot of work to get boxart to show up for history.
+-  [author] 23 Jan, 2023 @ 10:25pm 
@SnakeFist to be clear, it is its own playlist. It is the same process you used to add the thumbnails to the "Favorites" playlist. i.e. you need a folder in M:\Steam\steamapps\common\RetroArch\thumbnails named "Sony - PlayStation", and under this you need the usual "Named_Boxarts" etc.
+-  [author] 23 Jan, 2023 @ 10:19pm 
@SnakeFist yep. The names are the same as on https://github.com/libretro-thumbnails , but with spaces instead of underscores. Also I am pretty sure there is an automatic way to download them, I have never tried that so I am not familiar with it, but check the video I linked in "Further reading"
↑↑↓↓←→←→BASelect 23 Jan, 2023 @ 10:10pm 
There is a space before and after the hyphen correct?