Skip to content

KuroKim/steam-image-modal-fix-overlay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Steam Image Modal Fix Overlay

Fixes broken Steam Community image modals in the Steam client and in the in-game overlay.

When clicking screenshots in Steam guides or community pages, Steam may open a popup that fails with:

Invalid URL

This plugin intercepts those broken modal links and opens the direct image instead.

What it does

  • fixes broken image popup behavior on steamcommunity.com
  • works in the Steam client browser
  • works in the in-game overlay
  • avoids the broken displayimageformodaldialog flow
  • uses a lightweight Millennium plugin + injected JS module

Tested on

  • Steam client for Windows
  • Steam in-game overlay
  • Millennium
  • Steam Community guides with screenshot popups

Repository structure

plugin.json
backend/main.lua
steamui/steamcommunity_image_modal_fix.js
scripts/install.ps1
scripts/uninstall.ps1
scripts/dev-link.ps1
LICENSE

Installation

Option 1: dev mode via symlink

Recommended for development and local maintenance.

Run PowerShell as Administrator, then from the repository root:

.\scripts\dev-link.ps1

This will:

  • create a symbolic link from this repo to C:\Program Files (x86)\Steam\plugins\steam-image-modal-fix-overlay
  • create a symbolic link for the JS file in C:\Program Files (x86)\Steam\steamui\

After that, restart Steam or disable/enable the plugin in Millennium settings.

Option 2: regular install via copy

From the repository root:

.\scripts\install.ps1

This copies the plugin files into the Steam directory.

Uninstall

.\scripts\uninstall.ps1

How it works

The Lua backend registers a browser JS module through Millennium.

The injected JS watches for clicks on image preview links on Steam Community pages, extracts the direct image URL, blocks the broken Steam modal flow, and opens the image normally.

Notes

  • this is an unofficial plugin
  • not affiliated with Valve
  • not affiliated with Millennium / Steambrew
  • designed for local client-side behavior only

License

MIT

About

Fixes broken Steam Community image modals in Steam client and overlay.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors