You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
apply-user-defaults is a small utility to set macOS user defaults
declaratively from a YAML file.
Usage
To use, simply structure a YAML file like the following:
com.apple.dock:
# System Preferences > Dock > Automatically hide and show the Dock.autohide: true# System Preferences > Dock > Minimize windows using: Scale effect.mineffect: "scale"# System Preferences > Dock > Show indicators for open applications.show-process-indicators: false# System Preferences > Dock > Size.tilesize: 72
Then apply it using:
$ apply-user-defaults path-to-file.yaml
You can also see what commands are being run by enabling verbose output:
where $HOME is the value contained in the HOME environment variable.
This only applies when the string in the YAML file begins with a dollar sign and
is wrapped in braces (just using $HOME won't work).
To disable, you may pass the flag --no-env or escape the dollar sign, e.g.
'\\${VALUE}'.
Installation
Pre-compiled binaries are available on the releases
page.
Homebrew
If you're using Homebrew, you can install with a custom tap:
$ brew install zero-sh/tap/apply-user-defaults
Cargo Install
To install via Cargo, run:
$ cargo install apply-user-defaults
Building from Source
To build from source:
$ git clone https://github.com/zero-sh/apply-user-defaults.git
$ cd apply-user-defaults
$ cargo run -- path-to-file.yml --verbose
License
This project is licensed under either the Apache-2.0 or
MIT license, at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
About
A small utility to set macOS user defaults declaratively from a YAML file.