How do I install SwiftPrep and launch it for the first time?
How do I install SwiftPrep and launch it for the first time?
Getting started with SwiftPrep takes just a few minutes. Follow these steps to download, install, and launch the app on your computer.
Download SwiftPrep
Visit swiftprep.app and click Download. Select your platform:
| Platform | File Type |
|---|---|
| Windows 10/11 (64-bit) | .exe installer |
| macOS (Intel or Apple Silicon) | .dmg disk image |
| Linux | .AppImage or .deb |
Save the installer to your computer.
Install on Windows
- Double-click the downloaded
.exefile - If Windows SmartScreen appears, click More info, then Run anyway (this is normal for new applications)
- Follow the installation wizard
- Click Finish to launch
Install on macOS
- Double-click the downloaded
.dmgfile - Drag the SwiftPrep icon to the Applications folder
- Open SwiftPrep from Applications
- If macOS blocks the app, go to System Settings > Privacy & Security and click Open Anyway
Install on Linux
AppImage:
chmod +x SwiftPrep-*.AppImage ./SwiftPrep-*.AppImage
Debian/Ubuntu (.deb):
sudo dpkg -i SwiftPrep-*.deb
First Launch Setup
When SwiftPrep opens for the first time:
- The app initializes its local database (takes a few seconds)
- You are prompted to sign in or create an account
- Your subscription activates automatically if you have one
- You see the home screen with a Create Campaign button
[!INFO] Your campaigns never leave your machine. SwiftPrep stores all data locally and does not upload your world to the cloud. Back up the data folder to protect your work.
Data Storage Locations
| Platform | Location |
|---|---|
| Windows | %LOCALAPPDATA%\dm-swiftprep |
| macOS | ~/Library/Application Support/dm-swiftprep |
| Linux | ~/.local/share/dm-swiftprep |
Activate a Paid Subscription
If you purchased Companion or Power tier:
- Click Sign In on the home screen
- Enter your account credentials
- Your subscription is verified and activated
- Your tier appears in the app sidebar
[!TIP] The Free tier gives you full entity management, relationships, session planning, and 15 AI generations per month. You can upgrade anytime.
Troubleshooting Common Issues
Windows SmartScreen blocks the installer Click More info, then Run anyway. This appears because SwiftPrep is a new application.
macOS says the app is from an unidentified developer Open System Settings > Privacy & Security and click Open Anyway.
App does not start Check that you meet the system requirements: Windows 10+, macOS 10.15+, or a modern Linux distribution with WebKit2GTK.
Related Articles
Was this article helpful?