Importing Scripts

T-ANIMPA-007-002

If you want to use scripts written by other users, you can transfer the .js files from their computer to yours, then use the Script Editor to import the .js files from where they are stored on your computer.

NOTES
  • When you import a script, any user interface (.ui) or icon (.png) file that is in the same directory and has the same filename as the script will also be imported.

  • User scripts are stored in the following location:

    • Windows: C:\Users\[username]\AppData\Roaming\Toon Boom Animation\Toon Boom Harmony Essentials\1700-scripts
    • macOS: /Users/[username]/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Essentials/1700-scripts
  1. Do one of the following:
    • In the Script Editor toolbar, click on Import Script.
    • In the top-left corner of the Script Editor view, click on the Menu button and select File > Import Script.

    An Open dialog appears.

  1. In the Open dialog, browse to the location of the script you want to import. Select it, then click on Open.

    A dialog prompts you to select the location in which to import the script.

  1. In the drop-down menu, select the location in which you want to import the script:

    • User: Saves the script to a directory in your user preferences directory. You will be able to run and edit the script from any scene as long as you are logged in as the same user.

    • Scene: Save the script to the scene's scripts sub-folder. Anyone will be able to edit and run the script when working on this specific scene.
    • System Variable: Save the script to the directory in the TOONBOOM_GLOBAL_SCRIPT_LOCATION environment variable. This option is only available if this environment variable is set.

  1. Click on OK.

    The script is copied to the chosen location and can now be edited and executed in the Script Editor view. It can also be added as a button to the Scripting toolbar—see Adding Scripts as Toolbar Buttons.