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 APIExporting and EmbeddingHow to serve files externally and fix CORS headersExporting PatchesExport using the cables command line interfaceExport via IframeExport creating a standalone executableExport to github (pages)Export and deploy to netlifyExport a ZIP fileExternal triggers / functionsUsing variablesPreviewing / uploading exported cables patchesExamples for EmbeddingCoding OpsCreating AttachmentsGeneral op/Port CallbacksPortsDynamic PortsArray PortsBoolean portsInteger Number PortsObject PortsString portsTrigger PortsFloating Point Number PortsGUI/UI attributesHello Op - Part 1LibrariesDeveloping OpsCreating Viz OpsGuidelinesObject PortsWriting ShadersWeb Audio Op DevelopmentHTML and CSS in cablesLightingLightsShadowsWorking with audioBasic Audio SetupWorking with EffectsReal-Time Audio Analyzation & Audio VisualizationOffline Audio Visualization & AnalyzationOptimizing Performance in PatchesTools for debugging your patchHow to optimize cables patches with the Performance opHow to optimize cables patches with the ProfilerCommon pitfalls with the "usual suspects"Optimizing arraysDebugging Shaders with ShaderInfoFAQAudio in web browsersHow to make demos with cables.glEmbeddingHow to integrate my cables patch into my CMS (webflow/wix/squarespace/...)?getting a warning when running the patch in electronHow to remove grey rectangles on touch (mobile)?Why doesn't the DownloadTexture op work on iOS?How to disable page scrolling on mobile?Mobile tippsHow to run exported patches on your local machineTransparent CanvasFeatures and SupportHow to contribute code to cablesWill there be support for (animated) GIFs?Screenshots and Video recordingHow to report a bug in cableshow can I support cables?Video playback in cablesGeneral questionsLicenses and paymentWhat license do i need to use cables?Will I have to pay for it in the future?How is my work licensed when using cables?Does cables support midi and OSC?Patch PermissionsMy User Profile & Social MediaShadertoyTechnical questionsWebGL1 and WebGL2

Export creating a standalone executable

Select the "EXE" option in the export dialog:

Button

This export option allows you to create a standalone executable that will run on windows, linux and mac
natively.

We are using electron for the cross-platform running of cables patches and
we will build the executables on our servers for you to download once ready.

Building executables for OSX is not that easy, so there is a few things to keep in mind (see CAVEATS).

Parameters

Exports can be done by all collaborators added to the patch.

Architecture

Pick any of the available operating systems and cpu architectures you want your export to run on. Please
take a look at the CAVEATS below if you are trying to export to OS X and especially OS X on ARM ("Apple Silicon"/"M1").

WALKTHROUGH

  • enter the above information
  • click on button
  • wait for the download button to appear
  • download executable, can take some time as electron might turn out to be quite big depending on your platform, even with smaller patches

CAVEATS

  • Apple introduced some security features that make it next to impossible to build these kind of apps at the moment, so there is a few caveats when using this on OS X.
  • The executable is not signed, you will need to whitelist it on every machine you run it on (right click, "open" usually does that).
    • We cannot sign this executable, as it's contents do change when downloading a patch, this is intended...sorry...
    • The build for arm/m1-architecture is even harder to run, apple forbids running unsigned apps that are build for arm entirely, not even whitelisting is possible...you may sign it on your own, though.
  • Once you downloaded the app, USE THE FINDER to move it basically anywhere else (like your desktop) before opening it
    • Apple puts downloaded apps into a random read-only directory UNTIL YOU MOVE IT USING FINDER, we need to write to the directory...sorry...

Export Options

You can choose how the contents of your export should look, the defaults should be fine for almost everything.

Include assets

If your patch uses uploaded files (textures, audio, data, ...) choose one of the following options to have
these files included in the export.

Use "All" if you are generating filenames on the fly (iterators, arrays, ...) to make sure all files are available in the Export

  • Automatic: Tries to guess which files are used in the patch and includes only used assets.
  • All: Includes all the assets uploaded to the patch or referenced in there, this is the safe option.
  • None: Does not include any assets in the export, smaller download but some things might not work in the export

Package

  • Single Javascript File: packages and minifies everything into one single javascript file to include
  • Multiple Files: will keep the patch configuration, your code, and core code in seperate files

Skip Backups

  • When deselecting this option, the export will include JSON-files for all the versions of your patch that can be re-imported into cables later.

Export without subdirectories

  • Should you need the directory structure of your patch to be "flat" (no js/ or assets/ subdirectory) you can select this option.
    • This will ususally not be needed, some platforms do not allow for accessing subdirectories tough, and some setups of frameworks like react/vue also behave weirdly with subdirectories.

help cables get better and edit this file on github