salt.modules.mac_assistive

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

New in version 2016.3.0.

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