Retro gaming metadata guide · Updated September 2026
Direct answer: ScreenScraper wins for deep retro and arcade coverage with region-specific box art, while TheGamesDB wins for open access and a simpler setup. Your ROM library, your frontend, and your patience for registration rules decide the real winner.
Every RetroPie, Batocera, or Skraper user hits the same wall eventually. Your gamelist looks empty, your box art refuses to download, and two names keep showing up in every forum thread: ScreenScraper and TheGamesDB.
This guide compares both platforms on facts you can verify yourself. We checked ScreenScraper's own API terms page, TheGamesDB's public GitHub repository, and real community reports from RetroPie and LaunchBox forums. No guessed numbers, no filler.
Quick Comparison Table
| Factor | ScreenScraper | TheGamesDB |
|---|---|---|
| Primary focus | Retro consoles and arcade only | Broad video game catalogue |
| Registration needed | Yes, an account is required for full scraping | Yes, a free API key is required |
| App licensing rule | Free and open apps only, or approved by the team | Standard developer API terms, no special approval step reported |
| Speed and quota | Thread-based; more threads unlock through contribution or donation | Standard rate-limited key access |
| Regional art variants | Strong (USA/EU/JP splits common) | Lighter regional coverage |
| Codebase visibility | Closed-source platform | Open-source repository on GitHub |
What Is ScreenScraper?
ScreenScraper.fr is a French, community-run metadata source built specifically for retro and arcade games. It supplies data to some of the most-used emulation frontends today.
- Focus: Retro consoles, handhelds, and arcade boards, including many region-only releases.
- Access model: Requires a free account before most scraping tools can pull data reliably.
- Usage terms: The API may only be built into free, non-commercial, and openly distributed applications, or apps with the team's prior written approval.
- Media library: Box art, screenshots, wheel art, fanart, and video previews, often split by region (USA, Japan, Europe).
- Used by: RetroPie, Recalbox, Batocera, EmulationStation-DE, and the third-party tool Skraper.
What Is TheGamesDB?
TheGamesDB (TGDB) started as an open, community-editable video game wiki-database. It later added a proper REST API for developers.
- Focus: General video game metadata across retro and modern platforms, not retro-exclusive.
- Access model: Free API key registration through their developer portal, no application review needed.
- Openness: The platform's source code lives publicly on GitHub under the TheGamesDB organisation, and some community API clients describe the underlying data as public-domain friendly.
- Media library: Box art, banners, clear logos, and fan art, with lighter regional splitting than ScreenScraper.
- Used by: Sselph's Scraper (labelled "gdb" in its own documentation), older Kodi add-ons, and various community scripts.
API Access, Licensing, and the Rules People Skip
Most scraping complaints come from skipped terms pages, not bad databases. Read the rules first and half your problems disappear.
- ScreenScraper restricts commercial use. Its own policy states the API integrates only into free, distributed software, or apps with direct permission from the team.
- Non-registered accounts get locked out during high traffic. RetroPie's own forum documents users hitting the exact error message "API closed for non-registered members" during busy periods.
- TheGamesDB keeps its source code public. Developers can inspect the actual platform code instead of trusting a black box.
- Neither database guarantees 100% coverage. Obscure regional releases and homebrew titles can be missing from both.
Speed, Quotas, and Why Your Scrape Feels Slow
ScreenScraper assigns scraping threads based on your contribution level to the site. Financial support or content contributions unlock more simultaneous requests, which speeds up large ROM libraries.
TheGamesDB uses a more conventional API key and rate-limit structure, closer to what most developers already expect from a typical REST service.
- Big collections (thousands of ROMs) scrape faster on ScreenScraper once you contribute or donate for extra threads.
- Small or one-off scrapes often feel simpler on TheGamesDB because there is no thread-tier system to learn.
- Both platforms can slow down during peak community traffic, based on forum reports from RetroPie users.
Which Tools Actually Use Each Database?
| Tool / Frontend | ScreenScraper | TheGamesDB |
|---|---|---|
| RetroPie / EmulationStation | Yes | Supported via Sselph's Scraper |
| Recalbox | Yes | Not a primary source |
| Batocera | Yes | Not a primary source |
| Skraper | Yes, built specifically around it | No |
| LaunchBox | Community integrations exist | Dropped in favour of its own LaunchBox Games Database |
Note: LaunchBox now runs its own separate "LaunchBox Games Database," which is a different project from TheGamesDB, according to LaunchBox's own bug tracker discussions.
Pros and Cons at a Glance
ScreenScraper
- Pro: Deep retro and arcade coverage, including many region-specific titles.
- Pro: Rich regional art variants for box art and screenshots.
- Con: Registration is required, and traffic spikes can lock out casual users.
- Con: Licensing terms restrict commercial or closed-source apps without approval.
TheGamesDB
- Pro: Open-source codebase builds developer trust.
- Pro: Simple API key process without an application review.
- Con: Weaker regional art splitting compared with ScreenScraper.
- Con: Fewer major frontends treat it as their primary source today.
Which One Should You Choose?
- Choose ScreenScraper if you run RetroPie, Batocera, Recalbox, or Skraper, and you need deep arcade or console coverage with regional box art.
- Choose TheGamesDB if you are building a small tool or personal script and want an open, low-friction API without an approval process.
- Use both if you want maximum coverage. Many community scrapers, including Sselph's Scraper, let you set a fallback order between the two.
Common Mistakes People Make
Retro gaming forums repeat the same three mistakes every year. Skip these, and your scrape goes smoother than a mint-condition cartridge.
- Scraping without an account, then blaming the database for "API closed" errors.
- Ignoring the licensing page and building a commercial app on a free-only API.
- Assuming one database, one attempt is enough for a 10,000-game ROM folder.
Frequently Asked Questions
Is ScreenScraper free to use?
Yes, registration is free, but heavier or commercial use may need direct approval from the ScreenScraper team under their published terms.
Does TheGamesDB require an account?
Yes, developers need a free API key from TheGamesDB's developer portal to pull data through the current REST API.
Can I use both databases in one scraper?
Yes. Community tools like Sselph's Scraper already support both as configurable, fallback data sources.
Which database has better box art?
ScreenScraper generally offers stronger regional art variants, based on its documented USA, Europe, and Japan splits.
Does LaunchBox use TheGamesDB?
Not anymore. LaunchBox now maintains its own separate LaunchBox Games Database, distinct from TheGamesDB.net.
Final Thoughts
ScreenScraper and TheGamesDB solve different problems. One chases retro depth and regional accuracy. The other chases openness and a lighter onboarding process.
Match the database to your frontend and your project's licensing needs, and the "which one wins" debate mostly solves itself.
Want more researched, fact-checked technology explainers like this one for your own site? Browse related write-ups on our General Knowledge blog for more deep-dive comparisons.
Sources
- ScreenScraper API usage terms discussion, LaunchBox bug tracker
- RetroPie forum: "API closed for non-registered members" report
- TheGamesDB official open-source repository, GitHub
- Sselph's Scraper documentation, showing ScreenScraper and TheGamesDB as configurable sources
- LaunchBox bug tracker confirming its move away from TheGamesDB
Retro gaming metadata guide · Updated September 2026
Direct answer: ScreenScraper wins for deep retro and arcade coverage with region-specific box art, while TheGamesDB wins for open access and a simpler setup. Your ROM library, your frontend, and your patience for registration rules decide the real winner.
Every RetroPie, Batocera, or Skraper user hits the same wall eventually. Your gamelist looks empty, your box art refuses to download, and two names keep showing up in every forum thread: ScreenScraper and TheGamesDB.
This guide compares both platforms on facts you can verify yourself. We checked ScreenScraper's own API terms page, TheGamesDB's public GitHub repository, and real community reports from RetroPie and LaunchBox forums. No guessed numbers, no filler.
Quick Comparison Table
| Factor | ScreenScraper | TheGamesDB |
|---|---|---|
| Primary focus | Retro consoles and arcade only | Broad video game catalogue |
| Registration needed | Yes, an account is required for full scraping | Yes, a free API key is required |
| App licensing rule | Free and open apps only, or approved by the team | Standard developer API terms, no special approval step reported |
| Speed and quota | Thread-based; more threads unlock through contribution or donation | Standard rate-limited key access |
| Regional art variants | Strong (USA/EU/JP splits common) | Lighter regional coverage |
| Codebase visibility | Closed-source platform | Open-source repository on GitHub |
What Is ScreenScraper?
ScreenScraper.fr is a French, community-run metadata source built specifically for retro and arcade games. It supplies data to some of the most-used emulation frontends today.
- Focus: Retro consoles, handhelds, and arcade boards, including many region-only releases.
- Access model: Requires a free account before most scraping tools can pull data reliably.
- Usage terms: The API may only be built into free, non-commercial, and openly distributed applications, or apps with the team's prior written approval.
- Media library: Box art, screenshots, wheel art, fanart, and video previews, often split by region (USA, Japan, Europe).
- Used by: RetroPie, Recalbox, Batocera, EmulationStation-DE, and the third-party tool Skraper.
What Is TheGamesDB?
TheGamesDB (TGDB) started as an open, community-editable video game wiki-database. It later added a proper REST API for developers.
- Focus: General video game metadata across retro and modern platforms, not retro-exclusive.
- Access model: Free API key registration through their developer portal, no application review needed.
- Openness: The platform's source code lives publicly on GitHub under the TheGamesDB organisation, and some community API clients describe the underlying data as public-domain friendly.
- Media library: Box art, banners, clear logos, and fan art, with lighter regional splitting than ScreenScraper.
- Used by: Sselph's Scraper (labelled "gdb" in its own documentation), older Kodi add-ons, and various community scripts.
API Access, Licensing, and the Rules People Skip
Most scraping complaints come from skipped terms pages, not bad databases. Read the rules first and half your problems disappear.
- ScreenScraper restricts commercial use. Its own policy states the API integrates only into free, distributed software, or apps with direct permission from the team.
- Non-registered accounts get locked out during high traffic. RetroPie's own forum documents users hitting the exact error message "API closed for non-registered members" during busy periods.
- TheGamesDB keeps its source code public. Developers can inspect the actual platform code instead of trusting a black box.
- Neither database guarantees 100% coverage. Obscure regional releases and homebrew titles can be missing from both.
Speed, Quotas, and Why Your Scrape Feels Slow
ScreenScraper assigns scraping threads based on your contribution level to the site. Financial support or content contributions unlock more simultaneous requests, which speeds up large ROM libraries.
TheGamesDB uses a more conventional API key and rate-limit structure, closer to what most developers already expect from a typical REST service.
- Big collections (thousands of ROMs) scrape faster on ScreenScraper once you contribute or donate for extra threads.
- Small or one-off scrapes often feel simpler on TheGamesDB because there is no thread-tier system to learn.
- Both platforms can slow down during peak community traffic, based on forum reports from RetroPie users.
Which Tools Actually Use Each Database?
| Tool / Frontend | ScreenScraper | TheGamesDB |
|---|---|---|
| RetroPie / EmulationStation | Yes | Supported via Sselph's Scraper |
| Recalbox | Yes | Not a primary source |
| Batocera | Yes | Not a primary source |
| Skraper | Yes, built specifically around it | No |
| LaunchBox | Community integrations exist | Dropped in favour of its own LaunchBox Games Database |
Note: LaunchBox now runs its own separate "LaunchBox Games Database," which is a different project from TheGamesDB, according to LaunchBox's own bug tracker discussions.
Pros and Cons at a Glance
ScreenScraper
- Pro: Deep retro and arcade coverage, including many region-specific titles.
- Pro: Rich regional art variants for box art and screenshots.
- Con: Registration is required, and traffic spikes can lock out casual users.
- Con: Licensing terms restrict commercial or closed-source apps without approval.
TheGamesDB
- Pro: Open-source codebase builds developer trust.
- Pro: Simple API key process without an application review.
- Con: Weaker regional art splitting compared with ScreenScraper.
- Con: Fewer major frontends treat it as their primary source today.
Which One Should You Choose?
- Choose ScreenScraper if you run RetroPie, Batocera, Recalbox, or Skraper, and you need deep arcade or console coverage with regional box art.
- Choose TheGamesDB if you are building a small tool or personal script and want an open, low-friction API without an approval process.
- Use both if you want maximum coverage. Many community scrapers, including Sselph's Scraper, let you set a fallback order between the two.
Common Mistakes People Make
Retro gaming forums repeat the same three mistakes every year. Skip these, and your scrape goes smoother than a mint-condition cartridge.
- Scraping without an account, then blaming the database for "API closed" errors.
- Ignoring the licensing page and building a commercial app on a free-only API.
- Assuming one database, one attempt is enough for a 10,000-game ROM folder.
Frequently Asked Questions
Is ScreenScraper free to use?
Yes, registration is free, but heavier or commercial use may need direct approval from the ScreenScraper team under their published terms.
Does TheGamesDB require an account?
Yes, developers need a free API key from TheGamesDB's developer portal to pull data through the current REST API.
Can I use both databases in one scraper?
Yes. Community tools like Sselph's Scraper already support both as configurable, fallback data sources.
Which database has better box art?
ScreenScraper generally offers stronger regional art variants, based on its documented USA, Europe, and Japan splits.
Does LaunchBox use TheGamesDB?
Not anymore. LaunchBox now maintains its own separate LaunchBox Games Database, distinct from TheGamesDB.net.
Final Thoughts
ScreenScraper and TheGamesDB solve different problems. One chases retro depth and regional accuracy. The other chases openness and a lighter onboarding process.
Match the database to your frontend and your project's licensing needs, and the "which one wins" debate mostly solves itself.
Want more researched, fact-checked technology explainers like this one for your own site? Browse related write-ups on our General Knowledge blog for more deep-dive comparisons.
Sources
- ScreenScraper API usage terms discussion, LaunchBox bug tracker
- RetroPie forum: "API closed for non-registered members" report
- TheGamesDB official open-source repository, GitHub
- Sselph's Scraper documentation, showing ScreenScraper and TheGamesDB as configurable sources
- LaunchBox bug tracker confirming its move away from TheGamesDB
