Jump to content
LaunchBox Community Forums

1 Screenshot

About This File

The Game Scraper for LaunchBox

Steam metadata, artwork, trailers, IGDB metadata, SteamGridDB artwork, YouTube videos, HowLongToBeat custom fields, and bulk cleanup tools for LaunchBox.

The Game Scraper is a LaunchBox plugin built to fill in missing metadata and media for PC games and mixed libraries. It can scrape game details, artwork, trailers, tags, player perspective data, HowLongToBeat play times, and more while giving you tools to review anything it cannot confidently match.


Why This Exists

LaunchBox is great at organizing games, but PC game metadata can be limited depending on how the game was added.

LaunchBox will not pull metadata or media from stores like Steam unless the game was imported from that store. That means manually imported PC games will only get metadata and media from the LaunchBox Games Database and, if configured, EmuMovies.

The Game Scraper started as a way to get Steam metadata and media for PC games that were manually imported into LaunchBox and not imported from any store.

Since then, it has grown into a larger scraping workbench. It can still do the simple Steam cleanup job, but it can also use IGDB, SteamGridDB, YouTube, and HowLongToBeat to fill gaps, improve artwork, download trailers, add custom fields, and help clean up large libraries without forcing you to fix every game one by one.


Quick Start For PC / Steam Scraping

If all you want is Steam metadata and Steam media for PC games, you can keep it simple.

  1. Select one or more PC games in LaunchBox.
  2. Right-click and choose The Game Scraper.
  3. Set the scraper mode to Auto.
  4. Enable metadata.
  5. If you want trailers, enable videos and set the video source to Steam.
  6. Start the batch.
  7. Review anything that gets sent to the Fixer.

In Auto mode, PC platforms are prioritized through Steam. The plugin attempts to identify the game, pull Steam metadata and Steam media, and update the selected LaunchBox fields.

For most users who only want PC game scraping from Steam, the easiest starting point is:

Auto mode + Videos set to Steam.

This will get you most Steam fields, images, and trailers from the title’s Steam store page.

This quick-start setup is intended for Steam scraping only. More advanced sources such as IGDB, SteamGridDB, YouTube, and HowLongToBeat are covered below.


What It Can Update

The Game Scraper can update or add the following.

Items marked with * require an API key or extra dependency.

Metadata Media Tags & Custom Fields
Title Box / front cover Steam tags
Developer Banner / header images IGDB keywords*
Publisher Hero / fanart backgrounds IGDB themes*
Notes / description Clear logos Discovery Tags custom field
Series Gameplay screenshots Player Perspective custom field*
Release date / year Steam Store trailers HowLongToBeat play time custom fields
Genres YouTube trailers* Length Category custom field
Play modes   Installed status, if enabled
Ratings    
Community rating    

* Dependency notes:

  • IGDB keywords, IGDB themes, and Player Perspective require IGDB credentials.
  • SteamGridDB artwork requires a SteamGridDB API key.
  • YouTube trailers require yt-dlp.exe and ffmpeg.exe.
  • aria2c.exe can optionally speed up video downloads.
  • deno.exe is not required to launch the plugin, but is included to help yt-dlp handle YouTube extraction more reliably when needed.
  • HowLongToBeat does not require FlareSolverr for normal use, but FlareSolverr can be used as a fallback.

Main Sources

Steam

Steam is the primary source for PC game scraping.

It can provide store metadata, descriptions, developers, publishers, release dates, genres, Steam tags, ratings, screenshots, header images, official videos, and other Steam-linked media.

For PC games, Steam is usually the best first source because it provides the store data LaunchBox does not pull unless the game was imported from Steam.

IGDB

IGDB is used for console, handheld, arcade, retro computer, and non-Steam metadata.

It can also help fill missing details for PC games when Steam does not provide everything you want or when the title is not on Steam.

IGDB keywords and themes are treated as Discovery Tags by the plugin.

Player Perspective is written as a LaunchBox custom field.

IGDB requires a free Twitch developer application so you can get a Client ID and Client Secret.

IGDB API setup:

IGDB API Getting Started

SteamGridDB

SteamGridDB is used for high-quality artwork.

It is especially useful when Steam or IGDB artwork is missing, low quality, or not the style you want. It can help find better covers, heroes, logos, grids, and other community-sourced assets.

SteamGridDB requires an API key.

SteamGridDB API Preferences

YouTube

YouTube is used for trailers when a Steam video is not available or when you choose YouTube as the video source.

The plugin searches for likely trailer matches, filters out obvious bad candidates such as reviews, longplays, reactions, unrelated videos, and overly long content, and skips items when it is not confident enough.

YouTube video downloading uses yt-dlp and ffmpeg. aria2c can optionally speed up downloads, and deno.exe is included to help yt-dlp handle YouTube extraction more reliably when needed.

When using YouTube, you can choose the suffix the plugin adds to the search. For older games, terms like gameplay or longplay may work better than trailer.

Because YouTube is not a games database, matching can be difficult. False positives are possible, but newer updates are designed to reduce them. Titles that cannot be confidently identified can be sent to the Fixer.

HowLongToBeat

HowLongToBeat is used to populate LaunchBox custom fields for play time data.

It can add custom fields for:

  • Main Story
  • Main + Extra
  • Completionist
  • Co-Op
  • Vs.
  • Length Category

Length categories can be used to build dynamic playlists.

Example categories:

  • Quick: under 5 hours
  • Standard: 5-15 hours
  • Extended: 15-30 hours
  • Long: 30-60 hours
  • Massive: over 60 hours

Previous versions used FlareSolverr for HowLongToBeat. The current version uses direct scraping and does not require FlareSolverr for normal use. FlareSolverr support remains available only as a fallback option in case future HowLongToBeat changes affect scraping reliability.

To set up FlareSolverr as a fallback, simply put your FlareSolverr URL in the FlareSolverr box.


Scrape Modes

Auto

The recommended mode for most users.

PC platforms prioritize Steam. Console, handheld, arcade, and retro platforms prioritize IGDB. When possible, the plugin can use other sources to fill in missing fields.

Steam

Forces Steam as the primary source.

Best for PC games and Steam-linked titles.

IGDB

Forces IGDB as the primary source.

Best for console, handheld, arcade, and non-Steam games.

Manual

Skips automatic identification and sends games to manual review.

Use this when you already know the automatic match is likely to be difficult.

Custom Workbench

Lets you choose different sources for different types of data.

Example:

Field Source
Metadata IGDB
Artwork SteamGridDB
Videos YouTube
Play Times HLTB

Custom Workbench is useful when you want very specific control, such as Steam videos, SteamGridDB artwork, IGDB metadata, and HLTB play times in the same pass.


The Fixer

When the plugin cannot confidently match something, it sends the item to the Fixer instead of silently guessing. The Fixer appears after the scan has finished.

The Fixer helps with:

  • Metadata with no match found
  • Low-confidence metadata matches
  • Missing artwork
  • Ambiguous HLTB matches
  • Missing videos
  • Other scraping issues

Depending on the issue, you can:

  • Pick from possible matches
  • Paste a Steam, IGDB, SteamGridDB, HLTB, or YouTube URL
  • Enter a custom search term
  • Skip the item
  • Retry the batch
  • Purge scraper-generated content for selected rows

This is meant to keep automation fast without forcing bad matches into your library.


Video Downloading

The plugin can download trailers from the Steam Store or YouTube.

Steam videos are recommended for the simplest PC scraping setup because they come directly from the Steam Store when available.

YouTube can be used when Steam does not have a trailer or when you specifically want YouTube as the video source. YouTube matching is intentionally conservative because YouTube does not provide a perfect one-to-one game matching system. It is recommended to utilize the suffix setting when downloading from youtube. Using "Gameplay" instead of the default "Trailer" helps with older games. 

For YouTube, the plugin uses yt-dlp and ffmpeg to download and process videos. aria2c can optionally be used as an external downloader for faster downloads. deno.exe is included as a helper for yt-dlp when YouTube extraction needs it.

The plugin attempts to reject bad YouTube matches such as:

  • Reviews
  • Reactions
  • Let’s Plays
  • Walkthroughs
  • Longplays
  • Unrelated videos
  • Videos that are too long

 

If a video cannot be found, the game can be sent to the Fixer where you can paste a direct YouTube URL or try a better search term.


Included Files And Dependencies

