ScummVM How to add games with auto generating .scummvm files

I deleted my tutorial video and script, because the auto generation of .scummvm files can be automated with the core now. Read the explanation here in the replies: ScummVM How to add games with auto generating .scummvm files

There is a new feature in current ScummVM core, which covers this topic. It can be accessed from ScummVM GUI.

User now just needs to add the games from ScummVM GUI, then retroarch playlist and .scummvm files are handled automatically.

Here follows an extract of the help section, which explains how to use it.

ScummVM Playlist Generator

ScummVM core includes a tool to generate a Libretro playlist and needed hook files based on current ScummVM games list.

  • Load the core from RetroArch and start it to reach the ScummVM GUI (i.e. the Launcher)

  • Add games to the list as required using the GUI buttons (‘Mass Add’ available).

  • Select Global Options and then the Backend tab.

  • Check or select the path of frontend playlists. A ‘ScummVM.lpl’ file will be created or overwritten in there.

  • Check the ‘Hooks location’ setting, to have one ‘.scummvm’ in each game folder or all of them in a ‘scummvm_hooks’ folder in the ‘save’ path.

  • Check the ‘Playlist version’ setting. JSON format should be selected, 6-lines format is deprecated and provided for backwards compatibility only.

  • Select the ‘Clear existing hooks’ checkbox to remove any existing ‘.scummvm’ file in the working folders.

  • Press the ‘Generate playlist’ button.

Operation status will be shown in the same dialog, while details will be given in frontend logs.

1 Like

That’s great! This option was added last month and I missed it. Guess then I should delete the script and video, to not confuse people as this is part of the core functionality.

yes but how to add thumbnails now? for example i have 3 folders for 3 scummvm games each game have a folder in the thumbnails directory, with the same name of the game folder example folder_game1, folder_game2 and folder_game3 inside these folders i have 2 fodlers: " named boxarts" and “named titles”.

when i generate the scummvm.lpl i can access to the games but i don’t see the thumbnails. i have this problem only for scummvm system

1 Like

Good question. So for me I wasn’t using the images at all, but turns out its easy to fix (not sure why I didn’t do that before). Just checked it, the thumbnails must have the same name of the .scummvm files, not the directory name. But the brackets are optional.

I just did a full scan for thumbnails and it works like this, with an example of Discworld. I have 3 versions for this game.

.scummvm file and directory:

Discworld (CD DOS, German)/Discworld (CD DOS German).scummvm
Discworld 1 (CD DOS v2)/Discworld (CD DOS English).scummvm
Discworld 1 (CD DOS)/Discworld (CD DOS English).scummvm

So that is where the files and directory of the game are. After thumbnail scan, I have following images:

Named_Boxarts/Discworld.png
Named_Snaps/Discworld.png
Named_Titles/Discworld.png

As you see, the brackets are optional and Discworld.png matches all three games, regardless of the brackets. (There are also Discworld (Floppy_DOS_French).png files, but I did not list them because I don’t have any game that matches it.)

If you can, try to scan the thumbnails for automatic download (took a few minutes for me). Otherwise have a look at https://github.com/libretro-thumbnails/ScummVM/tree/master/Named_Boxarts how the files are named.

thanks for trying to help my problem is: i have the game Beneath a Steel Sky (v0.0348 Floppy_DOS)

according to your link i can see it here https://github.com/libretro-thumbnails/ScummVM/blob/master/Named_Boxarts/Beneath%20a%20Steel%20Sky%20(v0.0348%20Floppy_DOS).png

i have tryed

>     Named_Boxarts/sky.png

it doesnt work

i have tryed

>     Named_Boxarts/sky-1.png

it doesnt work

>     and even Named_Boxarts/Beneath a Steel Sky.png
```

no one works when i use the spleen1981 method (the user that answered to you on this topic).

finnaly i’ve found the problem. in the thumbnails folder i’ve created a folder that has the exact name of the playlist (scummvm), then inside it i have the named_boxarts, named_titles and the named_snaps folder (this folder is not chosen to be displayed in other systems so i don’t know why with scummvm system it has to be created to display a picture… anyway…) inside them in fact i had to rename the png files with the exact name that appears in retroarch playlist (it is not the same as the name of the folder that contains the game), and i had to add the brackets content, without them the thumbnails were not displayed. an other problem were the special characters ("&", “/”, “:”) that appeared in the game name, there are not writable on windows, the solution was to replace them by the “" character in the png files. for example for a game named “blabla: (ok/french/dos)”, we have to name the thumbnail "blabla (ok_french_dos).png”

now all works :grinning:

1 Like

mmh i cant edit my last message, this forum has changed my message with the _ character here is what you should read

> an other problem were the special characters ("&", “/”, “:”) that appeared in the game name, there are not writable on windows, 
> the solution was to replace them by the “_" character in the png files. 
> for example for a game named “blabla: (ok/french/dos)”, we have to name the thumbnail "blabla_ (ok_french_dos).png”

Glad you found a working solution. You should not need any other subfolder for the thumbnails. The directories are your RetroArch main folder > thumbnails > ScummVM > Named_Titles > Beneath a Steel Sky.png . I didn’t name it this way, it was automatically named by RetroArch when downloading the thumbnails. So without brackets should work theoretically. It might have not worked for you before, because you had the wrong subfolder, right? Now that it is working, you could try again with these non brackets names.

BTW they have to match the .scummvm filename, where the Roms (I just call the game files Roms) are, not the name in the playlist. The idea is that the images with non brackets file names match as a base, so all game versions will access this one .png file.

I mean if it works for you now, you don’t have to change.

Just for the understanding: In your thumbnails folder, each system has its own folder, like “ScummVM” or “Nintendo - Game Boy” as an example. Every of these systems can have up to 3 subfolders, namely “Named_Boxarts”, “Named_Snaps” and “Named_Titles”. And each of these folders contain the screenshots and images in .png format. The name of each image has to match the Rom file, of the game file, not the playlist. In case of ScummVM, it is the .scummvm filename. And as explained before, RetroArch supports base images without brackets in name… so it should work on your side (I assume).

But just another question: Why don’t you just use the thumbnail downloader from RetroArch itself? Then RetroArch takes care of this and does this automatically for you.