# salt.modules.mac_assistive

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

Added 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