RetroReel

A Playnite plugin that imports video previews (snaps) for emulated games, integrating with ExtraMetadata Loader.

Features

• Local Import — copies videos already downloaded by RetroBat/Skraper to the correct ExtraMetadata folder.
• Online Download — searches and downloads videos directly from ScreenScraper.fr.
• Local + Online — attempts local import first, using ScreenScraper as an automatic fallback.

All modes work across three scopes: all games, selected games, or filtered games (current view).

Requirements

• Playnite 9+
• ExtraMetadata Loader installed (displays the videos in the UI).
• A ScreenScraper.fr account (for online mode).

Configuration

Local Mode (RetroBat)

1. Go to Playnite → Add-ons → RetroReel → Settings.
2. In the Platforms section, add each platform and point it to the RetroBat videos folder.
   • Example: K:\Games\Emulation\RetroBat\roms\ps2\videos
3. Use the menu Tools → RetroReel → Local Import.

The default naming pattern for RetroBat videos is {rom_name}-video.mp4 — the plugin detects this automatically.

Online Mode (ScreenScraper)

Two types of accounts are required:

1. User Account (free)

• Register at https://www.screenscraper.fr/

2. Developer Account (free)

• Access the forum: https://www.screenscraper.fr/forums/
• Request a devid and devpassword in the API registration thread.
• Mention that you are developing a plugin for Playnite.

Once you have obtained your credentials, configure them in Settings → RetroReel → ScreenScraper.

Search Strategy (Online Mode)

For each game, RetroReel attempts the following in order:

1. ROM Hash (CRC32/MD5/SHA1) — exact match (only for files below the configured limit, default 100 MB — ideal for cartridges and floppies).
2. Clean file name — removes region tags (USA), website tags (www.xxx), version tags (v1.0), etc.
3. Normalized name — converts numerals: God of War II ↔ God of War 2.
4. Playnite game name — as a last resort.

This allows the plugin to find videos even for translated, dubbed, or modified ROMs, using the base title of the original game.

Where Videos Are Saved

%AppData%\Playnite\ExtraMetadata\games\{GameId}\VideoTrailer.mp4

This is the exact same path used by ExtraMetadata Loader — the videos will display automatically.

Platforms with Automatic Mapping

Sony PlayStation · PS2 · PSP · NES · SNES · Nintendo 64 · GameCube · Wii · Wii U · DS · 3DS · Game Boy · GBC · GBA · Sega Genesis/Mega Drive · Saturn · Dreamcast · Master System · Game Gear · Arcade/MAME/FBNeo · Atari 2600/7800 · Neo Geo · PC Engine/TurboGrafx-16 · Xbox · Xbox 360

For other platforms, manually add the ID in the SS ID column in the settings. Complete list: https://www.screenscraper.fr/api2/systemesListe.php

License

MIT