beta
cables is under heavy development.
There might be one or another bug, please let us know about it!
cables Documentation      How To Use            Working with files            Keyboard Shortcuts            User Interface Walkthrough      Beginner Tutorial            Beginner 1: Drawing A Circle            Beginner 2: Transformations            Beginner 3: Color            More Transformations      intermediate            Image Compositions            Post-Processing 3D Scenes      communication            cables API            Communication with an Arduino via Serial            Communicating with Arduino over MQTT      Exporting And Embedding            How to serve files externally and fix CORS headers            Embedding Patches            External triggers / functions            Embedding Patches            Previewing / uploading exported cables patches      coding ops            Creating Attachments            General op/Port Callbacks            Ports                  Dynamic Ports                  Array Ports                  Boolean ports                  Integer Number Ports                  Object Ports                  String ports                  Trigger Ports                  Floating Point Number Ports            GUI/UI attributes            Hello Op - Part 1            Libraries            Developing Ops            Guidelines            Object Ports            Writing Shaders            Web Audio Op Development      HTML and CSS in cables      Lighting            Lights            Shadows      FAQ            Embedding                  How to remove grey rectangles on touch (mobile)?                  Why doesn't the DownloadTexture op work on iOS?                  How to disable page scrolling on mobile?                  Transparent Canvas            Features and Support                  Will there be support for (animated) GIFs?            General questions            Licences and payment                  What 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?            Shadertoy            Technical questions            UI / Editor            WebGL1 and WebGL2

User Interface Walkthrough

cables has a lot of small helpers which make working with cables as easy and fast as possible. In this chapter you will get to know the most important keyboard shortcuts, elements and mouse actions.

To add an op press the Esc-key. In the popup you can now enter any text which is part of the op’s namespace (e.g. MainLoop). You can now navigate through the result-set using your arrow keys ( and ).

When you press Enter the selected op will be added to the editor.

alt text


To add another op and connect it to the one we just added you can now drag out a cable from one of the ports.

alt text


To add an op in between two ops just press the circle in the middle of the cable (one of the existing ops must be highlighted for this).

alt text


To change one of the op-parameters first select the op by clicking on it, then you will see the the op-settings in the pane on the right. To change one of the number value inputs click and drag up or down.

alt text


To access an op’s example patch first select the op, then click view example patches.

alt text


To delete a cable just press the right mouse button on one of the connected ports.

alt text


To reconnect a cable to another port press and drag with the right mouse button.

alt text


Ops can be duplicated by making a selection with your left mouse button, pressing cmd + c or ctrl + c to copy, followed by cmd + v or ctrl + v to paste.

alt text


To bring some order into your patch you can align ops by making a selection with your left mouse button and pressing a to horizontally align or shift + a to vertically align.

alt text


To unlink an op hold it with the left mouse button and shake it.

alt text


You can also unlink ops by selecting them and pressing x

alt text


Drag a cable to the center of an op to see suggestions of fitting ports. if there is only one the link will be connected automatically.

alt text


To add an existing op between two other ops, click and drag it to the middle of the cable and release.

alt text


Duplicate a link by pressing alt and the right-mouse button and dragging the cable to another port

alt text


See data and function flow by pressing f

alt text


Disable ops and its children by pressing d

alt text


Temporarily disconnect/bypass a selected op by pressing shift+d, pressing shift+d again reconnects the cable

alt text


Upload files by dragging them into the window

alt text


access the command palette by pressing CMD+P or CTRL+P.

alt text


set a custom title to an op by clicking the title in the parameter panel (you can also select an op and press t)

alt text


organize huge patches by putting ops into subpatches

alt text


to find documentation and examples for an op, click on the op and then click the link

alt text


set colors for ops for easier identification

alt text

create and link new op by clicking parameter

alt text

use snap to grid for cleaner looking patches

alt text


help cables get better and edit this file on github