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.

      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: [Monterey, Big Sur, Catalina, Mojave]
        after: killall Dock
      - key: tilesize
        domain: com.apple.dock
        title: Change macOS Dock icon size
        description: Set the icon size of Dock items in pixels.
        param:
          type: int
        examples:
          - value: 36
            image:
              filename: "36.png"
              width: 740
              height: 463
            text: Dock icon size of 36 pixels.
          - value: 48
            default: true
            image:
              filename: "48.png"
              width: 740
              height: 463
            text: Dock icon size of 48 pixels.
        versions: [Monterey, 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: [Monterey, Big Sur, Catalina, Mojave]
        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: [Monterey, Big Sur, Catalina, Mojave]
        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: [Monterey, Big Sur, Catalina, Mojave]
        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: [Monterey, Big Sur, Catalina, Mojave]
        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: [Monterey, Big Sur, Catalina, Mojave]
        requirements:
          - folder: dock
            key: autohide
            name: com.apple.dock autohide
            value: true
        after: killall Dock
      - key: static-only
        domain: com.apple.dock
        title: Active applications only
        description: Only show opened apps in Dock.
        param:
          type: bool
        examples:
          - value: true
            text: Only show active apps
          - value: false
            default: true
            text: Hide inactive apps from the Dock
        after: killall Dock
        versions: [Monterey]

  - folder: screenshots
    name: Screenshots
    description: |
      On a Mac, you can take screenshots using:

      - `⌘ cmd`+`⇧ shift`+`3` for fullscreen.
      - `⌘ cmd`+`⇧ shift`+`4` for a selection. Then use `space` to capture an entire app.
      - `⌘ cmd`+`⇧ shift`+`5` to open the Screenshot app.

      There are 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: [Monterey, Big Sur, Catalina, Mojave]
      - 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: [Monterey, Big Sur, Catalina, Mojave]
      - 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: [Monterey, Big Sur, Catalina, Mojave]
        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: [Monterey, Big Sur, Catalina, Mojave]
      - key: type
        domain: com.apple.screencapture
        title: Choose screenshot format
        description: Choose the screenshots image format.
        param:
          type: string
          values: [png, jpg, pdf, psd, gif, tga, tiff, bmp]
        examples:
          - value: png
            default: true
            text: The generated image is a png
          - value: jpg
            text: The generated image is a jpg
        versions: [Monterey, Big Sur, Catalina, Mojave]

  - folder: safari
    name: Safari
    description: |
      Safari is the default web browser on macOS.
      Some of its features can be customized.      
    keys:
      - key: ShowFullURLInSmartSearchField
        domain: com.apple.safari
        title: Show full URL
        description: Show full website address.
        param:
          type: bool
        examples:
          - value: true
            text: Show full website URL
            image:
              filename: "true.png"
              width: 740
              height: 207
          - value: false
            default: true
            text: Don't show full website URL
            image:
              filename: "false.png"
              width: 740
              height: 207
        versions: [Monterey]
        after: killall Safari

  - 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.

      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: [Monterey, Big Sur, Catalina, Mojave]
        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: [Monterey, Big Sur, Catalina, Mojave]
        after: killall Finder
      - key: AppleShowAllFiles
        domain: com.apple.finder
        title: Show hidden files
        description: Show hidden files in the Finder. You can toggle the value using `⌘ cmd`+`⇧ shift`+`.`.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Do not show hidden files inside the Finder
            image:
              filename: "false.png"
              width: 740
              height: 451
          - value: true
            text: Show hidden files inside the Finder
            image:
              filename: "true.png"
              width: 740
              height: 451
        versions: [Monterey, Big Sur, Catalina]
        after: killall Finder
      - key: ShowPathbar
        domain: com.apple.finder
        title: Path bar
        description: Show path bar in the bottom of the Finder windows
        param:
          type: bool
        examples:
          - text: Show path bar
            value: true
            image:
              filename: "true.png"
              width: 740
              height: 451
          - text: Hide path bar
            default: true
            value: false
            image:
              filename: "false.png"
              width: 740
              height: 451
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: FXPreferredViewStyle
        domain: com.apple.finder
        title: Default view style
        description: Set the default view style for folders without custom setting
        param:
          type: string
        examples:
          - value: clmv
            text: Column view
          - value: Nlsv
            text: List view
          - value: glyv
            text: Gallery View
          - value: icnv
            default: true
            text: Icon view
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: _FXSortFoldersFirst
        domain: com.apple.finder
        title: Keep folders on top
        description: Keep folders on top when sorting by name
        param:
          type: bool
        examples:
          - value: true
            text: Keep folders on top
          - value: false
            default: true
            text: Do not keep folders on top
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: FXDefaultSearchScope
        domain: com.apple.finder
        title: Default search scope
        description: Set the default search scope when performing a search
        param:
          type: string
        examples:
          - text: Search the current folder
            value: SCcf
          - text: Use the previous search scope
            value: SCsp
          - text: Search this Mac
            default: true
            value: SCev
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: FXRemoveOldTrashItems
        domain: com.apple.finder
        title: Empty bin items after 30 days
        description: Remove items in the bin after 30 days
        param:
          type: bool
        examples:
          - text: Automatically empty bin after 30 days
            value: true
          - text: Keep bin as is
            default: true
            value: false
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: FXEnableExtensionChangeWarning
        domain: com.apple.finder
        title: Changing file extension warning
        description: Choose whether to display a warning when changing a file extension.
        param:
          type: bool
        examples:
          - value: true
            default: true
            video:
              filename: "true.mp4"
              width: 739
              height: 416
            text: Display a warning when changing a file extension in the Finder
          - value: false
            video:
              filename: "false.mp4"
              width: 739
              height: 416
            text: Do not display the warning
        versions: [Monterey, Big Sur, Catalina, Mojave]
        after: killall Finder
      - key: NSDocumentSaveNewDocumentsToCloud
        domain: NSGlobalDomain
        title: Save to disk or iCloud by default
        description: Choose whether the default file save location is on disk or iCloud
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: iCloud Documents is the default directory opened in the fileviewer dialog when saving a new document
          - value: false
            text: home directory is opened in the fileviewer dialog when saving a new document
        versions: [Catalina]
      - key: showWindowTitlebarIcons
        domain: com.apple.universalaccess
        title: Title bar icons
        description: |
          Always show folder icon before title in the title bar

          ⚠️ This command requires to grant full disk access to the terminal
          (System Preferences → Security & Privacy → Full Disk Access)          
        param:
          type: bool
        examples:
          - text: Show icon in the title bar
            value: true
            image:
              filename: "true.png"
              width: 740
              height: 451
          - text: Hide icon from the title bar
            default: true
            value: false
            image:
              filename: "false.png"
              width: 740
              height: 451
        versions: [Monterey]
        after: killall Finder
      - key: NSToolbarTitleViewRolloverDelay
        domain: NSGlobalDomain
        title: Adjust toolbar title rollover delay
        description: Choose the delay of the auto-hidden document-proxy icon.
        param:
          type: float
        examples:
          - value: 0.5
            default: true
            video:
              filename: "0.5.mp4"
              width: 741
              height: 416
            text: By default, the toolbar title hovering delay takes 0.5 seconds
          - value: 0
            video:
              filename: "0.mp4"
              width: 741
              height: 416
            text: Remove the delay when hovering the toolbar title
          - value: 1
            video:
              filename: "1.mp4"
              width: 741
              height: 416
            text: Increase the delay when hovering the toolbar title
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: NSTableViewDefaultSizeMode
        domain: NSGlobalDomain
        title: Set sidebar icon size
        description: Choose the size of Finder sidebar icons
        param:
          type: int
        examples:
          - value: 1
            image:
              filename: "1.png"
              width: 740
              height: 415
            text: Small
          - value: 2
            default: true
            image:
              filename: "2.png"
              width: 740
              height: 415
            text: Medium
          - value: 3
            image:
              filename: "3.png"
              width: 740
              height: 415
            text: Large
        versions: [Monterey, Big Sur, Catalina]
        after: killall Finder

  - folder: desktop
    name: Desktop
    description: |
      Desktop shows files and icons on a background, works as a part of the Finder.
      The desktop view can be customized.      
    keys:
      - key: _FXSortFoldersFirstOnDesktop
        domain: com.apple.finder
        title: Keep folders on top
        description: Keep folders on top when sorting
        param:
          type: bool
        examples:
          - value: true
            text: Keep folders on top
          - value: false
            default: true
            text: Don't keep folders on top
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: CreateDesktop
        domain: com.apple.finder
        title: All icons
        description: Hide all icons on desktop
        param:
          type: bool
        examples:
          - text: Hide all icons
            value: false
          - text: Show all icons
            default: true
            value: true
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: ShowHardDrivesOnDesktop
        domain: com.apple.finder
        title: Disks
        description: Show hard disks on desktop
        param:
          type: bool
        examples:
          - text: Show hard disks
            value: true
          - text: Hide hard disks
            default: true
            value: false
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: ShowExternalHardDrivesOnDesktop
        domain: com.apple.finder
        title: External disks
        description: Hide external disks on desktop
        param:
          type: bool
        examples:
          - text: Hide external disks
            value: false
          - text: Show external disks
            default: true
            value: true
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: ShowRemovableMediaOnDesktop
        domain: com.apple.finder
        title: Removable media
        description: Hide removable media _(CDs, DVDs and iPods)_ on desktop
        param:
          type: bool
        examples:
          - text: Hide removable media
            value: false
          - text: Show removable media
            default: true
            value: true
        versions: [Monterey, Big Sur]
        after: killall Finder
      - key: ShowMountedServersOnDesktop
        domain: com.apple.finder
        title: Connected servers
        description: Show connected servers on desktop
        param:
          type: bool
        examples:
          - text: Show connected servers
            value: true
          - text: Hide connected servers
            default: true
            value: false
        versions: [Monterey, Big Sur]
        after: killall Finder

  - folder: menubar
    name: Menu Bar
    description:
      The menu bar runs along the top of the screen on your Mac.
      Use the menus and icons in the menu bar to choose commands, perform tasks, and check status.
    keys:
      - key: FlashDateSeparators
        domain: com.apple.menuextra.clock
        title: Flash clock time separators
        description:
          "When enabled, the clock indicator (which by default is the colon) will flash on and off each second."
        param:
          type: bool
        examples:
          - value: false
            default: true
            video:
              filename: "false.mp4"
              width: 727
              height: 40
            text: The time separator stays solid continuously.
          - value: true
            video:
              filename: "true.mp4"
              width: 727
              height: 40
            text: The time separator flashes every second.
        versions: [Monterey, Big Sur, Catalina, Mojave]
        after: killall SystemUIServer
      - key: DateFormat
        domain: com.apple.menuextra.clock
        title: Set menubar digital clock format
        description: |
          This setting configures the time and date format for the menubar digital clock.
          Accepted values depend on your Language & Region settings.

          - `ss` for seconds.
          - `HH` for 24-hour clock.
          - `EEE` for 3-letter day of the week.
          - `d MMM` for day of the month and 3-letter month.          
        param:
          type: string
        examples:
          - value: '"EEE d MMM HH:mm:ss"'
            video:
              filename: "EEE_d_MMM_HH.mm.ss.mp4"
              width: 727
              height: 40
            text: Thu 18 Aug 21:46:18
          - value: '"EEE h:mm:ss"'
            video:
              filename: "EEE_h.mm.ss.mp4"
              width: 727
              height: 40
            text: Thu 9:46:18
          - value: '"EEE HH:mm:ss"'
            video:
              filename: "EEE_HH.mm.ss.mp4"
              width: 727
              height: 40
            text: Thu 21:46:18
        versions: [Monterey, Big Sur, Catalina]

  - folder: mission-control
    name: Mission Control
    description: |
      Formerly known as Spaces, Mission Control allows a user to do the following:

      - `⌃ ctrl`+`↑ up` view all open application windows.
      - `⌃ ctrl`+`↓ down` view all open application windows of a specific application.
      - `⌘ cmd`+`F3 Mission Control` hide all application windows and show the desktop.
      - `⌃ ctrl`+`← left`/`→ right` manage application windows across multiple virtual desktops.
      - 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: [Monterey, Big Sur, Catalina, Mojave]
        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.

          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: [Monterey, Big Sur]

  - folder: xcode
    name: Xcode
    description:
      Xcode is an integrated development environment for macOS containing a suite of software development tools
      developed by Apple for developing software for macOS, iOS, iPadOS, watchOS, and tvOS.
    keys:
      - key: IDEAdditionalCounterpartSuffixes
        domain: com.apple.dt.Xcode
        title: Add Additional Counterpart Suffixes
        description:
          Add additional counterpart suffixes that Xcode should consider in the "Related Items > Counterparts" menu.
        param:
          type: array
        examples:
          - command: array-add
            value:
              - ViewModel
              - View
            title: Add "ViewModel" and "View"
            text: Add the "ViewModel" and "View" counterpart suffixes (Useful for Model-View-ViewModel (MVVM) architectures).
          - command: array-add
            value:
              - Router
              - Interactor
              - Builder
            title: Add "Router", "Interactor" and "Builder"
            text: Add the "Router", "Interactor" and "Builder" counterpart suffixes (Useful for RIB architectures).
        versions: [Catalina]
        after: killall Xcode
      - key: ShowBuildOperationDuration
        domain: com.apple.dt.Xcode
        title: Show Build Durations
        description:
          Show build durations in the Activity Viewer in Xcode's toolbar at the top of the workspace window.
        param:
          type: bool
        examples:
          - value: true
            text: Show the build duration in the Xcode's toolbar
          - value: false
            default: true
            text: Do not show the build duration in the Xcode's toolbar
        versions: [Catalina]
        after: killall Xcode

  - folder: simulator
    name: Simulator
    description:
      Installed as part of the Xcode tools, Simulator is a Mac app simulating iPhone, iPad, Apple Watch, or Apple TV environments.
    keys:
      - key: ScreenShotSaveLocation
        domain: com.apple.iphonesimulator
        title: Set screenshot location
        description: |
          Set default location for Simulator screenshots.

          Note that the folder has to exist in the filesystem.          
        param:
          type: string
        examples:
          - value: ~/Pictures/Screenshots
            default: true
          - value: "~/Pictures/Simulator Screenshots"
        versions: [Catalina]

  - folder: textedit
    name: TextEdit
    description:
      TextEdit allows you to open and edit rich text, plain text and HTML documents.
    keys:
      - key: RichText
        domain: com.apple.TextEdit
        title: Set default document format
        description:
          Set default document format as rich text (.rtf) or plain text (.txt).
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: Rich text is enabled.
            image:
              filename: "true.png"
              width: 740
              height: 451
          - value: false
            text: Rich text is disabled.
            image:
              filename: "false.png"
              width: 740
              height: 451
        versions: [Monterey, Big Sur]
        after: killall TextEdit

  - folder: timemachine
    name: Time Machine
    description:
      The Time Machine feature allows simple, regular backups of your
      filesystem.
    keys:
      - key: DoNotOfferNewDisksForBackup
        domain: com.apple.TimeMachine
        title: Don't offer new disks for Time Machine backup
        description:
          Prevent Time Machine from prompting to use newly connected storage as backup volumes.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text:
              When a new disk is connected, system prompts to ask if you want to use it as a backup volume.
          - value: true
            text:
              When a new disk is connected, system does not prompt to ask if you want to use it as a backup volume.
        versions: [Catalina]

  - folder: activity-monitor
    name: Activity Monitor
    description: |
      Activity Monitor is the built-in utility for monitoring your systems resource usage, such as
      CPU, RAM, Disk, Network, and Energy.      
    keys:
      - key: UpdatePeriod
        domain: com.apple.ActivityMonitor
        title: Update Frequency
        description: How frequently Activity Monitor should update its data, in seconds.
        param:
          type: int
          values: [1, 2, 5]
        examples:
          - value: 1
            text: "Very often (1s)"
          - value: 2
            text: "Often (2s)"
          - value: 5
            default: true
            text: "Normally (5s)"
        after: killall Activity\ Monitor
        versions: [Monterey]
      - key: IconType
        domain: com.apple.ActivityMonitor
        title: Dock Icon type
        description: Choose what information should be shown in the app's Dock icon, if any.
        param:
          type: int
          values: [0, 2, 3, 5, 6]
        examples:
          - value: 0
            default: true
            text: Just show the App's regular icon.
          - value: 2
            text: |
              Show Network usage over time, as two mirrored line graphs.
              The top (blue) chart shows down-stream traffic.
              The bottom (red) chart shows up-stream traffic.              
          - value: 3
            text: |
              Show Disk usage over time, as two mirrored line graphs.
              The top (blue) chart shows disk read traffic.
              The bottom (red) chart shows disk write traffic.              
          - value: 5
            text: Show the current CPU usages, as a verticle meter.
          - value: 6
            text: |
              Show CPU usage history, graphed over time.
              If your device has 4 threads or less, it'll show one graph per thread, all stacked vertically.
              If you have more than 4 threads, then only one bar graph will be shown, for the total CPU usage.              
        after: killall Activity\ Monitor
        versions: [Monterey]

  - 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: [Monterey, Big Sur, Catalina, Mojave]
      - key: enable-spring-load-actions-on-all-items
        domain: com.apple.dock
        title: Enable spring loading for all Dock items
        description:
          Drag a file over an icon in the Dock, hover, and the
          application will open. The behaviour is unchanged if the app
          is already open. This behaviour has been observed with Preview,
          Quicktime, and iWork (Keynote, Pages, Numbers).
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Spring loading is disabled for Dock items.
          - value: true
            text: Spring loading is enabled for Dock items.
        versions: [Monterey, Big Sur, Catalina]
        after: killall Dock
      - key: userWantsPlaybackNotifications
        domain: com.apple.Music
        title: Show Music song notifications
        description: Display a notification when a new song starts in the Music app.
        param:
          type: bool
        examples:
          - value: false
            default: true
            text: Notifications will not be displayed.
          - value: true
            text: Notifications will be displayed.
        versions: [Catalina]
        after: killall Music
      - key: LSQuarantine
        domain: com.apple.LaunchServices
        title: Disable application quarantine message
        description: |
          Turn off the “Application Downloaded from Internet” quarantine warning.

          ⚠️ Stopped working on Big Sur.          
        param:
          type: bool
        examples:
          - value: true
            default: true
            text: '"Application Downloaded from Internet" popup will display'
          - value: false
            text: '"Application Downloaded from Internet" popup will not display'
        versions: [Catalina]
      - key: ApplePressAndHoldEnabled
        domain: NSGlobalDomain
        title: Key held down behavior
        description: |
          Allows you to select the behavior when a key is held down for a long time. The two possible behaviors are:

          - show character accents menu (default)
          - repeat character while key held

          ⚠️ Restarting the Mac, closing the session or restarting the application is necessary to take into effect the changes.          
        param:
          type: bool
        examples:
          - value: true
            default: true
            image:
              filename: "true.png"
              width: 696
              height: 252
            text: By default, when a key is held down, the accents menu is displayed.
          - value: false
            image:
              filename: "false.png"
              width: 696
              height: 252
            text: Repeats the key as long as it is held down.
        versions: [Monterey, Big Sur]