Skip to content

A small go app for cleaning up files associated with workshop subscriptions for black ops 3. Steam doesn't always (or ever?) remove these files when unsubscribing.

Notifications You must be signed in to change notification settings

MaxInertia/CleanupSteamWorkshopFiles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

BO3 Workshop Content Manager

A command-line tool to manage and clean up Black Ops 3 Workshop content from your Steam installation.

This README was generated by claude-3.5-sonnet.

Prerequisites

Installing Go

  1. Visit the official Go downloads page
  2. Download the installer for your operating system:
    • Windows: Download the .msi installer
    • macOS: Download the .pkg installer
    • Linux: Follow distribution-specific instructions
  3. Run the installer and follow the prompts
  4. Verify the installation by opening a terminal/command prompt and running:
    go version

Building the Tool

  1. Clone this repository or download the source files
  2. Open a terminal/command prompt in the project directory
  3. Build the executable:
    go build
    This will create an executable file:
    • Windows: workshop-manager.exe
    • macOS/Linux: workshop-manager

Usage

Run the tool by providing your Steam installation path as an argument:

# Windows
workshop-manager.exe "C:\Program Files (x86)\Steam"

# macOS
workshop-manager "/Users/username/Library/Application Support/Steam"

# Linux
workshop-manager "~/.local/share/Steam"

The tool will:

  1. List all your BO3 Workshop subscriptions with their sizes
  2. Allow you to select items to delete by entering their numbers (space-separated)
  3. Show the total space that will be reclaimed
  4. Ask for confirmation before deletion

Example Output

Steam Path:
        C:\Program Files (x86)\Steam
BO3 Workshop Subscriptions Path:
        C:\Program Files (x86)\Steam\steamapps\workshop\content\311210

Subscriptions:
        0: Custom Map 1 (map) [1.2 GB]
        1: Custom Map 2 (map) [800 MB]
Space used: 2.0 GB

Delete which? 1
Selected Subscriptions:
        1: Custom Map 2 (C:\Program Files (x86)\Steam\steamapps\workshop\content\311210\123456789)

This will reclaim 800 MB

Delete (y/n)?

Safety Features

  • The tool only operates within the BO3 Workshop content directory
  • Confirmation is required before deletion
  • Path validation ensures deletions only occur in the correct directory
  • Symbolic links are detected and skipped to avoid escaping the workshop directory

About

A small go app for cleaning up files associated with workshop subscriptions for black ops 3. Steam doesn't always (or ever?) remove these files when unsubscribing.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages