libretro-thumbnails / Libretro Thumbnails
Labels
Projects that are alternatives of or similar to Libretro Thumbnails
libretro-thumbnails
Thumbnails for RetroArch, split into individual repositories to ease maintenance.
Install
Check out the repository, with all submodules, into RetroArch's thumbnails directory:
cd ~/.config/retroarch
git clone --recursive --depth=1 http://github.com/libretro-thumbnails/libretro-thumbnails.git thumbnails
Update
To bring in the latest thumbnails across all systems, use:
git pull --recurse-submodules
git submodule update --remote --recursive
Or by using the script which will maintain shallow clones (depth=1) and checkout master:
sh update_modules.sh
Usage
- Thumbnails are installed into RetroArch config's
thumbnails
directory - There are three types of thumbnails:
-
Named_Snaps
are in game snapshots -
Named_Titles
are title screen snapshots -
Named_Boxarts
are the boxes or covers for games
-
- Thumbnails follow the following naming convention:
thumbnails/Playlist Name/Named Type/Game Name.png
- The following characters in playlist titles must be replaced with _ in the corresponding thumbnail filename:
&*/:`<>?\|"
- Images must be
.png
format - Image resolution guidelines:
- Images with native width larger than 512px should be scaled down to 512px wide
- Images with native width of 512px or less should be added as-is
- Substitute promotional flyers are acceptable when no boxart is available for a game
- Use libretro-thumbnails-check to check for missing thumbnails
Testing
To check for files with invalid file names, use the following command....
find . -name '*[&\*:`<>?\\|"*]*'
This can be put in a .travis.yml
file to enable automated testing.
language: bash
script:
- find Named* -name '*[&\*:`<>?\\|"*]*' | grep "." && echo "The above are invalid filenames" && return 1 || echo "No invalid files found"
notifications:
email: false
Thumbnail Server
The libretro-thumbnail server provides two functions...
.index Files
The .index files allow RetroArch to list the files available in the given directory. To build the .index files, run the following command...
make index
Packs
Thumbnail packs can be generated to create a zip of all thumbnails across each system. To build the thumbnail packs, run the following command...
PACKSDIR=../packs make packs
Change PACKSDIR
to change which you would like the thumbnail packs to be built.
Credits
The art provided has many different sources. Thank you to many of the contributors and sites who have made this possible...