Keep settings across machines with OneDrive#
When a local OneDrive folder is available, Hotshot automatically creates or loads:
<OneDrive>\Apps\Hotshot\settings.json
On your other Windows machines, sign into the same OneDrive account, let that folder synchronize, and install a current Hotshot release. Each machine reads the portable preferences while keeping its own device settings.
| Shared preferences | Kept on each machine |
|---|---|
| Theme, startup preference, hotkeys, filename patterns | Capture folder, runtime path, microphone device ID |
| Clipboard/save choices, capture and recording options, GIF options | Window positions, splitter width, counters, first-run state |
| Local-OCR preference, AI exclusion list, export presets, saved searches | Cloud-AI enable/review choices, all coding-agent permissions, project baseline IDs |
This syncs settings, not captures or history. Hotshot does not share a folder with other people or change OneDrive permissions. The OneDrive desktop client handles uploads/downloads; seeing a local file does not prove cloud transfer is complete.
The default capture folder is inside OneDrive when available, so OneDrive can upload those saved images and recordings. History, private originals and sign-ins remain on this device; their folders are not part of the capture-folder default.
Under General > Settings across devices, choose another OneDrive root, reload shared preferences, or select Use local preferences only. The page shows the exact file paths and status. Local-only mode does not delete the shared file.
Offline edits stay in the local cache and are retried. Incoming changes apply when the app is idle and Settings is not being edited. Independent field edits merge; conflicting edits require you to choose which preferences to keep. If OneDrive creates extra settings conflict-copy JSON files, review and move those copies before resolving the conflict. Invalid files are not silently replaced with defaults.