Overview

  1. Apple sandbox
  2. Security permissions
  3. Main Application window
  4. Preferences
  5. Applescript® resources
  6. Adobe Javascript
  7. Tips

1. Apple sandbox

MaScriptRunner is entirely Apple® sandbox compliant.
If you like to know more about Apple® sandbox technology, go to "apple.com"

2. Security permissions

Security pop-up

Those kind of pop-up windows are completely normal. You need to give access to maScriptRunner to talk against other applications. In this particular case you need to give access to maScriptRunner to run Applescripts, what is the main reason to run maScriptRunner. Only Applescripts that are stored inside a folder that you defined within maScriptRunner. IMPORTANT: If you applied "auto restart" in the preferences panel of maScriptRunner, you need to give access to maScriptRunner to restart himself. MaScriptRunner will not execute or interact with other applications as long as you do not give permission to do so.


(!) REMARK: Those kind of permissions must be given only once, on the first run of maScriptRunner or a particular script.


Applescript

Afterward, the system knows that you trust maScriptRunner. We suggest to code sign your own Applescripts to be compliant to Apple's security standards, therefor you need an Apple Developer ID.
How to do this? It is clearly explained at "macosxautomation.com" or at "developer.apple.com"

System Settings

Allow maScriptRunner access to the applications where your script is build for, for example the Adobe InDesign application.

3. Main application window explained

4. Preferences

  1. Poll interval: Execute scripts every 'x' seconds.
  2. Run application at launch:
    Automatically run scripts when the application launches.
  3. Heartbeat file: Write a heartbeat file to a specified location to enable professional monitoring and verify that scripts are running correctly.
  4. Auto restart option: Automatically restart maScriptRunner after x script executions.

5. Applescript® resources:

This are the Applescript® resources

  1. apple.com
  2. Apple Script Editor®
  3. macscripter.net
  4. macosautomation.com
  5. Script Debugger
  6. automatorworld.com
  7. satimage.fr
  8. scriptingosx.com

6. Adobe Javascript resources:

Adobe Javascript resources:

  1. Adobe Extendscript Guide
  2. Adobe Scripting

How to run Adobe® Javascripts

Name convention of the Javascripts:

"Adobe InDesign 2024" + "__" + "description of your choice" + ".jsx"
For example: "Adobe InDesign 2024__makeNewDocument.jsx"
"Adobe Photoshop 2022" + "__" + "description of your choice" + ".jsx"
"Adobe Illustrator 2023" + "__" + "description of your choice" + ".jsx"

The file name prefix consists of the Adobe application name, followed by a double underscore (__)
Pay attention to the file extension, this should be: .jsx

This also allows you to target specific application versions!

7. Tips:

maScriptRunner will run all your selected scripts in an endless loop, but sometimes you might like to run a script at a certain time of the day.

We will show you one way how to do this.
Using this piece of Applescript® at the highest level of your own script: