Jump to content
LaunchBox Community Forums

PC Game Scrapper 1.0

   (0 reviews)
spiritedusual
 Share

1 Screenshot

About This File

🎮 PC Game Scraper for LaunchBox

PC Game Scraper is a robust metadata and media scraping plugin for LaunchBox. It intelligently prioritizes Steam for PC game metadata and IGDB for console titles, while leveraging SteamGridDB for high-quality frontend artwork and YouTube for video trailers.

It also features advanced integration with HowLongToBeat (via FlareSolverr) to populate custom fields with game completion times.

⚠️ Disclaimer

This plugin scrapes data from third-party sources (Steam, IGDB, SteamGridDB, HowLongToBeat). Please be aware that both FlareSolverr and yt-dlp are frowned upon by some services for their respective uses. Use them responsibly and at your own discretion.

✨ Key Features

🧠 Smart Metadata Scanning

  • PC Mode: Prioritizes Steam Store data, falling back to IGDB if the game isn't found on Steam.

  • Console Mode: Scrapes directly from IGDB, perfect for emulated platforms.

  • Gap Filling: Automatically checks IGDB to fill missing fields that Steam doesn't provide (e.g., Series, Age Rating, ESRB).

🎨 High-Quality Artwork

  • Seamless Integration: Pulls Box Art, Clear Logos, and Hero Backgrounds directly from SteamGridDB.

  • Image Preference Options: You choose priority—prefer high-quality SGDB art over official Steam/IGDB images whenever possible.

🎬 Video Downloader

  • Automated Downloading: Grabs trailers and gameplay automatically using yt-dlp.

  • Smart Fallback: Tries official Steam store videos first, then searches YouTube if none are found.

  • Configurable Quality: Support for 4K, 1080p, or 720p, with custom duration limits.

⏱️ HowLongToBeat Integration

  • Scrapes "Main Story", "Main + Extra", and "Completionist" times and creates dedicated Custom Fields for each.

  • Smart Categorization: Creates a Length Category custom field to sort your library into five distinct buckets:

    • Quick: < 5 Hours

    • Standard: 5 - 15 Hours

    • Extended: 15 - 30 Hours

    • Long: 30 - 60 Hours

    • Massive: 60+ Hours

  • Note: Requires a running instance of FlareSolverr to bypass Cloudflare protection.

🔍 Manual Search

  • Includes a "Manual" mode to hand-pick games by ID or search term if automation fails.

📥 Installation

  1. Navigate to your LaunchBox installation folder.

  2. Open the Plugins folder.

  3. Create a new folder named PCGameScraper.

  4. Copy the plugin files (e.g., PCGameScraper.dll) into this new folder.

📹 For Video Support (Optional)

To enable the video downloader features, you must place the following tools inside the PCGameScraper folder you just created:

  • yt-dlp.exe

  • ffmpeg.exe

  • (Optional) cookies.txt: If YouTube blocks your requests, place a valid Netscape-formatted cookies file here.

⚙️ Configuration & Usage

  1. Select one or more games in LaunchBox.

  2. Right-click and select PC Game Scraper.

  3. Configure your settings in the menu:

🔑 API Keys (Recommended)

  • SteamGridDB API Key: Required for high-quality box art and logos. Get one from your SGDB Profile.

  • IGDB (Twitch) Keys: Required for Console mode and metadata gap filling. Get your Client ID and Secret from the Twitch Developer Console.

📡 Scan Modes

  • PC Games: Best for Windows/Steam games. Checks Steam ➜ IGDB ➜ SGDB.

  • Console / IGDB: Best for ROMs. Checks IGDB ➜ SGDB.

  • SteamGridDB (Images Only): Skips metadata and only downloads artwork.

  • Manual Selection: Prompts you to manually search for each game in the batch.

🖼️ Image Preference

  • Default (Match Scan Mode):

    • PC Mode: Downloads Steam art first, uses SGDB for anything missing.

    • Console Mode: Downloads IGDB art first, uses SGDB for anything missing.

  • Prioritize SteamGridDB:

    • Always checks SteamGridDB first for Boxes, Backgrounds, and Logos.

    • Only uses Steam/IGDB for Screenshots (gameplay) or if SGDB has no results.

⏳ HowLongToBeat Setup

  1. Install and run FlareSolverr (via Docker or Binary).

  2. Enter your local FlareSolverr URL in the plugin settings (Default: http://localhost:8191).

  3. Check the box for "Enable HLTB Scraping".

Special thanks:

  • srxz, for developing the original steam scraper your plugin saved me lots of time and was the major inspiration for this plugin.

  • maikeru1986, for creating the vidsnap scraper which again saved me lots of time getting videos and was the major inspiration for the video download portion of the plugin (I basically ripped off your menu sorry)

  • JOEVIKING245: a god among moderators and who seems to have INFINITE PATIENCE. Seriously this person needs more credit!

  • 7nseccmem: for helping test the features on discord

Finally Google's Gemini which wrote the whole thing. It was a team effort I promise! If you don't believe me you go try and get Gemini to do something similar see how easy it is.

 

Edited by spiritedusual
Updated readme

What's New in Version 1.0   See changelog

Released

IGDB support has been added. This is the fallback when a game doesn't exist on Steam. The plugin will also add additional fields not available on Steam or not included in the API. 


Since IGDB's library encompasses more than PC games there is now a "Console" scan mode that basically is just IGDB metadata scanning. I thought about fleshing this out more but the Launchbox database either contains the same metadata and/or has better media so it seemed redundant. 

I'm  honestly a bit burned out on this project so there probably wont be many more updates unless something needs fixing. Feel free to reach out to me either direct or in the comments if you have problems or questions. 

  • Like 1
  • Thanks 3
 Share
Previous File LaunchBox Games Database - Comparer Plus
Next File LaunchBox Notes Translator (Spanish)

User Feedback

Recommended Comments

bundangdon

bundangdon 475

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

Martin Turesson 2

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

lessthanzero33 29

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

spiritedusual 10

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

spiritedusual 10

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

Martin Turesson 2

Posted (edited)

Thanks, working fine now. Awesome tool! :)

Edited by Martin Turesson
  • Like 1
spiritedusual

spiritedusual 10

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

TekkamanBlade 40

Posted

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

  • Like 1
Kits

Kits 1

Posted

Awesome tool, thank you ! 

  • Like 1
spiritedusual

spiritedusual 10

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

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...