spiritedusual Posted 7 hours ago Posted 7 hours ago PC Game Scrapper View File PC Game Scraper A comprehensive LaunchBox plugin designed to scrape metadata, images, and videos from Steam, SteamGridDB, and YouTube. 📖 Overview PC Game Scraper is a plugin that automates the process of filling in metadata and downloading images and videos. It is designed to work for games that have not been imported from a specific digital storefront. ✨ Features Metadata Scraping Fetches Developer, Publisher, Release Date, Genres, Rating, Controller Support, and Descriptions directly from the Steam Store. Media Downloading Images: Downloads Box Art, Clear Logos, Fanart, and Screenshots from Steam or SteamGridDB. Videos: Downloads Trailers or Gameplay videos using yt-dlp via Steam or YouTube. Supports FFmpeg and WMC codecs (up to 4K resolution). Multiple Scan Modes Automated: Auto-matches Steam AppIDs based on game title. If the game is not on Steam, it falls back to SteamGridDB (SGDB). SteamGridDB: Skips Steam entirely and searches SteamGridDB directly (requires API Key). Manual: Allows user input of specific AppIDs or Store URLs. Smart Matching Uses a similarity algorithm combined with exact match logic to detect the correct game, even if the title in your library is not an exact match to the store title. 🛠️ Prerequisites To use this plugin, you must download the following external tools and place them in the plugin folder: yt-dlp.exe (Required for video downloading) ffmpeg.exe (Required for video processing) 🚀 Installation Extract the plugin archive to your LaunchBox Plugins folder. Download the latest release of yt-dlp.exe and place it in the plugin folder. Download the latest version of FFmpeg (Essentials build). Locate ffmpeg.exe inside the bin folder of the download and extract it to the plugin folder. Verify that the plugin folder contains the .dll file, yt-dlp.exe, and ffmpeg.exe. 💻 Usage Open LaunchBox. Select one or multiple games. Right-click and select PC Game Scraper. Configure your settings in the popup menu. ⚙️ Configuration Options Scan Mode Choose between Automated, SteamGridDB, or Manual search. Automated Mode: Depending on your settings, this will automatically scan Steam or SGDB by title. If a Steam match is found, the plugin fills missing metadata and downloads Box Art, Fanart, Screenshots, and Video (if enabled). If images are missing or do not match standard Steam resolutions, the plugin falls back to SGDB using the SteamID. If the title is not on Steam, you will be prompted to fall back to SGDB for images. Matching Logic: A game title must match 100% or be at least 93% similar to match without user input. Example: If you search for "Doom 2," the plugin will attempt to match it to "Doom 2" because it is an exact match. However, there is no straight "Doom 2" on Steam. Therefore, the plugin will prompt the user for input to try and find a correct match. It will first offer a list of possible matches. If none of those match, the plugin offers the option to manually match via Store URL, SteamID, or by manually typing a title. Because "Doom 2" is not on Steam, the user can choose to skip Steam, and the plugin will search SGDB as the fallback, at which point it should auto-match since there is an exact match to "Doom 2". Image Source Prioritize "Steam (Official)" or "SteamGridDB (Community)." SGDB uses a voting system where the community ranks images. The plugin grabs the highest-ranking SGDB images that fit within the resolution threshold. Box Art: Restricted to aspect ratios between 0.6 and 0.75. When a game is not on Steam, it is possible the highest-rated box art will be 660x930 (aspect ratio 0.71). The logic ensures you get the best-rated image within a reasonable range. (Standard Steam aspect ratio for 600x900 is 0.66). Fanart: Downloads up to 4K resolution as long as it matches the correct aspect ratio. Overwriting and Mark Installed Default Behavior: The plugin only fills empty metadata fields. If you have already populated fields using the LaunchBox Database, the plugin will skip them. Overwrite: Select the corresponding overwrite options to replace existing data with Steam, SGDB, or YouTube data. Mark Installed: Marks the selected games as "Installed" in LaunchBox. Video Options Enable video downloads, select the source (Steam/YouTube), and set the resolution (480p - 4K). Engine Selection: FFmpeg: Select this if LaunchBox does not crash and videos play using FFmpeg as the video playback engine. It supports modern codecs providing high video quality with significantly smaller file sizes. WMC: Use this for legacy compatibility if FFmpeg causes playback issues. It is the most compatible option. ⚠️ YouTube Download Warning: yt-dlp cannot download age-restricted trailers without authentication, and YouTube may block automated requests. If you see errors in the log asking for sign-in or bot verification: Extract your cookies file from your browser. Place the file in the plugin folder (named cookies.txt). The plugin will automatically use this file to pass verification. Note: Use this feature responsibly. There is a built-in sleep timer between scans to help prevent IP bans, but excessive downloading may still flag your account. SGDB API Key Required to download community art from SteamGridDB. You can generate an API key in your profile section on the SteamGridDB website. 📂 File Locations Logs: Documents/LaunchBox_SteamDownloader/SteamDownloader.log Config: Documents/LaunchBox_SteamDownloader/config.json Downloaded Media: Files are saved directly into the plugin folder under Images/ and Videos/. Please reach out if you have questions! I plan on trying to implement IGDB support later and if anyone has suggestions or finds a bug please reach out. 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. PCGameScraper.rar Submitter spiritedusual Submitted 12/28/2025 Category Third-party Apps and Plugins Quote
)
Recommended Posts
Join the conversation
You can post now and register later. If you have an account, sign in now to post with your account.