#macos #bettersnaptool #migration #kb
[[#Overview]] | [[#Configuration]] | [[#Procedure]] | [[#Troubleshooting]] | [[#TODO]] | [[#References]] | [[#Changelog]]
# Overview
BetterSnapTool (BST) has no built-in export or import. To move custom snap areas, hotkeys and settings to a new Mac, copy two things:
- its preferences domain
- its Application Support folder
BST must be quit on both machines while you do this. Snap areas are tied to the display and resolution they were drawn on, so the new Mac needs the same monitor at the same scaled resolution.
# Configuration
| What | Location | Contents |
|---|---|---|
| Preferences domain | `~/Library/Preferences/com.hegenberg.BetterSnapTool.plist` | General settings, keyboard shortcuts, app-specific sizes |
| Snap area store | `~/Library/Application Support/BetterSnapTool/` (`storedata`) | Custom snap areas |
- `~/Library` is hidden. Reach it with Finder → Go → Go to Folder.
- Use `defaults export` and `defaults import` rather than copying the plist file directly. macOS caches preferences in `cfprefsd`, and a plist dropped into place can be overwritten by the cached copy.
- BST must be quit during export and import. A running instance rewrites the plist from memory.
# Procedure
## Old Mac — export
1. Quit BetterSnapTool from its menu bar icon.
2. Export the preferences and copy the snap area folder:
```bash
mkdir -p ~/Desktop/BST
defaults export com.hegenberg.BetterSnapTool ~/Desktop/BST/com.hegenberg.BetterSnapTool.plist
cp -R ~/Library/Application\ Support/BetterSnapTool ~/Desktop/BST/
```
3. Move `~/Desktop/BST` to the new Mac (AirDrop, USB or NAS).
## New Mac — import
1. Install BetterSnapTool and launch it once.
2. Grant Accessibility permission in System Settings → Privacy & Security → Accessibility. This permission does not transfer from the old Mac.
3. Quit BetterSnapTool.
4. Set the display to the same scaled resolution as the old Mac.
5. Import the preferences and replace the snap area folder:
```bash
defaults import com.hegenberg.BetterSnapTool ~/Desktop/BST/com.hegenberg.BetterSnapTool.plist
rm -rf ~/Library/Application\ Support/BetterSnapTool
cp -R ~/Desktop/BST/BetterSnapTool ~/Library/Application\ Support/
```
6. Launch BetterSnapTool and confirm the snap areas and hotkeys are there.
7. Reboot and confirm they persist.
# Troubleshooting
**Settings didn't carry over**
Either BST was running during the import, or the plist was copied instead of imported. Quit BST, re-run `defaults import`, then relaunch.
**Snap areas missing but settings present**
The display or resolution doesn't match. Set the old scaled resolution in System Settings → Displays, then relaunch BST.
**Snap areas or hotkeys reset after restart**
Reported after a migration to an M4 Max (macOS 15.7.2, BST 1.9.12). The developer's fix:
1. Quit BST.
2. Delete `~/Library/Preferences/com.hegenberg.BetterSnapTool.plist` and `~/Library/Application Support/BetterSnapTool/storedata`.
3. Recreate the snap areas by hand.
Keep the `BST` backup folder until persistence is confirmed.
**Full reset (wipes all BST settings)**
```bash
defaults delete com.hegenberg.BetterSnapTool
```
# TODO
- [ ] Export from old Mac
- [ ] Import on new Mac
- [ ] ==Verify snap areas and hotkeys survive a reboot on the new Mac==
- [ ] Delete `~/Desktop/BST` once confirmed
# References
- [Moving BetterSnapTool settings to a new computer](https://community.folivora.ai/t/moving-bettersnaptool-settings-to-a-new-computer/16537): the developer gives the file locations
- [Transfer BST preferences & snap areas to new Mac](https://community.folivora.ai/t/transfer-bst-preferences-snap-areas-to-new-mac/31253): BST must be quit before copying
- [BetterSnapTool macOS Sequoia issues](https://community.folivora.ai/t/bettersnaptool-macos-sequoia-issues/45701): settings stop persisting after a migration; confirms the `storedata` location
- [Snap Area Backup](https://community.folivora.ai/t/beter-touch-tool-snap-area-backup/4124): snap areas are tied to a display and resolution (said about BetterTouchTool)
- [Appspecific Settings in BetterSnapTool](https://community.folivora.ai/t/appspecific-settings-in-bettersnaptool/5651): `defaults delete` reset
# Changelog
## 2026-10-23
- Created note from chat research on migrating BST to a new Mac.