New Lua Scripting Engine

Lua BookAnyone using NWC version 2.51 or later now has a built-in user tool scripting engine, with no extra download/install sequence required. Version 2.51 introduces a built-in Lua scripting engine that integrates a basic API for handling user tool input and output processing. Every copy of NoteWorthy Composer 2.51 includes two new user tools, found in the new .Automatic section of the User Tools command::

  1. Show Note Names.lua
    This returns a list of note names for the current selection. This is primarily intended as a demonstration of the Lua scripting engine.
  2. Retrograde.lua
    Like the PHP based user tool kit before it, this was the first Lua based user tool while version 2.51 was in development. It will reverse the notes in a selection, which can sometimes be inspiring when working with a composition.

There are several online resources that can help with getting started with your own Lua scripts:

  • The new API available from within a Lua based user tool is currently documented online at: lua.noteworthycomposer.com.
  • Much of the NWC Lua API is actually written in Lua. It can be explored from our gist on github.