ssl2-tools

Decrypt and encrypt Nicolaudie SSL2 fixture library files.

SSL2 is the encrypted fixture profile format used by ESA Pro 2, Daslight, Sunlite Suite, and myDMX. The files contain XML fixture definitions encrypted with the AraCrypt stream cipher.

The Nicolaudie fixture store hosts thousands of these files.

Install

npm install -g ssl2-tools

Or use without installing:

npx ssl2-tools decrypt fixture.ssl2

CLI Usage

# Decrypt SSL2 to XML
ssl2 decrypt fixture.ssl2
ssl2 decrypt fixture.ssl2 output.xml

# Encrypt XML back to SSL2
ssl2 encrypt fixture.xml
ssl2 encrypt fixture.xml output.ssl2

# Print decrypted XML to stdout
ssl2 dump fixture.ssl2
ssl2 dump fixture.ssl2 | xmllint --format -

API

import { decrypt, encrypt } from 'ssl2-tools'
import { readFileSync, writeFileSync } from 'fs'

const ssl2 = readFileSync('fixture.ssl2')
const xml = decrypt(ssl2)
console.log(xml.toString('utf-8'))

const reEncrypted = encrypt(xml)
writeFileSync('fixture-copy.ssl2', reEncrypted)

SSL2 XML Format

Decrypted files contain XML with this structure:

<?xml version="1.0" encoding="UTF-8"?>
<DLMFILE VERSION="3" TYPE="SSLLIBRARY">
  <SSLLIBRARY SSLNAME="Fixture Name" ...>
    <SSLPROPERTIES SSLBRAND="Brand" ... />
    <SSLMODES SSLNBMODE="1">
      <SSLMODE SSLMODENAME="Mode Name" SSLNBCHANNEL="6">
        <SSLCHANNEL SSLCHANNELTYPE="25" SSLCHANNELNAME="Red" ...>
          <SSLPRESETS ...>
            <SSLPRESET SSLPRESETNAME="Red" SSLPRESETDMXSTART="0" SSLPRESETDMXEND="255" ... />
          </SSLPRESETS>
        </SSLCHANNEL>
        <!-- more channels -->
      </SSLMODE>
    </SSLMODES>
  </SSLLIBRARY>
</DLMFILE>

Channel Types

| Type | Name | |------|------| | 0 | Generic | | 7 | Dimmer | | 14 | Zoom | | 15 | Shutter / Strobe | | 18 | Speed | | 23 | Color Temperature | | 25 | Red | | 26 | Green | | 27 | Blue | | 31 | White | | 37 | Auto Programs | | 43 | Warm White | | 44 | Cold White | | 45 | Amber | | 46 | UV | | 48 | Lime |

Credits

Encryption was reverse-engineered by @HakanL — see open-fixture-library#99.

License

MIT