When you make a bug report, please:

  • Review existing bug reports and contribute more information to them
  • Provide precise steps that enable Team Vuo to reproduce the problem on the latest version of Vuo
  • Reduce the complexity of your composition and steps to reproduce the problem
    • Provide the simplest possible composition and steps that cause the problem to happen
    • If possible, remove custom nodes from your composition
  • Attach a crash report or process sample to the bug report
    • In the top of the crash report window, there’s a file icon. You can drag this icon to your desktop, to save it in order to attach to your bug report.
      • If you’ve already closed the crash report window, or if Vuo disappeared without showing a crash report window, you can find crash reports as follows:
        • Open the Console app (in the Applications > Utilities folder)
        • Select either “Crash Reports” or “User Diagnostic Reports” (depending on your macOS version) in the sidebar
        • Find the crash report for the Vuo editor or VuoCompositionLoader that matches the date and time the crash occurred
        • Drag it into the bug report
    • If the Vuo editor or your composition hangs:
      • Open Activity Monitor (in the Applications > Utilities folder)
      • Select Vuo or VuoCompositionLoader (it should be red, with the label “Not Responding”)
      • Select “View > Sample Process”
      • In the window that appears, click “Save…”
      • Attach this file to your bug report
  • Attach console logs to the bug report
    • Open the Console app (in the Applications > Utilities folder)
    • Select either “Devices > Your Mac” or “All Messages” (depending on your macOS version), then in the Search field in the top-right, type vuo and press Return, and click “Start streaming”
    • Make the bug happen
    • Edit > Select All, then Edit > Copy
    • Open TextEdit (in the Applications folder), paste the logs, and save
    • Attach that file to the bug report