Ansible Role: Dockutil

This role installs Dockutil, which lets you manage the items on the dock of macOS. You can remove, add, and rearrange items. During the process, it also clears the icon cache, but if you have ongoing issues, you might need to restart your system.

Requirements

None.

Role Variables

Administration

# The URL to download the dockutil script.
dockutil_url: https://raw.githubusercontent.com/kcrawford/dockutil/master/scripts/dockutil
# The location where dockutil will be installed.
dockutil_install_path: /usr/local/bin/dockutil

Removing dock items

List of items to remove from the dock:

dockitems_disabled:
  - Launchpad
  - Mail
  - Safari
  - Contacts
  - Notes
  - Reminders
  - Maps
  - Photos
  - Messages
  - FaceTime
  - iTunes
  - iBooks
  - App Store
  - System Preferences
  - Calendar
  - Terminal

Preferred method: Remove all items

dockitems_remove_all: true

Alternative method: Remove all items:

dockitems_disabled:
  - all

Adding dock items

List of items to add, including their name, path, and position:

dockitems_enabled:
  - name: Google Chrome
    path: "/Applications/Google Chrome.app"
    pos: 1
  - name: Tower
    path: "/Applications/Tower.app"
    pos: 2
  - name: FirefoxDeveloperEdition
    path: "/Applications/FirefoxDeveloperEdition.app"
    pos: 3
  - name: Sublime Text
    path: "/Applications/Sublime Text.app"
    pos: 4
  - name: iTerm
    path: "/Applications/iTerm.app"
    pos: 5
  - name: TeamViewer
    path: "/Applications/TeamViewer.app"
    pos: 6

Dependencies

None.

Example Playbook

    - hosts: localhost
      roles:
        - fubarhouse.macdock

License

MIT / BSD

Author Information

This role was created in 2016 by Karl Hepworth.