apply-user-defaults - GitLite

KO | EN

gitlite — search

#javascript #ai #llm #go #golang #android #machine-learning #deep-learning #linux #macos #windows #awesome #mcp #openai

apply-user-defaults

(★ 73)

A small utility to set macOS user defaults declaratively from a YAML file.

파일 탐색기

최종 버전 다운로드 (.zip)

- package
- cli.rs
- main.rs
- messages.rs
- - defaults-escaped.yml
  - defaults.yml
- integration.rs
.editorconfig
.gitignore
.travis.yml
build.rs
Cargo.lock
Cargo.toml
CHANGELOG.md
LICENSE-APACHE
LICENSE-MIT
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/zero-sh/apply-user-defaults

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd apply-user-defaults

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Rust

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

$ cargo install apply-user-defaults

이 명령어를 터미널에 그대로 입력해 실행하세요.

$ cargo run -- path-to-file.yml --verbose

빌드 후 바로 실행까지 진행합니다.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build Status](https://travis-ci.org/zero-sh/apply-user-defaults.svg?branch=master)](https://travis-ci.org/zero-sh/apply-user-defaults)
![License](https://img.shields.io/crates/l/apply-user-defaults.svg)
[![Crates.io](https://img.shields.io/crates/v/apply-user-defaults.svg)](https://crates.io/crates/apply-user-defaults)

# apply-user-defaults

`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:

```yaml
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:

```sh
$ apply-user-defaults path-to-file.yaml
```

You can also see what commands are being run by enabling verbose output:

```sh
$ apply-user-defaults path-to-file.yaml --verbose
==> defaults write com.apple.dock autohide -bool true
==> defaults write com.apple.dock mineffect -string scale
==> defaults write com.apple.dock show-process-indicators -bool false
==> defaults write com.apple.dock tilesize -int 72
Success! Applied defaults.
```

## Template Expansion

Environment variables can also be included using shell parameter expansion
syntax. For example:

```yaml
com.apple.finder:
  # Finder > Preferences > New Finder windows show > Home directory.
  NewWindowTargetPath: "file://${HOME}"
```

will evaluate to:

```sh
defaults write com.apple.finder NewWindowTargetPath -string "file://$HOME"
```

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](https://github.com/zero-sh/apply-user-defaults/releases).

### Homebrew

If you're using Homebrew, you can install with a custom tap:

```sh
$ brew install zero-sh/tap/apply-user-defaults
```

### Cargo Install

To install via Cargo, run:

```sh
$ cargo install apply-user-defaults
```

### Building from Source

To build from source:

```sh
$ 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](LICENSE-APACHE) or
[MIT](LICENSE-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.