beta
cables is under heavy development.
There might be one or another bug, please let us know about it!
cables DocumentationHow To UseWorking with filesKeyboard ShortcutsUser Interface WalkthroughBeginner TutorialBeginner 1: Drawing A CircleBeginner 2: TransformationsBeginner 3: ColorMore TransformationsintermediateImage CompositionsPost-Processing 3D Scenescommunicationcables APICommunication with an Arduino via SerialCommunicating with Arduino over MQTTExporting And EmbeddingHow to serve files externally and fix CORS headersEmbedding PatchesExternal triggers / functionsEmbedding PatchesPreviewing / uploading exported cables patchescoding opsCreating AttachmentsGeneral op/Port CallbacksPortsDynamic PortsArray PortsBoolean portsInteger Number PortsObject PortsString portsTrigger PortsFloating Point Number PortsGUI/UI attributesHello Op - Part 1LibrariesDeveloping OpsGuidelinesObject PortsWriting ShadersWeb Audio Op DevelopmentHTML and CSS in cablesLightingLightsShadowsWorking with audioBasic Audio SetupWorking with EffectsReal-Time Audio Analyzation & Audio VisualizationOffline Audio Visualization & AnalyzationFAQEmbeddingHow to integrate my cables patch into my CMS (webflow/wix/squarespace/...)?How to remove grey rectangles on touch (mobile)?Why doesn't the DownloadTexture op work on iOS?How to disable page scrolling on mobile?Mobile tippsTransparent CanvasFeatures and SupportWill there be support for (animated) GIFs?Hot to report a bug in cablesGeneral questionsLicences and paymentWhat licence do i need to use cables?Will I have to pay for it in the future?How is my work licenced when using cables?Does cables support midi and OSC?ShadertoyTechnical questionsUI / EditorGuide to VR in cablesWebGL1 and WebGL2

Hot to report a bug in cables

As cables is in constant development, there will be bugs here and there. Maybe things are unclear, not properly
documented or just not as you are used to from other backgrounds.

Please provide us with enough information to investigate your issue. This is a small guide on how to do that:

Where to report bugs?

Please keep all bugreports to the forum and make sure the same
or a similar bug has not been posted before.

What information to include in my post to the forum?

A simple step by step explanation that is reproducible

Please include a simple explanation that is showing your issue as isolated as possible.

Bad: While working on my clientproject for 24h straight somewhere in the last few hours something broke!

Good: Connecting a Cube to MainLoop causes by Nintendo DS browser to crash for an exported patch.

A small and simple example patch

As we understand you are not always able to share your patches with us or the community, please try
to isolate the problem as good as possible and provide a simple example patch that displays what
is going wrong. If you make that patch public, maybe someone else on the forum has an idea.

A screenshot of your browsers dev-console

For most browsers you can open the dev-console by rightclicking anywhere on the page, selecting "inspect element"
and then switching to the console tab. Please provide a screenshot of the last few lines that appeared here
before the error encountered.

This is a bit harder to do on a mobile-phone, but if you are used to remote-debugging android/ios-devices
a glimpse into your dev-console would help here also.

Description of your environment

Which browser are you using? Which operating system? Is the patch exported or running on cables (in the editor)?
Are you encountering this on a mobile phone? Is your patch integrated into some kind of CMS (i.e. Wordpress)?
Is your connection to the internet slow? Maybe include the link provided on cables.gl/browser.

Okay, did that, and now?

Please give us some time to investigate on your issue. The more information you provide in public, the more likely
it is that someone on the forums might pick up on your issue. We are trying to be responsive, though.

Found a bug, developers said it is definitely a bug, now?

You'll most likely have to wait for the next release to use the bugfix...sorry...sometimes we provide possible
workarounds for the time until the next release.

I have code that fixes the issue!

Awesome! Share in your post on the forum and we'll take a look at it. Thanks for contributing!


help cables get better and edit this file on github