Docs / 04
Troubleshooting
The plugin doesn’t appear in the Import list
The console only scans the exact library path. Check, character for character:
<usb>/grandMA3/gma3_library/datapools/plugins/
Common misses: grandMA3 folder missing at the root of the stick, plugin
instead of plugins, or the .lua/.xml pair split across folders. Both
files must sit in the same directory.
Import succeeds but the pool button does nothing
- Check the System Monitor window (Add Window → More → System Monitor) — Lua errors are printed there with a line number.
- On software older than v2.0 the plugin will refuse to run and print
cueprint: requires grandMA3 2.0+. Update the console or use an older plugin release from your download page. - If you renamed the pool object, the settings key changes too; re-run once and re-save your column preset.
No CSV file on the stick
- The console writes to
cueprint_out/inside the plugins folder — it’s created on first export, one level deeper than people usually look. - USB sticks must be FAT32/exFAT formatted; NTFS mounts read-only on the console.
- Exports of empty sequences are skipped by design, with a message in the command line feedback.
Columns look wrong in Excel
- Everything in one column — your Excel locale expects
;separators. Use Data → From Text/CSV and set the delimiter to comma, or setsep=,as the first line via the Pro column picker’s “Excel locale hint” toggle. - Cue
4.10displays as4.1— format thecuecolumn as text, or import instead of double-clicking the file. The CSV itself is correct. - Garbled characters — choose UTF-8 in the import dialog; the file is UTF-8 without BOM.
MA2: import menu doesn’t list the plugin
MA2 plugins live in a different folder than MA3: <usb>/gma2/plugins/. Also
confirm you copied cueprint_ma2.xml (the MA3 files are ignored by MA2), and
that you’re on v3.9 or newer.
Still stuck?
Email the address on your receipt with:
- Console model and software version,
- Your license key,
- The System Monitor output if there’s a red line.
Pro licenses get priority turnaround, but nobody waits long.