.dotfiles

macOS, Linux, and Windows dotfiles, application settings, and user defaults

Bootstrapping

If bootstrapping for Windows, perform all steps in a Windows Subsystem for Linux (WSL) terminal (See How to install Linux on Windows with WSL).

1. clone git@github.com:WilHall/.dotfiles.git ~/.dotfiles/
2. cd ~/.dotfiles
3. ./bootstrap <DOTFILES_GITHUB_PERSONAL_ACCESS_TOKEN>

Backing Up and Restoring macOS User Defaults

I've created a command line utility dx for backing up and restoring macOS user defaults to my dotfiles:

Note: If you are committing backed up user defaults to a public repository, make sure to audit them first. Some applications may store sensitive information such as license keys, names, emails, or file system information.

This utility performs backups and restorations of macOS user defaults.
Backups are managed in `~/.defaults/`.

OPTIONS:
   -h | --help        Show this message
   -r | --restore     <DOMAIN> The domain to restore
   -R | --restore-all Restore all domains that have backups
   -b | --backup      <DOMAIN> The domain to back up
   -B | --backup-all  Back up all domains that already have backups

<DOMAIN> is one of:
-globalDomain  The macOS global domain
<DOMAIN_NAME>  The fully-qualified domain name (e.g. application bundle identifier)
<APP_NAME>     The application name (e.g. `/Applications/<APP_NAME>.app`

Examples

1. Backing up defaults for Safari: dx --backup Safari
2. Restoring the Safari backup: dx --restore Safari
3. Perform a backup for all domains that already have backups: dx --backup-all
4. Restore all existing backups: dx --restore-all

Finding Microsoft Store App IDs for winget

Copy the share URL from the microsoft store, and grab the ID (last path segement)) and put that into the URL:

https://bspmts.mp.microsoft.com/v1/public/catalog/Retail/Products/<APPID>/applockerdata

Then copy the packageIdentityName.

Backing up macOS system user defaults

Some macOS system settings, or settings that are changed in System Preferences, are not stored in a domain that corresponds to a particular application.

Some system settings are stored in the domain -globalDomain, and others are stored in particular system domains.

If backing up defaults using the app name (e.g. dx --backup <APP_NAME>) does not include the settings you are looking for, try the following:

1. In a terminal window, run fswatch / -e ".*" -i "\\.plist$" to watch for plist file changes
2. In the GUI, modify the application setting(s) you wish to back up
3. Look through the terminal output for plist files that were modified
4. Try backing up those plist domains to see what they contain by running dx --backup <PLIST_FILE_NAME> (without the .plist extension)

Backing Up and Restoring Windows AppData and Registry settings

I've created a command line utility wx for backing up and restoring Windows APpData and Registry settings to my dotfiles:

Note: If you are committing backed up settings to a public repository, make sure to audit them first. Some applications may store sensitive information such as license keys, names, emails, or file system information.

usage: wx

This utility performs backups and restorations of Windows application settings.
Backups are managed in '~/.appdata/'.

OPTIONS:
   -h | --help        Show this message
   -r | --restore     <SCOPE> <DOMAIN> [FILE_GLOB] The domain to restore
   -R | --restore-all <SCOPE> Restore all domains that have backups
   -b | --backup      <SCOPE> <DOMAIN> [FILE_GLOB] The domain to back up
   -B | --backup-all  <SCOPE> Back up all domains that already have backups

<SCOPE> is "Roaming", "Local", or "Registry"
<DOMAIN> is one of:
 - When <SCOPE> is "Registry": The registry key to operate on.
 - When <SCOPE> is "Roaming" or "Local": A subdirectory of %USERPROFILE%/AppData/<Roaming|Local>; may be a subpath.