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: orientation
        domain: com.apple.dock
        title: Position
        description: Set the Dock position
        param:
          type: string
          values: [left, bottom, right]
        examples:
          - value: left
            image:
              filename: "left.png"
              width: 740
              height: 463
            text: Put the Dock on the left of the screen
          - value: bottom
            default: true
            image:
              filename: "bottom.png"
              width: 740
              height: 463
            text: Put the Dock on the bottom of the screen
          - value: right
            image:
              filename: "right.png"
              width: 740
              height: 463
            text: Put the Dock on the right of the screen
        versions: [Big Sur, Catalina]
        after: killall Dock
      - 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-time-modifier
        domain: com.apple.dock
        title: Autohide animation time
        description: Change the Dock opening and closing animation times.
        param:
          type: float
        examples:
          - value: 0.5
            default: true
            video:
              filename: "0.5.mp4"
              width: 742
              height: 202
            text: By default, the Dock opening and closing animations take 0.5 seconds
          - value: 2
            video:
              filename: "2.mp4"
              width: 742
              height: 202
            text: Increase the Dock animation time
          - value: 0
            video:
              filename: "0.mp4"
              width: 742
              height: 202
            text: Remove the Dock autohide animation
        versions: [Big Sur, Catalina]
        requirements:
          - folder: dock
            key: autohide
            name: com.apple.dock autohide
            value: true
        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
      - key: show-recents
        domain: com.apple.dock
        title: Show recents
        description: Show recently used apps in a separate section of the Dock.
        param:
          type: bool
        examples:
          - value: true
            default: true
            image:
              filename: "true.png"
              width: 740
              height: 82
            text: Display recent apps in the Dock
          - value: false
            image:
              filename: "false.png"
              width: 740
              height: 82
            text: Do not display recent apps in the Dock
        versions: [Big Sur, Catalina]
        after: killall Dock
      - key: mineffect
        domain: com.apple.dock
        title: Minimize animation effect
        description: Change the Dock minimize animation.
        param:
          type: string
          values: [genie, scale, suck]
        examples:
          - value: "genie"
            default: true
            video:
              filename: "genie.mp4"
              width: 740
              height: 740
          - value: "scale"
            video:
              filename: "scale.mp4"
              width: 740
              height: 740
          - value: "suck"
            video:
              filename: "suck.mp4"
              width: 740
              height: 740
            text: Suck is an secret value you can't find inside the System Preferences
        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
      - key: show-thumbnail
        domain: com.apple.screencapture
        title: Display thumbnail
        description: Choose whether to display a thumbnail after taking a screenshot.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Display the thumbnail after taking a screenshot
          - value: false
            text: Do not display the thumbnail
        versions: [Big Sur, Catalina]

  - folder: finder
    name: Finder
    description:
      The Finder is the default file manager on macOS.
      It is responsible for the launching of other applications,
      and for the overall user management of files, disks, and network volumes.
      In a tradition dating back to the Classic Mac OS of the 1980s and 1990s,
      the Finder icon is the smiling screen of a computer, known as the Happy Mac logo.<br><br>
      Some of its features can be customized.
    keys:
      - key: QuitMenuItem
        domain: com.apple.finder
        title: Quit
        description: Add a quit option to the Finder.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Hide the Finder "Quit" option
          - value: true
            text: Display the Finder "Quit" option
        versions: [Big Sur]
        after: killall Finder
      - key: AppleShowAllExtensions
        domain: NSGlobalDomain
        title: Show extensions
        description: Show all file extensions in the Finder.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Do not show all file extensions inside the Finder
          - value: true
            text: Show all file extensions inside the Finder
        versions: [Big Sur]
        after: killall Finder

  - folder: mission-control
    name: Mission Control
    description:
      "Formerly known as Spaces, Mission Control allows a user to do the following:<br>
      - `⌃ ctrl`+`↑ up` view all open application windows.<br>
      - `⌃ ctrl`+`↓ down` view all open application windows of a specific application.<br>
      - `⌘ cmd`+`F3 Mission Control` hide all application windows and show the desktop.<br>
      - `⌃ ctrl`+`← left`/`→ right` manage application windows across multiple virtual desktops.<br>
      - manage application windows across multiple monitors."
    keys:
      - key: mru-spaces
        domain: com.apple.dock
        title: Rearrange automatically
        description: Choose whether to rearrange Spaces automatically.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Do reorder Spaces based on most recent use
          - value: false
            text: Keep the Spaces arrangement
        versions: [Big Sur]
        after: killall Dock

  - folder: feedback-assistant
    name: Feedback Assistant
    description:
      The Feedback Assistant app allows user to submit reports for developer or public betas.
    keys:
      - key: Autogather
        domain: com.apple.appleseed.FeedbackAssistant
        title: Autogather
        description:
          Choose whether to autogather large files when submitting a feedback report.<br>
          Can result in a slow Mac and important upload metrics.
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Feedback Assistant gathers large files when submitting a report
          - value: false
            text: Do not autogather large files when submitting a report
        versions: [Big Sur]

  - folder: misc
    name: Miscellaneous
    description: All the others `defaults` that don't deserve their own category.
    keys:
      - key: DevMode
        domain: com.apple.helpviewer
        title: Help Menu position
        description: Choose whether the Help Menu should be always-on-top.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: By default, the Help Menu is always-on-top
          - value: true
            text: The Help Menu can go behind other windows
        versions: [Big Sur]