Skip to main content


Available Tools


Only one tool can be open at a time. If you open a tool while another tool is open, it will wait in queue for the existing tool to be closed. Once the existing tool is closed, the new tool will open.


The integration creates an OpenPype menu entry where all related tools are located.


Menu creation can be temperamental. Its best to start Harmony and do nothing else until the application is fully launched. If you dont see the OpenPype menu, then follow this to create it:

  • Go to the Script Editor
  • Find the script called TB_sceneOpened.js and run it.
  • Choose the start method to run.


OpenPype > Workfiles

Work files are temporarily stored locally, in [user]/.avalon/harmony, to reduce network bandwidth. When saving the Harmony scene, a background process ensures the network files are updated.


Because the saving to the network location happens in the background, be careful when quickly saving and closing Harmony (and the terminal window) since an interrupted saving to the network location can corrupt the workfile. To be sure the workfile is saved to the network location look in the terminal for a line similar to this:

DEBUG:avalon.harmony.lib:Saved "[Local Scene Directory]" to "[Network Scene Directory]\[Name Of Workfile].zip"


OpenPype > Create


These are the families supported in Harmony:

  • Render
    • This instance is for generating a render and review. This is a normal write node, but only PNGs are supported at the moment.
  • Template
    • This instance is for generating a templates. This is a normal composite node, which you can connect any number of nodes to.
    • Any connected nodes will be published along with their dependencies and any back drops.
  • Palette
    • Palettes are indirectly supported in Harmony. This means you just have to have palettes in your scene to publish them.

When you Use selection on creation, the last selected node will be connected to the created node.


OpenPype > Publish


This tool will run through checks to make sure the contents you are publishing is correct. Hit the "Play" button to start publishing.

You may encounter issues with publishing which will be indicated with red squares. If these issues are within the validation section, then you can fix the issue. If there are issues outside of validation section, please let the OpenPype team know.

Repair Validation Issues

All validators will give some description about what the issue is. You can inspect this by going into the validator through the arrow:


You can expand the errors by clicking on them for more details:


Some validator have repair actions, which will fix the issue. If you can identify validators with actions by the circle icon with an "A":


To access the actions, you right click on the validator. If an action runs successfully, the actions icon will turn green. Once all issues are fixed, you can just hit the "Refresh" button and try to publish again.



OpenPype > Load


The supported families for Harmony are:

  • image
  • harmony.template
    • Only import is current supported for templates.
  • harmony.palette
    • Loaded palettes are moved to the top of the colour stack, so they will acts as overrides. Imported palettes are left in the scene.
  • workfile
    • Only of type zip.

To load, right-click on the subset you want and choose a representation:



Loading templates or workfiles will import the contents into scene. Referencing is not supported at the moment, so you will have to load newer versions into the scene.


OpenPype > Manage


You can switch to a previous version of the image or update to the latest.

Loader Loader


Images and image sequences will be loaded into the scene as read nodes can coloured green. On startup the pipeline checks for any outdated read nodes and colours them red.

  • Green = Up to date version in scene.
  • Red = Outdated version in scene.