scoreko-electron-dev/docs/troubleshooting.md

Troubleshooting

NodeCG folder does not exist

• Verify lib/nodecg exists.
• Make sure the project contains a full NodeCG installation.

No read/write permissions on NodeCG

• Adjust permissions on lib/nodecg for the user running Electron.
• On Linux/macOS: chmod -R u+rw lib/nodecg (according to your local policy).

Port <PORT> is already in use

• Free the port or set NODECG_PORT in .env.
• Use npm run doctor to validate availability before startup.

Timeout while waiting for NodeCG

• Check NodeCG logs in standard output.
• Increase NODECG_STARTUP_TIMEOUT_MS if the environment is slow.
• Verify NodeCG dependencies (cd lib/nodecg && npm install).

macOS build fails because of icon

• The configuration expects static/icons/icon.icns.
• Create that file before running macOS packaging.