Accessing Settings
- Click your user avatar in the left sidebar
- Click Settings
- Navigate using the tabs on the left
Interface Layout
┌────────────────────────────────────────────────────────────────────────────┐
│ Settings [✕] │
├────────────────────────────────────────────────────────────────────────────┤
│ ┌─────────────────┐ ┌────────────────────────────────────────────────────┐ │
│ │ Settings Tabs │ │ Settings Content │ │
│ │ │ │ │ │
│ │ ▶ General │ │ (Content varies by selected tab) │ │
│ │ API │ │ │ │
│ │ Mobile Test │ │ │ │
│ │ Change Anal. │ │ │ │
│ │ MCP │ │ │ │
│ │ Paths │ │ │ │
│ │ Security │ │ │ │
│ │ About │ │ │ │
│ └─────────────────┘ └────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────────┘
General Settings
Basic application preferences.Language
┌────────────────────────────────────────┐
│ Language │
│ │
│ Display Language: [English ▼] │
│ │
│ Available: │
│ • English │
│ • 日本語 (Japanese) │
│ • 简体中文 (Simplified Chinese) │
│ • 繁體中文 (Traditional Chinese) │
└────────────────────────────────────────┘
Display Preferences
| Setting | Options | Description |
|---|---|---|
| Theme | System, Light, Dark | UI color scheme |
| Font Size | Small, Medium, Large | Text size |
Default Behavior
| Setting | Description |
|---|---|
| Default View | Starting window on launch |
| Auto-save | Automatically save changes |
| Notifications | Enable/disable notifications |
API Settings
Staff Only: Some options in this section are only visible to staff users.
Server Configuration
┌────────────────────────────────────────────────────────────────────┐
│ API Configuration │
│ │
│ API Base URL: [<host> _________________________] │
│ │
│ Connection Status: ● Connected │
│ │
│ [Test Connection] │
└────────────────────────────────────────────────────────────────────┘
| Setting | Description |
|---|---|
| API Base URL | Server endpoint URL |
| Connection Status | Current connection state |
| Test Connection | Verify server reachability |
Advanced Options (Staff)
| Setting | Description |
|---|---|
| Debug Mode | Enable debug logging |
| Request Timeout | API timeout duration |
| Retry Attempts | Number of retry attempts |
Mobile Test Settings
Configuration for mobile test execution.Device Settings
┌────────────────────────────────────────────────────────────────────┐
│ Mobile Test Settings │
│ │
│ Default Platform: [Android ▼] │
│ │
│ Screen Capture Quality: [High ▼] │
│ Options: Low, Medium, High │
│ │
│ Streaming Frame Rate: [30 ▼] fps │
│ Options: 15, 30, 60 │
└────────────────────────────────────────────────────────────────────┘
Execution Options
| Setting | Options | Description |
|---|---|---|
| Default Platform | Android, iOS | Preferred platform |
| Screenshot Quality | Low, Medium, High | Capture quality |
| Stream Frame Rate | 15, 30, 60 fps | Streaming performance |
Recording Options
| Setting | Description |
|---|---|
| Auto-capture Screenshots | Capture on each step |
| Save Failed Screenshots | Keep failure evidence |
| Screenshot Format | PNG or JPEG |
Change Analysis Settings
Settings for change detection and analysis features.Detection Parameters
┌────────────────────────────────────────────────────────────────────┐
│ Change Analysis Settings │
│ │
│ Detection Sensitivity: [Medium ▼] │
│ Options: Low, Medium, High │
│ │
│ Comparison Threshold: [80]% │
│ Range: 50-100% │
│ │
│ Auto-analyze on Save: [✓] │
└────────────────────────────────────────────────────────────────────┘
| Setting | Description |
|---|---|
| Detection Sensitivity | How sensitive change detection is |
| Comparison Threshold | Match percentage for similarity |
| Auto-analyze | Automatically analyze on save |
Reporting
| Setting | Description |
|---|---|
| Include Screenshots | Add images to reports |
| Detail Level | Summary, Standard, Detailed |
| Export Format | JSON, CSV, PDF |
MCP Settings
Model Context Protocol configuration for AI features.Service Configuration
┌────────────────────────────────────────────────────────────────────┐
│ MCP Settings │
│ │
│ MCP Service: [● Enabled] │
│ │
│ Model Selection: [Default ▼] │
│ │
│ Service URL: [<host> _________________________] │
│ │
│ Status: ● Connected │
└────────────────────────────────────────────────────────────────────┘
| Setting | Description |
|---|---|
| MCP Service | Enable/disable MCP |
| Model Selection | Choose AI model |
| Service URL | MCP endpoint URL |
Performance
| Setting | Description |
|---|---|
| Request Timeout | Max wait for response |
| Cache Results | Cache AI results |
| Batch Processing | Group requests |
Paths Settings
File system path configuration.Screenshot Paths
┌────────────────────────────────────────────────────────────────────┐
│ Paths Settings │
│ │
│ Screenshot Directory: │
│ [~/Desktop/QaptlyScreenshots ___________________] [Browse] │
│ │
│ Recording Directory: │
│ [~/Documents/QaptlyRecordings ___________________] [Browse] │
│ │
│ Cache Directory: │
│ [~/Library/Caches/Qaptly ___________________] [Browse] │
└────────────────────────────────────────────────────────────────────┘
| Path | Default | Description |
|---|---|---|
| Screenshots | ~/Desktop/QaptlyScreenshots | Saved screenshots |
| Recordings | ~/Documents/QaptlyRecordings | Recording files |
| Cache | System cache folder | Temporary files |
Tool Paths
For advanced configuration:| Path | Description |
|---|---|
| ADB Path | Android Debug Bridge location |
| Xcode Path | Xcode installation path |
Security Settings
Authentication and security configuration.Session Management
┌────────────────────────────────────────────────────────────────────┐
│ Security Settings │
│ │
│ Session │
│ ────────────────────────────────────── │
│ Session Timeout: [30] minutes │
│ Auto-lock: [✓] Enabled │
│ │
│ Authentication │
│ ────────────────────────────────────── │
│ Two-Factor Auth: [✓] Enabled │
│ Remember Device: [✓] For 30 days │
│ │
│ [Change Password] │
└────────────────────────────────────────────────────────────────────┘
Session Options
| Setting | Description |
|---|---|
| Session Timeout | Auto-logout after inactivity |
| Auto-lock | Lock app when inactive |
Authentication
| Setting | Description |
|---|---|
| Two-Factor Auth | Enable 2FA |
| Remember Device | Skip 2FA on trusted devices |
| Change Password | Update account password |
Data Security
| Setting | Description |
|---|---|
| Clear Cache | Remove cached data |
| Export Data | Download your data |
| Delete Account | Remove account (irreversible) |
About Settings
Application information and version details.Version Information
┌────────────────────────────────────────────────────────────────────┐
│ About Qaptly │
│ │
│ Version: 0.15.2 │
│ Build: 2024.01.15.001 │
│ Electron: 33.0.2 │
│ │
│ ────────────────────────────────────── │
│ │
│ Bundled Components: │
│ • qaptly_mac_cmd: v1.2.3 │
│ │
│ ────────────────────────────────────── │
│ │
│ Update Status: ● Up to date │
│ [Check for Updates] │
│ │
│ ────────────────────────────────────── │
│ │
│ © 2024 Qaptly. All rights reserved. │
└────────────────────────────────────────────────────────────────────┘
Available Information
| Field | Description |
|---|---|
| Version | Application version number |
| Build | Build identifier |
| Electron | Electron framework version |
| Components | Bundled tool versions |
Updates
| Action | Description |
|---|---|
| Check for Updates | Search for new versions |
| Update Status | Current update state |
| Release Notes | View changelog |
Saving Settings
Auto-Save
Most settings are saved automatically when changed.Manual Save
Some sections require clicking Save to apply changes.Reset to Defaults
Each section may have a Reset to Defaults option to restore original settings.Related: