How do I install SwiftPrep?

SwiftPrep runs on Windows, macOS, and Linux. This guide walks you through downloading, installing, and launching the app on your platform.

System Requirements

Download

Get SwiftPrep from the official website:

swiftprep.app/download

Choose your platform:

• Windows - .exe installer
• macOS - .dmg disk image
• Linux - .AppImage or .deb package

Windows Installation

Step 1: Run the Installer

1. Download SwiftPrep-Setup.exe
2. Double-click to run
3. If Windows SmartScreen appears, click More info then Run anyway
4. Follow the installation wizard

Step 2: Launch

• Find SwiftPrep in your Start menu
• Or use the desktop shortcut (if you created one)

Data Location

Your campaigns are stored in:

This is typically C:\Users\[YourName]\AppData\Roaming\SwiftPrep\

macOS Installation

Step 1: Mount the Disk Image

1. Download SwiftPrep.dmg
2. Double-click to open
3. Drag SwiftPrep to your Applications folder

Step 2: First Launch

1. Open Applications and double-click SwiftPrep
2. If you see "SwiftPrep cannot be opened because it is from an unidentified developer":
   • Go to System Preferences then Security & Privacy then General
   • Click Open Anyway
   • Or: Right-click the app, then Open, then Open

Data Location

Your campaigns are stored in:

To access this folder: Finder then Go then Go to Folder and paste the path above.

Linux Installation

Option A: AppImage (Recommended)

1. Download SwiftPrep.AppImage
2. Make it executable:
   Copy

   chmod +x SwiftPrep.AppImage

3. Run it:
   Copy

   ./SwiftPrep.AppImage

Option B: Debian Package

1. Download SwiftPrep.deb
2. Install:
   Copy

   sudo dpkg -i SwiftPrep.deb
   sudo apt-get install -f  # If there are dependency issues

3. Launch from your application menu or run swiftprep

Data Location

Your campaigns are stored in:

First Launch

When you first open SwiftPrep:

1. Account Setup

Choose one:

• Create Account - New to SwiftPrep
• Sign In - Already have an account
• Continue Offline - Use Free tier without account (limited)

2. Choose Your Tier

• Free - Start immediately with 15 AI generations/month
• Companion - $7.99/month, 150 generations, full AI features
• Power - $14.99/month, 400 generations, advanced AI

You can upgrade anytime. Start with Free to explore.

3. Create or Import a Campaign

• Create New - Start fresh
• Import - Bring in content from Fantasy Grounds or other sources

Updating SwiftPrep

SwiftPrep checks for updates automatically:

1. When an update is available, you'll see a notification
2. Click to download and install
3. Restart the app to apply

Or check manually: Settings then About then Check for Updates

Data Ownership

Your data stays on your computer:

• Campaigns are stored locally in the paths above
• Nothing is uploaded to our servers (except AI prompts when you use AI features)
• You can back up by copying the data folder
• Export to JSON, Markdown, or CSV anytime

You own your data. SwiftPrep is a tool, not a platform that holds your content hostage.

Quick Troubleshooting

Windows: SmartScreen Warning

This appears because SwiftPrep is new and hasn't accumulated enough installations for Windows to recognize it. It's safe to proceed:

1. Click More info
2. Click Run anyway

macOS: "Cannot be opened" Error

macOS Gatekeeper blocks apps from unidentified developers:

Option 1: Right-click then Open then Open

Option 2: System Preferences then Security & Privacy then General then Open Anyway

Linux: Missing Dependencies

If the AppImage won't run, you may need:

sudo apt-get install libfuse2

For other dependency issues with the .deb package:

sudo apt-get install -f

App Won't Start

1. Try restarting your computer
2. Reinstall the app
3. Check if antivirus is blocking it
4. See How do I fix common installation problems? for more options

Related Articles

• How do I install SwiftPrep on Windows?
• How do I install SwiftPrep on macOS?
• How do I install SwiftPrep on Linux?
• How do I activate my SwiftPrep license?
• How do I fix common installation problems?