These are the files included with the plugin archive. Most users should leave them together in the plugin folder.

  • TheGameScraper.dll - Required - Main LaunchBox plugin. Adds the right-click The Game Scraper menu item and runs the metadata, image, video, HLTB, Fixer, and Custom Workbench logic.
  • SteamKit2.dll - Required - Managed dependency used for Steam AppInfo, metadata, tags, and Steam asset discovery.
  • DiscoveryData.json - Required if Discovery Tags are enabled - Local vocabulary and mapping file used for Discovery Tags and Player Perspective.
  • yt-dlp.exe - Required for videos - Downloads Steam and YouTube videos. Required when video downloading is enabled.
  • ffmpeg.exe - Required for videos - Used by yt-dlp to merge, convert, and process video/audio streams. Required when video downloading is enabled.
  • aria2c.exe - Optional - Speeds up video downloads as an external downloader. The plugin can fall back without it.
  • deno.exe - Optional / recommended for YouTube reliability - Not required to launch the plugin, but included because yt-dlp may need an external JavaScript runtime for some YouTube extraction cases.
  • TheGameScraper.pdb - Optional / developer file - Debug symbols. Not required for normal use, but helpful for crash reports and stack traces.

User-Provided API Keys And Optional Integrations

These are not required to launch the plugin, but they enable extra features.

  • SteamGridDB API key
    Required for SteamGridDB artwork.
    Get it here: SteamGridDB API Preferences
  • IGDB Client ID and Client Secret
    Required for IGDB metadata, IGDB keywords, IGDB themes, player perspective, and platform-aware console scraping.
    Setup guide: IGDB API Getting Started
  • cookies.txt
    Optional for YouTube videos that require cookies, such as restricted or age-gated content.
  • FlareSolverr URL
    Optional HLTB fallback only. It is not required for normal HowLongToBeat scraping.

Generated Local Files

These files may appear after using the plugin, but they are not files you need to include in a release archive.

  • config.json - Generated / local settings - Stores plugin settings, API keys, overwrite flags, video settings, HLTB URL, and other local options. Do not upload or share this file publicly if it contains your API keys.
  • TheGameScraper.log - Generated / troubleshooting - Runtime log. Safe to delete when LaunchBox is closed; the plugin will recreate it.

Installation

  1. Close LaunchBox.
  2. Extract the archive into your LaunchBox Plugins directory.
  3. Reopen LaunchBox.
  4. Select one or more games.
  5. Right-click and choose The Game Scraper.

Recommended First Run

For your first test, try a small batch of manually imported PC games.

Recommended simple Steam-only settings:

  • Mode: Auto
  • Metadata: enabled
  • Videos: enabled if you want trailers
  • Video source: Steam
  • Overwrite: leave off unless you specifically want existing data replaced

Once you are comfortable with the Steam results, you can start enabling more advanced sources such as SteamGridDB, IGDB, YouTube, and HowLongToBeat.


Better PC Game Importer Integration

If you use Better PC Game Importer, The Game Scraper can integrate with it.

When enabled, it can help keep installed PC game folders, shortcuts, and LaunchBox paths in sync after a title is cleaned up or renamed. This is useful when imported PC games have messy folder names or shortcut names and you want the library to stay consistent.


Thanks

Thanks to mo50cal for helping catch poor YouTube matching with false positives. The feedback and logs helped improve the matching logic and reduce bad video results.

Edited by spiritedusual
Updated readme


What's New in Version 2.9   See changelog

Released

No changelog available for this version.

  • Like 2
  • Thanks 4

User Feedback

Recommended Comments



bundangdon

Posted

Wow! This plugin was really helpful. I was able to get metadata and artwork for almost all of the missing PC game titles in my Launchbox setup. Thanks a lot for sharing this!

Martin Turesson

Posted

Is Launchbox 13.24 supported? When in manage/plugins it does not appear. I've put all 3 files (ffmpeg.exe) + (yt-dlp.exe) + (Pc Games Scraper.dll) in the \LaunchBox\Plugins folder. Also tried in a separate folder within plugins named PCGamesScraper.

  • Like 1
lessthanzero33

Posted

1 hour ago, Martin Turesson said:

Is Launchbox 13.24 supported? When in manage/plugins it does not appear. I've put all 3 files (ffmpeg.exe) + (yt-dlp.exe) + (Pc Games Scraper.dll) in the \LaunchBox\Plugins folder. Also tried in a separate folder within plugins named PCGamesScraper.

Same as Martin!, no matter what i did with the plugin, it would not appear at all and i also placed all 3 files inside the "Launchbox Plugins" folder itself and they still did not show.

spiritedusual

Posted

3 hours ago, Martin Turesson said:

Is Launchbox 13.24 supported? When in manage/plugins it does not appear. I've put all 3 files (ffmpeg.exe) + (yt-dlp.exe) + (Pc Games Scraper.dll) in the \LaunchBox\Plugins folder. Also tried in a separate folder within plugins named PCGamesScraper.

 

2 hours ago, lessthanzero33 said:

Same as Martin!, no matter what i did with the plugin, it would not appear at all and i also placed all 3 files inside the "Launchbox Plugins" folder itself and they still did not show.

Try again. I used the latest beta plugin.dll on the first release. You should be good now. 

  • Like 1
spiritedusual

Posted

6 hours ago, bundangdon said:

Wow! This plugin was really helpful. I was able to get metadata and artwork for almost all of the missing PC game titles in my Launchbox setup. Thanks a lot for sharing this!

Thanks Im super happy with it! Keep checking back I just added HLTB support and plan on adding IGDB as well. 

  • Thanks 1
Martin Turesson

Posted (edited)

Thanks, working fine now. Awesome tool! :)

Edited by Martin Turesson
  • Like 1
spiritedusual

Posted

1 hour ago, Martin Turesson said:

Thanks, working fine now. Awesome tool! :)

Thanks let me know if you find any issues or have ideas! 

  • Like 1
TekkamanBlade

Posted

Tried one game and it worked like a charm. Thanks!

  • Like 1
Kits

Posted

Awesome tool, thank you ! 

  • Like 1
spiritedusual

Posted

2 minutes ago, lessthanzero33 said:

Plugin is not showing anymore in my Launchbox

Do you have the newest version of the plugin? I had forgotten to use the correct dll on a rollback and instead had the newest beta version.

  • Like 1
Partiesplayin

Posted (edited)

i get this error after entering a steam link and clicking download.   

 

Object reference not set to an instance of an object.

App:     LaunchBox
Version: 13.26
Theme:   Default
Type:    System.NullReferenceException
Site:    Void MoveNext()
Source:  SteamScraper

   at SteamScraper.SteamApi.SteamSearchAsync(String appId) in D:\a\launchbox_steamscraper\launchbox_steamscraper\SteamScraper\SteamApi.cs:line 78
   at SteamScraper.Form1.button1_Click(Object sender, EventArgs e) in D:\a\launchbox_steamscraper\launchbox_steamscraper\SteamScraper\Form1.cs:line 47
   at System.Threading.Tasks.Task.<>c.<ThrowAsync>b__128_0(Object state)
   at System.Windows.Threading.ExceptionWrapper.InternalRealCall(Delegate callback, Object args, Int32 numArgs)
   at System.Windows.Threading.ExceptionWrapper.TryCatchWhen(Object source, Delegate callback, Object args, Int32 numArgs, Delegate catchHandler)

Recent Log:

   11:24:23 AM Exception

Edited by Partiesplayin
spiritedusual

Posted (edited)

16 minutes ago, Partiesplayin said:

i get this error after entering a steam link and clicking download.   

 

Object reference not set to an instance of an object.

App:     LaunchBox
Version: 13.26
Theme:   Default
Type:    System.NullReferenceException
Site:    Void MoveNext()
Source:  SteamScraper

   at SteamScraper.SteamApi.SteamSearchAsync(String appId) in D:\a\launchbox_steamscraper\launchbox_steamscraper\SteamScraper\SteamApi.cs:line 78
   at SteamScraper.Form1.button1_Click(Object sender, EventArgs e) in D:\a\launchbox_steamscraper\launchbox_steamscraper\SteamScraper\Form1.cs:line 47
   at System.Threading.Tasks.Task.<>c.<ThrowAsync>b__128_0(Object state)
   at System.Windows.Threading.ExceptionWrapper.InternalRealCall(Delegate callback, Object args, Int32 numArgs)
   at System.Windows.Threading.ExceptionWrapper.TryCatchWhen(Object source, Delegate callback, Object args, Int32 numArgs, Delegate catchHandler)

