Steam Icon Fixer for Openclaw

A specialized utility to restore and automate the installation of missing Steam game icons on Linux desktop environments.

lunarmoon26
v1.0.0
Apr 2, 2026
0
627
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install steam-icon-fixer

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install steam-icon-fixer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Steam Icon Fixer?

Steam Icon Fixer is a technical utility designed to resolve the common issue of blank or generic desktop icons for Steam games on Linux. By utilizing this contribution to Openclaw Skills, developers and users can automate the discovery of Steam App IDs from local launcher metadata and streamline the placement of replacement artwork into the user's icon theme. It ensures that your desktop environment remains visually consistent by following standard Linux icon path conventions and Steam naming schemes.

This tool is particularly useful for users who find that Steam-created desktop launchers fail to display the correct game branding. By leveraging the Openclaw Skills framework, the process of scanning, identifying, and fixing these assets is reduced from a manual chore to a single command execution.

Steam Icon Fixer Use Cases

  • Repairing blank or generic broken icons in Steam-created desktop launchers on Linux systems.
  • Automatically discovering the correct Steam App ID for a specific game via local .desktop files.
  • Installing custom high-resolution game artwork to replace low-quality defaults using standard naming conventions.
  • Bulk scanning local application directories to identify and fix missing assets across an entire library.

How Steam Icon Fixer Works

  1. The skill analyzes user inputs such as game name, image path, or specific App ID to determine the target application.
  2. It scans standard directories like ${XDG_DATA_HOME:-~/.local/share}/applications to locate relevant launcher files.
  3. Metadata is extracted from the .desktop launcher to identify the internal steam_icon_ reference or the steam://rungameid/ URI.
  4. The bundled Python script processes the replacement image and moves it to the appropriate Hicolor icon theme directory.
  5. The system icon cache is refreshed to apply changes across the desktop environment immediately.

Steam Icon Fixer Setup

To start using this utility from Openclaw Skills, ensure you have Python 3 installed. You can scan for missing icons or install specific ones using the following commands:

# Scan for launchers with missing icons
python3 scripts/steam_icon_fixer.py scan

# Install a specific icon by App ID
python3 scripts/steam_icon_fixer.py install --image /path/to/image.png --app-id 1086940

# Install an image by matching a game name
python3 scripts/steam_icon_fixer.py install --image /path/to/image.png --game "Baldur's Gate 3"

Note: If you are processing .ico files, ensure the Pillow library is installed in your Python environment.

Steam Icon Fixer Data Schema & Taxonomy

The skill interacts with and organizes data based on standard Linux filesystem hierarchies and Steam's specific naming conventions:

Component Path / Format Description
Launcher Path ~/.local/share/applications/*.desktop Source for App ID discovery and metadata.
Icon Path ~/.local/share/icons/hicolor/ Destination for processed and resized icons.
Icon Name steam_icon_<appid>.png Required naming scheme for Steam launchers to recognize assets.
Script scripts/steam_icon_fixer.py The core execution logic for scanning and installation.

Steam Icon Fixer Advanced Features

  • Automated discovery of App IDs via game name matching to simplify workflows when the ID is unknown.
  • Support for custom desktop and icon directory overrides for non-standard Linux distributions or custom installs.
  • Multi-agent compatibility through the Openclaw Skills framework for automated asset gathering and deployment.
  • Deterministic installer script that generates standard icon sizes and maintains system integrity.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*