Cables Standalone Version

cables.gl and cables standalone are mainly developed by undev, with contributions by the cables community and support by various other parties and projects.

In Development

This is the development version of cables.gl packages into a standalone, executable application using electron for mac/windows/linux.

This is under heavy development, things may (and will) break, use it at your own peril. Please provide feedback in the issue tracker attached to this repository.

Download

mac/win/linux: cables standalone

Mac

Download the latest version for mac (m1/m2 or intel macs). Open the .dmg, drag the icon to your applications folder or any other place you want and start it. Acknowledge that this software has been downloaded form the internet (the executable is signed and notarized, though) and start patching!

Win

Download the latest version for windows (portable executable). Unpack the software and run it. You might need to acknowledge that this software is not signed and select "more info" and/or "run anyhow" on the shown dialog. Once that is done, start patching!

Linux

Download the latest version for linux (AppImage). Once you downloaded the package, set its permissions to executable via your file-manager or using the terminal (chmod +x ...AppImage). Open the AppImage and start patching!

Builds

release version:

dev version:

nightly builds:

About

Cables Standalone uses Electron to bring the cables editor and ops to your desktop. For this it uses Electron to keep up to date with the features in the browser version. As your browser is "sandboxed" different security measures apply, this is no longer the case in the standalone version. This is intentional and gives great power, but also some responsibility is now shifted to the user-site. Read about some of the implication on the Electron site.

IMPORTANT:

The current electron settings, as of now, are almost exactly the opposite that electron suggests. This might change for later versions, or be configurable. But a lot of these suggestions only make sense for "static" apps that do not run or execute external code, this - on the other hand - is THE main reason we do this. For now: KNOW THE PEOPLE YOU GET YOUR OPS OR PATCHES FROM!

this.editorWindow = new BrowserWindow({
    "width": 1920,
    "height": 1080,
    "webPreferences": {
        "nodeIntegration": true,
        "nodeIntegrationInWorker": true,
        "nodeIntegrationInSubFrames": true,
        "contextIsolation": false,
        "sandbox": false,
        "webSecurity": false,
        "allowRunningInsecureContent": true,
        "plugins": true,
        "experimentalFeatures": true,
        "v8CacheOptions": "none"
    }
});

Giving Feedback

Issue Workflow

create an issue, pick "Bug report" or "Feature Request" from the templates
the issue will be assigned a "new" label
we will check on these issues regularly, add them to a milestone and remove the "new" label
once we added the feature or fixed the bug in any release (also dev/nightly) we will close the issue
stable releases will have a changelog with all the closed issues

Development

Set up local environment

the preferred way of developing cables locally is using the cables_dev repository: https://github.com/cables-gl/cables_dev
that repo contains scripts that will set up everything for you to get started
Read up about setting up everything for you to start contributing to cables in the section on "Developing Cables" of the official cables documentation.

Appreciation

Thanks to the cables community and our supporters for making this possible. If you like this project, think about supporting it on patreon.

This project was partly funded through the NGI0 Entrust Fund, a fund established by NLnet with financial support from the European Commission's Next Generation Internet programme, under the aegis of DG Communications Networks, Content and Technology under grant agreement No 101069594.

cables-gl / cables_electron

readme