qsys-mac
v0.1.6
Published
npm bootstrapper for the signed Q-SYS Mac Installer DMG.
Downloads
817
Maintainers
Readme
qsys-mac
qsys-mac is an npm bootstrapper for the signed, notarized Q-SYS Mac
Installer DMG. The npm package does not contain Q-SYS Designer, Wine, .NET,
or the macOS app payload; it downloads the GitHub Release DMG, verifies its
SHA-256 checksum, mounts it, and delegates to the bundled qsys-mac helper.
The current bootstrapper pins
qsys-mac-installer 0.1.6
with SHA-256 a33d0fccd2aaf87a24bdbd69318659a8366ce95f59155c74747b1d9ba64ea52e.
You still provide your own Q-SYS Designer Windows installer from QSC.
npx qsys-mac install "/path/to/Q-SYS Designer Installer 10.4.0.exe"Other commands delegate to the same helper in the DMG:
npx qsys-mac status
npx qsys-mac doctor
npx qsys-mac removedoctor prints read-only support diagnostics: Rosetta state, installed app/data state, bundled
helper presence, signatures where practical, running status, and log paths. It does not repair,
provision, remove, or upload anything.
Requirements
- macOS on Apple Silicon.
- Node.js 18.17 or newer.
- Rosetta 2:
softwareupdate --install-rosetta --agree-to-license. - Your own
Q-SYS Designer Installer X.exe, downloaded from qsys.com.
The signed installer DMG bundles Wine, .NET, 7z, icon tooling, msiinfo, and
native helper binaries. Normal setup does not need Homebrew or host Python.
Homebrew Alternative
Homebrew can install the GUI installer app:
brew tap reowens/qsys
brew trust reowens/qsys
brew install --cask qsys-mac-installer
open -a "Q-SYS Mac Installer"brew trust is required by current Homebrew for third-party cask taps.
Cache
The DMG is cached at:
~/Library/Caches/qsys-mac/qsys-mac-installer-0.1.6.dmgIf the cached file is missing or does not match the pinned SHA-256 checksum,
qsys-mac downloads it again before mounting.
Local DMG
For release testing, point the bootstrapper at a locally built DMG:
npx qsys-mac --dmg packages/qsys-mac-installer/dist/qsys-mac-installer.dmg statusLocal DMG overrides are not checksum-verified.
Source Checkout
Inside the qsys-tools monorepo, use the workspace script instead of npx
qsys-mac; otherwise the local workspace package may resolve before the
published one:
pnpm run qsys-mac -- status
pnpm run qsys-mac -- doctor
pnpm run qsys-mac -- --dmg packages/qsys-mac-installer/dist/qsys-mac-installer.dmg status