Recent Log:

   11:24:23 AM Exception

Hey I'm not at a computer right but can you tell me exactly what you did step by step from opening the plugin to when you get this error? Which game what platform etc... also the plugin has a log file it generates at each run can you post that as well?

Edited by spiritedusual
Partiesplayin

Posted (edited)

6 minutes ago, spiritedusual said:

Hey I'm not at a computer right but can you tell me exactly what you did step by step from opening the plugin to when you get this error? Which game what platform etc... also the plugin has a log file it generates at each run can you post that as well?   yes,  it is a windows game platform, game is called Afallon, i downloaded the file to a seperate folder, then i moved the zip to the plugins folder, extracted to steamscrapper2.9/ , launched launchbox, added a game and launch location, right clicks and selected steam scraper, pasted url and hit download then got that error

 

Edited by Partiesplayin
spiritedusual

Posted

3 minutes ago, Partiesplayin said:

I do not know where to find the log

 

It's in the same folder as the plugin

Partiesplayin

Posted

Do i need any additional files beyond what i downloaded just to get images and metadata?

 

spiritedusual

Posted (edited)

2 hours ago, Partiesplayin said:

Do i need any additional files beyond what i downloaded just to get images and metadata?

 

No everything you may need is in the archive and the log is created as soon as you click the plugin even if you cancel right away you should have something. Please send a screenshot of your plugin folder with all the files. And please still detail your exact situation as well.

Edited by spiritedusual
mrpetenorth

Posted (edited)

Totally ready to accept that I'm doing something wrong, but set up as instructed and I get a "video processing..." message which takes a minute or two, but every game I get "Metadate updated: 1, Images downloaded: 1, Video downloaded: 0". These are major games which are definitely on Steam, but I've also tried from YouTube, usually the same result but occasionally asks me to specify a url for desired video - but still fails. I see no added media following use.

EDIT I don't know why it's telling me videos and images haven't been downloaded, because they have, but my folder structure is not the default lb structure so they're in the wrong place. Future plugin option to specify paths?

Edited by mrpetenorth
spiritedusual

Posted

2 hours ago, mrpetenorth said:

Totally ready to accept that I'm doing something wrong, but set up as instructed and I get a "video processing..." message which takes a minute or two, but every game I get "Metadate updated: 1, Images downloaded: 1, Video downloaded: 0". These are major games which are definitely on Steam, but I've also tried from YouTube, usually the same result but occasionally asks me to specify a url for desired video - but still fails. I see no added media following use.

EDIT I don't know why it's telling me videos and images haven't been downloaded, because they have, but my folder structure is not the default lb structure so they're in the wrong place. Future plugin option to specify paths?

So yea that summary screen at the end is not accurate and its on my to do list. Im getting some mixed messages from you here though. You're saying that it fails and you see no added media following use but then in your edit you say that the images and videos have been downloaded. Maybe you mean its saying nothing downloaded in the summary screen but they files are present and you're not seeing them because your folder structure is different? 

You're not the first person to ask for a way to define the download location. Its something I'll look into when I'm done with my current project. So just to confirm, the media and metadata are downloading but the media isn't in the location you want it to be in so launchbox isn't detecting it? How do you have your folders set up? 

mrpetenorth

Posted

36 minutes ago, spiritedusual said:

So yea that summary screen at the end is not accurate and its on my to do list. Im getting some mixed messages from you here though. You're saying that it fails and you see no added media following use but then in your edit you say that the images and videos have been downloaded. Maybe you mean its saying nothing downloaded in the summary screen but they files are present and you're not seeing them because your folder structure is different? 

You're not the first person to ask for a way to define the download location. Its something I'll look into when I'm done with my current project. So just to confirm, the media and metadata are downloading but the media isn't in the location you want it to be in so launchbox isn't detecting it? How do you have your folders set up? 

Apologies, the edit maybe made it less clear. You're right, despite the summary screen, the Steam videos and images (as well as SGDB) ARE being downloaded but in the lb default folders which i don't use. I'm carrying on with it and I'll just move what I need manually. YouTube downloading never works for me though sadly.


Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Unfortunately, your content contains terms that we do not allow. Please edit your content to remove the highlighted words below.
Add a comment...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...