A Windows desktop application for managing Steam Workshop items, detecting inconsistencies, and performing maintenance operations on cached workshop content.
WorkshopItems is a graphical tool that provides an interface for managing Steam Workshop content. It helps identify and resolve common workshop issues such as:
- Outdated workshop items (often causing client purity issues due to mismatched
.pk3s in Quake Live). - Orphaned workshop entries in Steam's manifest files.
- Missing workshop data files.
- Corrupted workshop content.
Currently configured for Quake Live (App ID: 282440) but can be easily adapted for other Steam games via simple modification to GAME_APPID.
- Workshop Item Listing: View all installed workshop items with details including ID, title, size, file path, and update status.
- Inconsistency Detection: Automatically detect mismatches between Steam's manifest and actual files on disk.
- Bulk Operations: Select multiple items for deletion or updates.
- Update Management: Check for and download available workshop updates.
- File Validation: Validate game files and workshop content integrity.
- Workshop Reset: Completely reset workshop data for a fresh start.
- Explorer Integration: Open workshop item folders directly in Windows Explorer.
- SteamCMD Integration/Management: Automatically downloads and uses SteamCMD for workshop operations.
- Multi-Library Support: Works with games installed across multiple Steam library folders in non-default locations.
- Windows 10/11.
- .NET 8.0 Desktop Runtime.
- Steam installed.
- Go to the Releases page.
- Download the latest
WorkshopItems.zip. - Extract to your preferred location.
- Run
WorkshopItems.exe.
See more about this option below.
- The application will automatically detect your Steam installation.
- It will check if the configured game is installed.
- If Steam or SteamCMD is running, you'll be prompted to close them.
- Populate/Refresh: Load or refresh the workshop items list.
- Delete Workshop Data: Remove selected items and update Steam's manifest.
- Open in Explorer: Browse to selected item folders.
- Repair Inconsistencies: Fix orphaned manifest entries.
- Update Workshop Items: Download available updates.
- Validate Files: Check game and workshop file integrity.
- Reset Workshop: Complete workshop data reset.
- Click Repair Inconsistencies.
- Confirm removal of orphaned entries.
- Refresh the list.
- Items with updates show in blue with "Update Available".
- Click Update Workshop Items or right-click for selected updates.
- Monitor progress in the console window.
- Select items to delete.
- Click Delete Workshop Data.
- Confirm the operation.
To use with a different Steam game:
-
Find your game's App ID:
- Visit the game's Steam store page.
- The ID is in the URL:
store.steampowered.com/app/[APP_ID]
-
Edit
MainForm.cs:private const int GAME_APPID = 282440; // Change this to your game's ID
-
Rebuild the application using the instructions below.
- Visual Studio 2022 or later with .NET desktop development workload.
- Or the .NET 8.0 SDK.
# Clone the repository
git clone https://github.com/tjone270/WorkshopItems.git
cd WorkshopItems
# Restore dependencies
dotnet restore
# Build
dotnet build -c Release
# Run
dotnet run --project WorkshopItems
Contributions are welcome, feel free to submit a pull request.
- Follow C# default coding conventions.
- Add XML documentation for classes/methods.
- Test with multiple Steam library configurations.
- Ensure backwards compatibility with Windows 10.
This project is licensed under the MIT License - see the LICENSE file for details.
- Gameloop.Vdf for VDF parsing.
- Valve for Steam and SteamCMD.
- id Software for making Quake Live available via Steam and not just letting it die off.
- The Quake Live community who motivated me to build this tool in the first place.
This software is not affiliated with Valve Corporation, id Software or other publishers.
Use at your own risk.