SP Toolkit

Internal tools for the SolidProfessor content team

Legacy Folder Copy

This tool copies course folders in our legacy S3 bucket (lessons.solidprofessor.com). When you run it on a folder like 25CSWAPE02_01, it creates a new copy called 26CSWAPE02_01 — bumping the year by one — and automatically finds every SolidProfessor tutorial URL inside the HTML, CSS, JS, XML, and PDF files, replacing the old lesson IDs with new ones from a CSV spreadsheet you provide. Images, videos, and other binary files are copied as-is.

Nothing changes until you say so. The tool runs in preview mode by default, showing you exactly what it will do. You only add --execute when you're ready to make real changes.

First-time setup

Download the tool, install the AWS CLI, and configure your credentials.

Get started

I'm already set up

Jump straight to the usage guide — copy commands, batch mode, and flags.

Go to guide

Download

Click the button for your computer. The file will download immediately — no login required.

💻

Windows

64-bit — most SP laptops

Download .exe

Mac (Apple Silicon)

M1, M2, M3, M4 chips

Download

Mac (Intel)

Pre-2021 Macs

Download

v1.0.0

One-Time Setup

You only need to do these steps once on your computer.

Step 1 — Install the AWS CLI

Windows

  1. Download the installer: AWSCLIV2.msi
  2. Double-click the downloaded file and follow the prompts to install.
  3. Close and reopen any Command Prompt or PowerShell windows you had open so they pick up the new installation.
Mac instructions

Open Terminal (search for "Terminal" in Spotlight) and paste:

brew install awscli

If you see "command not found: brew", install Homebrew first:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Then run brew install awscli again.

Step 2 — Configure your AWS credentials

Use the key provided to you, or reach out to the core platform team for keys.

Open Command Prompt (Windows) or Terminal (Mac) and run:

aws configure

It will ask four questions. Type each answer and press Enter:

AWS Access Key ID [None]: YOUR_ACCESS_KEY_HERE
AWS Secret Access Key [None]: YOUR_SECRET_KEY_HERE
Default region name [None]: us-west-1
Default output format [None]: json

Replace YOUR_ACCESS_KEY_HERE and YOUR_SECRET_KEY_HERE with your real keys.

Verify it worked

aws s3 ls s3://lessons.solidprofessor.com/

You should see a short list of folder names. If you get an error, double-check your keys.

Step 3 — Install the tool

Windows

  1. Click the Download .exe button above. The file saves to your Downloads folder automatically.
  2. Open Command Prompt (press the Windows key, type cmd, press Enter).
  3. Navigate to your Downloads folder and test the tool: 
    cd %USERPROFILE%\Downloads
.\legacy-folder-copy-windows-amd64.exe version
Windows SmartScreen warning: You may see "Windows protected your PC". Click More info, then Run anyway. This is normal for unsigned tools.

Tip: To save typing, you can rename the file to lfc.exe. Then your commands become: .\lfc.exe version

Mac instructions
  1. Click the correct Download button above for your Mac.
  2. Open Terminal and run: 
    # Apple Silicon (M1/M2/M3/M4):
sudo cp ~/Downloads/legacy-folder-copy-darwin-arm64 /usr/local/bin/legacy-folder-copy

# Intel Mac:
sudo cp ~/Downloads/legacy-folder-copy-darwin-amd64 /usr/local/bin/legacy-folder-copy
  3. Make it executable: 
    sudo chmod +x /usr/local/bin/legacy-folder-copy
  4. Remove the macOS quarantine flag: 
    xattr -d com.apple.quarantine /usr/local/bin/legacy-folder-copy
  5. Test it: 
    legacy-folder-copy version
macOS Gatekeeper: If you see "cannot be opened because the developer cannot be verified", run the xattr command in step 4 above.

All set up? Head to the usage guide to start copying folders.