macos-defaults/defaults.yml
2022-08-19 11:48:58 +02:00

1029 lines
34 KiB
YAML

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