Skip to content
Thumbnails for RetroArch
Makefile Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Amstrad - CPC @ 39c07a6 Update submodules Jan 3, 2020
Atari - 2600 @ 6281e55 Update submodules Jan 3, 2020
Atari - 5200 @ 937d1c7 Update Submodules Oct 1, 2018
Atari - 7800 @ fdd1ded Update submodules Jan 3, 2020
Atari - Jaguar @ 7f3cb33 Update submodules Jan 3, 2020
Atari - Lynx @ c7cb233 Update submodules Jan 3, 2020
Atari - ST @ 2439ed9 Update submodules Jan 3, 2020
Bandai - WonderSwan @ ec1c755 Update submodules Jul 19, 2019
Bandai - WonderSwan Color @ 0d4158a Update submodules Jul 19, 2019
Cannonball @ d9f06e8 Add Cannonball Mar 8, 2019
Casio - Loopy @ 033b941 Hopefully fix the dirty state after a git clone Aug 22, 2018
Casio - PV-1000 @ 81b5d35 Update Submodules Oct 1, 2018
Cave Story @ dfab431 Update Dec 12, 2017
ChaiLove @ 51798e6 Update submodules Jul 19, 2019
Coleco - ColecoVision @ cb5a359 Update submodules Jan 3, 2020
Commodore - 64 @ df90042 Update Submodules Oct 1, 2018
Commodore - Amiga @ 5f80ea0 Update submodules Jan 3, 2020
Commodore - Plus-4 @ 3d68ca6 Update submodules Jan 3, 2020
Commodore - VIC-20 @ ea63b60 Update Submodules Oct 1, 2018
DOOM @ 7686e87 Update submodules Jan 3, 2020
DOS @ 2011d6a Update submodules Jan 3, 2020
Dinothawr @ 1e93e60 Update Dec 12, 2017
Emerson - Arcadia 2001 @ 2ef1236 Update submodules Jan 3, 2020
Entex - Adventure Vision @ 5a48558 Update Submodules Oct 1, 2018
Epoch - Super Cassette Vision @ 22a9862 Update submodules Jul 19, 2019
FBNeo - Arcade Games @ c7c2e71 Update submodules Jan 3, 2020
Fairchild - Channel F @ 3be4f66 Update Submodules Oct 1, 2018
Flashback @ 593cc9f Hopefully fix the dirty state after a git clone Aug 22, 2018
Funtech - Super Acan @ 17a2208 Update submodules Feb 9, 2018
GCE - Vectrex @ ed03e5d Update Submodules Oct 1, 2018
GamePark - GP32 @ 7c16f01 Update Submodules Oct 1, 2018
Handheld Electronic Game @ 242d54b Update Dec 12, 2017
Hartung - Game Master @ 698f0ec Update submodules Jan 3, 2020
LeapFrog - Leapster Learning Game System @ 3fe13f3 Hopefully fix the dirty state after a git clone Aug 22, 2018
Lutro @ 13cedee Update Submodules Oct 1, 2018
MAME @ 380e4f6 Update Submodules Mar 14, 2019
Magnavox - Odyssey2 @ 7aadf0d Update Submodules Oct 1, 2018
Mattel - Intellivision @ 7a493ae Update submodules Jan 3, 2020
Microsoft - MSX @ 2566bbc Update Submodules Oct 1, 2018
Microsoft - MSX2 @ 82ab7d4 Update submodules Nov 19, 2018
Microsoft - Xbox @ 282e50a Update Dec 12, 2017
Microsoft - Xbox 360 @ 378e757 Update Dec 12, 2017
MrBoom @ 88c1f8d Update submodules Feb 9, 2018
NEC - PC Engine - TurboGrafx 16 @ da69027 Update submodules Jan 3, 2020
NEC - PC Engine CD - TurboGrafx-CD @ a909b4d Update submodules Jan 3, 2020
NEC - PC Engine SuperGrafx @ 17b5f0f Hopefully fix the dirty state after a git clone Aug 22, 2018
NEC - PC-FX @ 29547ec Update submodules Feb 9, 2018
Nintendo - Family Computer Disk System @ 9971aeb Update submodules Jan 3, 2020
Nintendo - Game Boy @ 1776e2f Update submodules Jan 3, 2020
Nintendo - Game Boy Advance @ 9f60da8 Update submodules Jan 3, 2020
Nintendo - Game Boy Color @ 4594a7e Update submodules Jan 3, 2020
Nintendo - GameCube @ 914519e Update submodules Jan 3, 2020
Nintendo - Nintendo 3DS @ 532089e Update submodules Jan 3, 2020
Nintendo - Nintendo 3DS (Digital) @ 4e8c386 Fix 3DS (Digital Apr 5, 2019
Nintendo - Nintendo 64 @ 96b2939 Update submodules Jan 3, 2020
Nintendo - Nintendo 64DD @ 4d16133 Update submodules Jul 19, 2019
Nintendo - Nintendo DS @ 1de2e5d Update submodules Jan 3, 2020
Nintendo - Nintendo DSi @ ca5aed9 Hopefully fix the dirty state after a git clone Aug 22, 2018
Nintendo - Nintendo Entertainment System @ c59eeb3 Update submodules Jan 3, 2020
Nintendo - Pokemon Mini @ b67087b Update submodules Jan 3, 2020
Nintendo - Satellaview @ 706559d Update submodules Jan 3, 2020
Nintendo - Sufami Turbo @ 8b25f86 Update submodules Jan 3, 2020
Nintendo - Super Nintendo Entertainment System @ 5a537f8 Update submodules Jan 3, 2020
Nintendo - Virtual Boy @ 13d494e Update submodules Jan 3, 2020
Nintendo - Wii @ 841dc8d Update submodules Jan 3, 2020
Nintendo - Wii U @ 6f3e9c5 Update submodules Nov 19, 2018
Philips - Videopac+ @ fdb4fb8 Update Submodules Oct 1, 2018
Quake @ 6fc579e Rename Quake1 to Quake Jul 30, 2019
Quake II @ bab3956 Add Quake II Oct 13, 2019
Quake III @ e4259ad Add Quake III Oct 17, 2019
RCA - Studio II @ 3cadbee Update Submodules Oct 1, 2018
RPG Maker @ 9217e21 Update submodules Jan 3, 2020
Rick Dangerous @ 3247c41 Update Dec 12, 2017
SNK - Neo Geo @ 2caeb52 Update submodules Jan 3, 2020
SNK - Neo Geo CD @ 9d379f7 Update submodules Jul 19, 2019
SNK - Neo Geo Pocket @ 82d0f0c Update submodules Jan 3, 2020
SNK - Neo Geo Pocket Color @ 5eedf5a Update submodules Jul 19, 2019
ScummVM @ 7ef00a2 Update submodules Jan 3, 2020
Sega - 32X @ 014c7a8 Update Submodules Oct 1, 2018
Sega - Dreamcast @ 3e80dea Update submodules Jan 3, 2020
Sega - Game Gear @ 0c6b03a Update submodules Nov 19, 2018
Sega - Master System - Mark III @ bfdd341 Update submodules Jan 3, 2020
Sega - Mega Drive - Genesis @ 2b8bc06 Update submodules Jan 3, 2020
Sega - Mega-CD - Sega CD @ 6817f26 Update submodules Jan 3, 2020
Sega - PICO @ 8469563 Update Submodules Oct 1, 2018
Sega - SG-1000 @ 25b7c6e Update submodules Jan 3, 2020
Sega - Saturn @ 1b65f3a Update submodules Jan 3, 2020
Sharp - X68000 @ 99d5833 Update submodules Jan 3, 2020
Sinclair - ZX 81 @ 83683c5 Update Submodules Oct 1, 2018
Sinclair - ZX Spectrum @ d23c953 Update Submodules Oct 1, 2018
Sony - PlayStation @ 7ef9121 Update submodules Jan 3, 2020
Sony - PlayStation 2 @ 63153ac Update Submodules Mar 14, 2019
Sony - PlayStation 3 @ d2643d9 Update submodules Jan 3, 2020
Sony - PlayStation 3 (Downloadable) @ 2b412db Hopefully fix the dirty state after a git clone Aug 22, 2018
Sony - PlayStation 4 @ 46b4c6b Hopefully fix the dirty state after a git clone Aug 22, 2018
Sony - PlayStation Portable @ 4a4ed3e Update submodules Jan 3, 2020
Sony - PlayStation Vita @ 0885baf Hopefully fix the dirty state after a git clone Aug 22, 2018
TIC-80 @ 23ccc17 Update submodules Jan 3, 2020
The 3DO Company - 3DO @ 396f3ba Update submodules Nov 19, 2018
Thomson - MOTO @ b825374 Update submodules Jan 3, 2020
Tiger - Game.com @ 2eb7222 Update submodules Jan 3, 2020
Tomb Raider @ cda4cee Update Submodules Mar 14, 2019
VTech - CreatiVision @ f7644eb Update Submodules Oct 1, 2018
VTech - V.Smile @ 9a16f71 Update submodules Jan 3, 2020
Watara - Supervision @ 0116747 Update submodules Jan 3, 2020
.gitignore Add make packs to create the thumbnail archive packs Jul 25, 2017
.gitmodules Add Quake III Oct 17, 2019
Makefile Change PACKSDIR from := to ?= Sep 10, 2019
README.md Add server documentation Sep 9, 2019
update_modules.sh Let gc kick in automatically, should speedup and increase depth in ca… Oct 15, 2018

README.md

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.

You can’t perform that action at this time.