Skip to content

Saltine-dev/LWM

Repository files navigation

LWM / Local Workshop Manager

Logo

Have you ever launched the non-Steam version of a Steam game and realised the there is suddenly no mod support? You can still get workshop mods, but only by going through SteamCMD console, installing mods one by one, and dumping them into an ever-growing folder you can’t organise or keep current. Many developers ship across multiple platforms, but only Steam users get to enjoy the streamlined mod experience. Local Workshop Manager bridges that gap, bringing Workshop-quality mod discovery, collections, and updates to every copy, without the manual work.

✨ Features

  • Home – An Overview of the game's workshop page.

    • Quick tabs for Most Popular, Most Subscribed, and Most Recent mods.
    • A carousel with up and coming mods this week.
    • Mod tags to quickly sort by type.
    • Some info and links for the chosen game.
  • Browse – Workshop-style catalog.

    • One-click installs powered by SteamCMD.
    • Filtering by type, timeframe, and tag.
    • Improved keyword searching, with link and ID support.
    • Page System
  • Mod View – Rich mod description view.

    • Thumbnail and screenshots with lighthouse view.
    • Mod controls for easy install, uninstall, and manage page redirect.
    • Mod Dependencies including other workshop items and DLC requirements.
    • Original mod description with markdown support.
    • Mod comments with page system.
    • Breadcrumbs to follow your mod trail.
    • General mod details and update log.
  • Collections – Profile-scoped modlists.

    • Bulk actions like install all, uninstall all, check all for updates.
    • Dependency check during mod install for other workshop item or DLC requirements.
    • Import and export modlists made within LWM and share with your friends.
    • Import existing modlists from Steam.
  • Subscriptions – Library of installed mods.

    • Toast notifications for job success, faliure, start/end, updates, etc.
    • Download/update queue with status updates.
    • Info and quick links for every installed item.
  • Planned Features -

    • Packaged Mac/Linux App
    • Improved collections page and mod management.
    • Load Order Management for select games.

Screenshots (Rimworld Example)

image image image image image image

📦 Installation

Option 1: Use the Installer (recommended)

  1. Download the latest LocalWorkshopManager-Setup-x.y.z.exe from the Releases page.
  2. Verify the installer checksum (see SHA256/SHA512 values published with the release).
  3. Run the installer. The app will appear in the Start menu after installation.

Option 2: Run from Source

  1. Install prerequisites:
    • Node.js 18 or newer (includes npm 9+).
    • Git (optional, but recommended).
  2. Clone and install:
    git clone https://github.com/YourOrg/LocalWorkshopManager.git
    cd LocalWorkshopManager
    npm install
  3. Launch in development mode:
    npm run dev
    This starts Vite (renderer) and Electron (main process) with hot reload.
  4. Build production bundles:
    npm run build        
    npm run start        
    npm run package      

🚀 App Setup (Required)

1. Install SteamCMD.

  1. Download SteamCMD for your platform: https://developer.valvesoftware.com/wiki/SteamCMD
  2. Extract it to a permanent folder, or the same folder as the app.
  3. Run SteamCMD at least once so it can update and generate required support files.
  4. Configure the path inside Local Workshop Manager (Settings → SteamCMD Path) or by editing data/config.json:
    {
      "steamCmdPath": "C:\\Tools\\SteamCMD\\steamcmd.exe"
    }

2. Generate a Steam Web API Key.

  1. Visit https://steamcommunity.com/dev/apikey.
  2. Sign in with a Steam account.
  3. Enter a domain (any word or string is fine, you do not need a domain.) and press “Register”.
  4. Copy the generated key and add it to Local Workshop Manager:
    • via Settings → Steam API Key, or
    • by editing data/config.json:
      {
        "steamApiKey": "YOUR_STEAM_API_KEY"
      }

3. Configure a game profile.

  1. Click the profile button in the top right of the header.
  2. Input the game's info, including the name, steam app ID, and mod install location.
  3. Click save changes and start browsing.

🤝 Contributing

Contributions are welcome! Feel free to open issues with feature requests or bug reports, and submit pull requests for improvements.


📄 License

MIT © Local Workshop Manager. See LICENSE for details.

About

Local Workshop Manager is an Electron application that recreates the Steam Workshop experience for non-Steam games. It combines a React front end with a Node-powered backend to manage workshop downloads, organize profile-based collections, and keep your mod library in sync.

Topics

Resources

License

Stars

2 stars

Watchers

2 watching

Forks

Packages

 
 
 

Contributors