Pretty lighting paperwork generation from Vectorworks to PDF or Excel!
Using a Vectorworks Spotlight Data Exchange XML file or a Vectorworks lighting export, this program will generate a channel hookup, instrument schedule, color cut list, and gobo pull list. This can either be exported as a PDF, HTML file, or Excel spreadsheet, all of which are neatly formatted for your viewing and printing convenience.
Using pipx: pipx install lighting-paperwork
Using uv: uvx lighting-paperwork
lighting-paperwork needs a source of data from Vectorworks.
There are currently two options to generate this:
- (preferred) Enable Vectorworks Data Exchange in Spotlight > Spotlight Settings > Spotlight Preferences > Lightwright and check "Use automatic Lightwright data exchange" and "Perform a full export to Lightwright when dialog box closes". Additionally, move all "Available Fields" over to "Export Fields". This will create a
[filename].xmlfile in the same directory as your Vectorworks file- This only needs to be performed once, the
.xmlfile will stay updated to the Vectorworks file - Lightwright cannot run in the same directory or else it will consume the
.xmlfile. To fix, run another full export while Lightwright is not running
- This only needs to be performed once, the
- Manual export in File > Export > Lighting Device Data. Select all entries, leave "Export field names as first record" checked, and export to a
.csvfile.- Accessories will not export using this method
To generate paperwork, run lighting-paperwork my-show.xml to generate a PDF.
To add show customization and change the export type, use lighting-paperwork -h
Much of what this program does is fairly opinionated to my own use case and my sense of what looks nice on paperwork.
That said, there are some customization options available through the paperwork.yaml configuration file. (to be implemented)
If you want to customize the paperwork in a way that hasn't been exposed yet, please file a bug report and we'll see what can be done.
This is a tool that I developed for myself, for my shows, which means I can only confirm that it has worked for this somewhat limited dataset. As such, please don't rely on this as your primary paperwork generation method, and be sure to verify its outputs against your plot. I use it, I'm happy with it, but I'm not a professional lighting designer and I haven't run into every situation possible -- this program could get confused with new numbering schemes, break on the latest version of Vectorworks, or just not like the instruments that you're using. If you need something reliable, trusted, and industry-standard, go buy a copy of Lightwright instead.
Found an issue or want an additional feature? Please submit a issue (or even better, a PR)!