# SOAP2 Multi-Monitor Quick Reference
## Keyboard Shortcuts
| Shortcut | Action | Context |
|----------|--------|---------|
| `Ctrl+Shift+M` | Toggle multi-monitor spanning | Main window |
| `Ctrl+Shift+F` | Toggle floating mode for OA | Options Analysis window |
## Main Window Multi-Monitor Features
### Span Across All Monitors
**Menu**: SOAP dropdown → "Span Multiple Monitors"
**Shortcut**: `Ctrl+Shift+M`
**Effect**: Main SOAP2 window extends across all connected monitors
### Restore to Single Monitor
**Menu**: SOAP dropdown → "Restore to Single Monitor"
**Shortcut**: `Ctrl+Shift+M` (toggle)
**Effect**: Main window returns to primary monitor
## Options Analysis (OA) Multi-Monitor Features
### Float OA on Separate Monitor
**Method 1**: Right-click on OA → Check "Float on Separate Monitor"
**Method 2**: Press `Ctrl+Shift+F` in OA window
**Effect**: OA becomes independent window, can be moved to any monitor
### Move Floating OA to Specific Monitor
**Menu**: Right-click on floating OA → "Move to Monitor" → Select monitor
**Effect**: OA centers on selected monitor
### Return OA to Main Window
**Menu**: Right-click on floating OA → Uncheck "Float on Separate Monitor"
**Alternative**: Press `Ctrl+Shift+F` again
**Effect**: OA returns to MDI container in main window
## Common Workflows
### Workflow 1: Dedicated Analysis Monitor
1. Open OA for symbol (e.g., SPX)
2. Right-click OA → "Move to Monitor" → Select secondary monitor
3. Maximize OA on that monitor
4. Keep main SOAP2 on primary monitor
5. **Result**: Full-screen analysis on dedicated display
### Workflow 2: Side-by-Side OAs
1. Press `Ctrl+Shift+M` to span main window across monitors
2. Open multiple OAs (e.g., SPX, RUT, NDX)
3. Arrange OAs across the extended desktop
4. **Result**: Compare multiple symbols simultaneously
### Workflow 3: Mixed Approach
1. Span main window across monitors 1-2
2. Float one OA to monitor 3 for focused analysis
3. Keep 2-3 OAs in spanned area for quick comparison
4. **Result**: Flexible layout for complex workflows
## Tips
- **Window positions are remembered**: SOAP2 saves window positions per-monitor
- **Monitor changes handled**: If you disconnect a monitor, windows automatically move to available screens
- **Right-click context menu**: Always available on OA windows for quick access to floating controls
- **Status bar info**: Monitor count shown in message log on startup
## Troubleshooting
**Problem**: Can't find multi-monitor menu
**Solution**: SOAP dropdown menu (top toolbar) → Look for "Span Multiple Monitors"
**Problem**: OA won't float
**Solution**: Try `Ctrl+Shift+F` keyboard shortcut or restart SOAP2
**Problem**: Window is off-screen
**Solution**: Delete `{SOAPpath}/WindowSettings.json` and restart
**Problem**: Only see one monitor option
**Solution**: Check Windows Display Settings → Ensure monitors are "Extended" not "Duplicate"
## Files and Settings
**Configuration Files** (in SOAPpath):
- `WindowSettings.json` - Main window position
- `MultiMonitorSettings.json` - Spanning preference
- `OA_{Symbol}_WindowSettings.json` - Per-OA floating settings
**Safe to Delete**: If you want to reset window positions, close SOAP2 and delete these JSON files
## Monitor Detection
SOAP2 automatically detects all connected monitors on startup. Check the message log to see:
```
[timestamp] X monitors detected
```
For implementation details, see `docs/Dev/multi_monitor_setup.md`
---
Go back to the main help page: [SOAP2 Help Guide](./index.md.html)