cables daplaya

THIS REPOSITORY IS NO LONGER MAINTAINED: check cables standalone or the cables exe export for alternatives!

a simple offline player for cables patches using the electron framework.

can be used on different platforms (win, osx, linux) to use cables patches offline after importing them through daplaya.

CAVEATS MAC OS

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 MacOS.
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...
There are ways to make the executable/app work on your mac: on this website . We had success using the command line snippet: sudo xattr -cr appName.app

features:

import your patches by using patchid and apikey
copy whole directory to usb stick and run from there
cables integrations should work as expected (i.e. midi-ops)
runs on windows, osx and linux (all 64 bit architecture)
might be useful to circumvent browser restrictions for external inputs

usage

download the appropriate zip file from the releases page
create an apikey in cables (apikeys) (try to use one per instance)
find the patch you want to export and copy the id from the URL (or the whole url, who cares...)
extract the zipfile somewhere on your computer (i.e. an usb stick)
start daplaya (win: daplaya.exe, osx: daplaya.app, linux: ./daplaya)
you will see a default patch with a cables logo
press ctrl-n to enter apikey and patchid, wait for export
press escape for fullscreen

keyboard commands (also availabe via menu)

alt to toggle the menu
esc to toggle fullscreen
ctrl-n to import a new patch
ctrl-r to synchronize the patch with the version in the cables editor (reimport)
ctrl-o open filebrowser to open patches that you have exported manually from cables

development

building

building requires you have run npm run update or ./update_electron.sh <version> before
npm run cleanto clean up nodemodules and preimported patches and settings
npm run build:linux build linux app in build/linux-x64
npm run build:win build linux app in build/win32-x64
npm run build:osx build linux app in build/darwin-x64
build artefacts are in build/

releases

releases will try to update electron and build all three platforms as well as the corresponding zipfiles
this is usually done by github actions
npm run package

LICENCE

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

cables-gl / cables-daplaya