@dump.py - Wallpaper Engine Workshop Extractor

This script helps you extract wallpapers from your Wallpaper Engine Steam Workshop directory, making it easy to use them elsewhere or on other platforms.

Why

Wallpaper Engine stores its wallpapers in a proprietary .pkg format, which is not straightforward to access or extract manually. This script automates the extraction process, allowing you to retrieve wallpapers and other assets for personal use without hassle.

Warning

Not all wallpapers can be fully extracted! Some wallpapers—especially those with many layers, effects, or interactive/animated elements—may not yield a usable static image or may not extract the main wallpaper as expected. This script works best for static or simple wallpapers, but results may vary.

Note

Many of the wallpapers you see recommended on TikTok, YouTube, and Instagram actually come from Wallpaper Engine, which offers a huge collection of high-quality wallpapers. By using this script, you can access these wallpapers directly from your own Steam library, avoiding the need to search on random or potentially unsafe websites.

Requirements

• Wallpaper Engine installed via Steam
• Python 3
• Pillow (install with pip install pillow)
• binwalk

Usage

1. Locate your Wallpaper Engine Workshop content folder, typically at:

   C://SteamLibrary/steamapps/workshop/content/431960/
   

2. Download dump.py.
3. Run the script with:

   python dump.py /path/to/your/SteamLibrary/steamapps/workshop/content/431960/
   

   By default, the script will recursively scan for .pkg files, extract their contents, and collect large PNG images into an output_pngs folder for easy access.

Script Parameters

You can customize the script's behavior with the following parameters:

• root_directory (required):
  The root directory to scan for .pkg files (usually your Wallpaper Engine Workshop folder).

• output_png_dir (optional):
  Directory to copy large images to. Defaults to <root_directory>/output_pngs.

• --min-width (optional):
  Minimum width of images to copy (default: 1920).

• --min-height (optional):
  Minimum height of images to copy (default: 1080).

• --max-width (optional):
  Maximum width of images to copy (if not set, no upper limit).

• --max-height (optional):
  Maximum height of images to copy (if not set, no upper limit).

• --extension (optional):
  Image extension to search for (default: .png).

Example:

python dump.py /path/to/your/SteamLibrary/steamapps/workshop/content/431960/ --min-width 2560 --min-height 1440 --extension .jpg

See the script for additional options and details.