macos-dock
Ansible role: macOS Dock
Configure the macOS Dock including which items appear in it and in what order.
Requirements
- Ansible >= 2.1
- macOS 10.13, or 10.11
Role variables
# Whether the Dock automatically hides.
macos_dock_autohide: true
# The size of icons in the Dock.
macos_dock_icon_size: 60
# The orientation of the Dock.
# "left | "bottom" | "right"
macos_dock_orientation: "bottom"
# A list of apps that you wish to appear in the Dock and in what order.
# The Dock item list will not be altered if this list is left empty.
#
# Supported directories for apps:
# - /Applications
# - /Users/[username]/Applications
#
# Notes:
# - List order affects order in Dock.
# - Use absolute paths to files.
# - {{ ansible_user_id }} returns the username of the *target* system
# (you must surround the path in quotes to use this).
#
# Examples:
# - /Applications/System Preferences.app
# - /Applications/Utilities/Activity Monitor.app
# - "/Users/{{ ansible_user_id }}/Applications/Firefox.app"
macos_dock_apps: []
# Max directory depth when checking for installed apps.
macos_dock_apps_dir_maxdepth: 2
Dependencies
Example playbook
- hosts: all
vars:
macos_dock_apps:
- /Applications/Utilities/Activity Monitor.app
- /Applications/System Preferences.app
- "/Users/{{ ansible_user_id }}/Applications/Firefox.app"
roles:
- role: ansible-role-macos-dock,
License
MIT
Author information
This role was created by Dan Bohea primarily for use with Macsible.