Savvy Sequencer User Guide PDF  | Print |

Savvy Sequencer

version 1.0.0

Users Guide


Created by Joshua Benghiat

Joshua Benghiat Lighting Design



Requirements | Installation | Support

Getting Started

Adding to your Workspace | RegistrationOverview

In Detail

Savvy Sequencer dialog




Vectorworks 2012 or higher



If you haven't already, download the Savvy Sequencer Installer from the JBLD downloads page . There are links to download for 2012/2013 or 2014/2015.


For installation to Vectorworks 2012 or 2013:

Make sure Vectorworks is not running.  Run the Savvy Sequencer Installer.  Select your version of Vectorworks. The installer will install a folder called "-JBLD Savvy Sequencer" in your user Plug-Ins folder, containing the Savvy Sequencer menu command.


The Windows installer allows you to select a custom location for your Plug-Ins folder.  Mac users with a custom user data location or Windows users having trouble with the installer can download the "Raw installer" and manually drag the "-JBLD Position Pipes" folder to Plug-Ins.  For more information, see this FAQ .

For installation to Vectorworks 2014 or 2015:

  1. The installer package must remain a zip file.  If your system automatically unzips archives, right-click on the download link and select "Save Link As" to prevent your browser from auto-expanding the download.
  2. In Vectorworks, select Tools > Plug-ins > Plug-in Manager
  3. Select the Third-party plug-ins page
  4. Click the Install... button
  5. Navigate to and select the saved installer zip file
  6. Read and confirm the EULA
  7. Vectorworks should notify you that installation is complete and to restart Vectorworks

If you experience trouble with the install script, please see the following FAQ on where plug-ins install .



Please visit  for support options and to report bugs.  


You may also email software(at)


  Getting Started

To use the Savvy Sequencer command, you must add it to your Workspace.


  Adding to your Workspace

To add Savvy Sequencer to an existing workspace:  

  1. Select Tools>Workspaces>Workspace Editor or Edit Current Workspace... .
  2. In the Menus  tab, click the disclosure triangle next to  JBLD in the list of Menu categories on the left hand side.
  3. Drag Savvy Sequencer to an existing menu on the right, for example, Tools.
  4. Click OK .

SQ Add-to-workspace.png



The first time you use Savvy Position Sequencer, you will be asked for a registration number or demo code.  You can also access the registration dialog through the " About " button at the bottom-left of the Sequencer Dialog.



The Savvy Sequencer will add sequential text labels or data entries to selected objects, based on their screen arrangement. The Sequencer will work with existing text objects or create new ones, look inside groups for text, and apply date to either attached record or plug-in parameter fields. Sequences can be numeric or alphabetic, start at any point, have any increment, and include leading or trailing text. The sort order can be as a linear or rectangular array or traverse objects in a circle.


For a list of key features and screenshots, visit the  Savvy Sequencer product page .


  In Detail

SQ Dialog

Dialog Options

Option Description

How to number

First, determine how you want to sequence the selected objects. You can label objects with text or enter data in record fields or plug-in parameters.

Text object Choose this option sequence with text labels. Choose this option to use existing text objects, to add new text selected objects, or to search for text within a group.
In class: Select a class to only number text of a certiain class. This can be useful to number specific text blocks within a group. This will also be the class for new text objects.
You can also choose Any Class or to use the Active Class.
Look in groups (shallow, first found text block) Select this option to look for text objects within groups. The command will only number the first found text object in each geoup of the selected class.
Add new Select this option to add text to other types objects. If a text object in the specified class is already found, the Sequencer will not create a new object.
Group text with numbered object Select this option to create a group containing the object to number and the text object.
Data Choose this option to insert the sequence text into a field or parameter.
Record: Choose a record.
Field: Choose a field in which to insert the sequence text.


Choose options for how the sequence should increment.

Incremental Character Choose to sequence by letter or number.
Number Sequence with numerals.
Letter Sequence with letters.
Starting number: The number of the first item.
Starting letter: The letter of the first item.
Increment by: The counter will incement by this number.


Choose additional text to prepend or append to the counter.

Leader: Text to prepend to the counter.
Trailer: Text to append to the counter.
Example An example of your formatted label.

Sort Order

Choose how to sort the selected objects.

Type Choose how to sort the selected objects.


Sort objects in a rectangular (or linnear) array. You can specify a primary sort and a secondary sort.

Rectangular sort options 
Primary sort Choose a primary sort direction. See the array below as an aid.
Secondary Sort Choose a secondary sort direction. See the array below as an aid.

Specify how closely two objects' coordinates can be for the sequencer to consider them aligned.

The following example has a primary sort of bottom to top and a secondary sort of left to right.  The top example had a tolerance of 0, while the bottom example uses a tolerance for the bottom row of numbers to be sequenced together.

Tolerance Example


Sort objects in a circle.

Polar sort options 
Direction: Choose to sort objects in a clockwise or counterclockwise direction.
Clockwise / Counterclockwise Choose to sort objects in a clockwise or counterclockwise direction.
Center x and Y: Specify the coordinates for the center about which to sort.
Begin From: Specify the origin of ther sort in degrees. 0° is to the right, or 3:00.
Next Mouse Clicks Choose the Polor Sort's center and start by clicking in the drawing after exitig the dialog.
Last Updated on Tuesday, 18 April 2017 13:11
  Home > Vectorworks > Support > User Guides > Savvy Sequencer User Guide