salt.modules.mac_assistive¶

This module allows you to manage assistive access on macOS minions with 10.9+

salt '*' assistive.install /usr/bin/osascript

class salt.modules.mac_assistive.TccDB(path=None)¶

disable(app_id)¶

enable(app_id)¶

enabled(app_id)¶

install(app_id, enable=True)¶

installed(app_id)¶

remove(app_id)¶

salt.modules.mac_assistive.enable_(app_id, enabled=True)¶

Enable or disable an existing assistive access application.

app_id

The bundle ID or command to set assistive access status.

enabled

Sets enabled or disabled status. Default is True.

CLI Example:

salt '*' assistive.enable /usr/bin/osascript
salt '*' assistive.enable com.smileonmymac.textexpander enabled=False

salt.modules.mac_assistive.enabled(app_id)¶

Check if a bundle ID or command is listed in assistive access and enabled.

app_id

The bundle ID or command to retrieve assistive access status.

CLI Example:

salt '*' assistive.enabled /usr/bin/osascript
salt '*' assistive.enabled com.smileonmymac.textexpander

salt.modules.mac_assistive.install(app_id, enable=True, tries=3, wait=10)¶

Install a bundle ID or command as being allowed to use assistive access.

app_id

The bundle ID or command to install for assistive access.

enabled

Sets enabled or disabled status. Default is True.

tries

How many times to try and write to a read-only tcc. Default is True.

wait

Number of seconds to wait between tries. Default is 10.

CLI Example:

salt '*' assistive.install /usr/bin/osascript
salt '*' assistive.install com.smileonmymac.textexpander

salt.modules.mac_assistive.installed(app_id)¶

Check if a bundle ID or command is listed in assistive access. This will not check to see if it's enabled.

app_id

The bundle ID or command to check installed status.

CLI Example:

salt '*' assistive.installed /usr/bin/osascript
salt '*' assistive.installed com.smileonmymac.textexpander

salt.modules.mac_assistive.remove(app_id)¶

Remove a bundle ID or command as being allowed to use assistive access.

app_id

The bundle ID or command to remove from assistive access list.

CLI Example:

salt '*' assistive.remove /usr/bin/osascript
salt '*' assistive.remove com.smileonmymac.textexpander