Desktop Guide
ScanVid Desktop is the companion desktop client for the iOS app, used to receive, manage, and export video recordings from your phone.
System Requirements
| Platform | Requirements |
|---|---|
| macOS | 12.0 (Monterey) or later, Apple Silicon + Intel |
| Windows | 10 (64-bit) or later (coming soon) |
Installation
macOS
- Download the
.dmgfile from the Download page - Open the
.dmgand drag ScanVid to your Applications folder - On first launch, if you see "cannot verify developer":
- Go to System Settings > Privacy & Security
- Click "Open Anyway"
Connecting Your Phone
Prerequisites
Your phone and computer must be connected to the same Wi-Fi / local network.
Steps
- Open Desktop: On launch, it displays a QR code and local IP address
- Open Mobile App: Navigate to the "Backup" tab
- Scan to Connect: Tap "Scan to Connect" and scan the QR code shown on desktop
- Connected: Both devices show connection status, ready to transfer
Troubleshooting
| Issue | Solution |
|---|---|
| No response after scanning | Ensure phone and computer are on the same Wi-Fi |
| Connection timeout | Check if firewall allows port 9876 |
| QR code unreadable | Increase screen brightness, refresh the QR code |
| Corporate network isolation | Try using phone hotspot to connect |
Backing Up Videos
After connecting, on the mobile "Backup" page:
- Backup All Unsynced: One-tap send all untransferred recordings to computer
- Selective Backup: Manually select specific recordings to backup
- Cleanup Synced: After transfer, clean up backed-up files on phone (desktop copies remain)
Note
- Large files (≥500MB) are automatically transferred in chunks — please be patient
- Do not close the app or switch to background during transfer
- Interrupted transfers will auto-resume upon reconnection
Managing Videos
The desktop client provides the following management features:
Browse & Filter
- Search: Search by barcode number or note content
- Date Filter: Filter by date range
- Project Filter: Filter by mobile app project categories
- Has Notes: Show only recordings with notes
Actions
- Play: Click play button to preview directly
- Copy Barcode: One-click copy barcode content
- Delete: Remove backup files from desktop
- Batch Export: Multi-select and export to a specified folder
FAQ
Where are desktop videos stored?
By default, videos are stored in the app data directory. Use the "Batch Export" feature to copy videos to any location.
Can I connect multiple phones simultaneously?
The current version supports single-device connection. Multi-device concurrent transfer will be supported in future versions.
What video format is used?
All recordings are stored as MP4, accompanied by JSON metadata files (containing barcode, timestamp, notes, GPS location, etc.).
How do I update the desktop app?
The app automatically checks for updates on launch. If a new version is available, you'll be prompted to download and install. You can also manually download the latest version from the Download page.
