--- 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. ⚠️ Beware this command empties your Dock. param: type: bool examples: - value: true text: Only show active apps - value: false default: true text: Show apps pinned to 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 video: filename: true.mp4 width: 739 height: 416 - value: false default: true text: Do not keep folders on top video: filename: false.mp4 width: 739 height: 416 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]