macos-defaults/defaults.yml

---

categories:

  - folder: dock
    name: Dock
    description:
      The Dock is a prominent feature of macOS.
      It is used to launch applications and to switch between running applications.
      By default you can find it on the bottom of your screen.<br><br>
      You can customize it as you like.
    image:
      filename: "dock.png"
      width: 740
      height: 41
    keys:
      - key: autohide
        domain: com.apple.dock
        title: Autohide
        description: Autohides the Dock. You can toggle the Dock using `⌥ alt`+`⌘ cmd`+`d`.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Always display the Dock
          - value: true
            text: Autohide the Dock when the mouse is out
        versions: [Big Sur, Catalina]
        after: killall Dock
      - key: autohide-delay
        domain: com.apple.dock
        title: Autohide delay
        description: Change the Dock opening delay.
        param:
          type: float
        examples:
          - value: 0.5
            default: true
            video:
              filename: "0.5.mp4"
              width: 742
              height: 202
            text: By default, the Dock only opens if the mouse doesn't move for 0.5 seconds
          - value: 0
            video:
              filename: "0.mp4"
              width: 742
              height: 202
            text: Remove the autohide delay, the Dock appears instantly
        versions: [Big Sur, Catalina]
        requirements:
          - folder: dock
            key: autohide
            name: com.apple.dock autohide
            value: true
        after: killall Dock

  - folder: screenshots
    name: Screenshots
    description:
      "On a Mac, you can take screenshots using:<br>
      - `⌘ cmd`+`⇧ shift`+`3` for fullscreen.<br>
      - `⌘ cmd`+`⇧ shift`+`4` for a selection. Then use `space` to capture an entire app.<br>
      - `⌘ cmd`+`⇧ shift`+`5` to open the Screenshot app.<br><br>
      There is a few keys you can customize."
    keys:
      - key: disable-shadow
        domain: com.apple.screencapture
        title: Disable shadow
        description:
          Disable screenshot shadow when capturing an app (`⌘ cmd`+`⇧ shift`+`4` then `space`).
        param:
          type: bool
        examples:
          - value: false
            default: true
            image:
              filename: "false.png"
              width: 740
              height: 574
            text: Add a shadow to screenshots
          - value: true
            image:
              filename: "true.png"
              width: 740
              height: 550
            text: Remove the default shadow from screenshots
        versions: [Big Sur, Catalina]
      - key: include-date
        domain: com.apple.screencapture
        title: Include date
        description: Include date and time in screenshot filenames.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Screenshot 2020-01-09 at 13.27.20.png
          - value: false
            text:
              - Screenshot.png
              - Screenshot 1.png
        versions: [Big Sur, Catalina]
      - key: location
        domain: com.apple.screencapture
        title: Set location
        description: Set default screenshot location.
        param:
          type: string
        examples:
          - value: ~/Desktop
            default: true
          - value: ~/Pictures
        versions: [Big Sur, Catalina]
        after: killall SystemUIServer