The goal of this project is to develop a Web API for the Faust compiler allowing to do remote compilations.
In order to compile FaustWeb links against the following libraries:
- libarchive (sudo apt-get install libarchive-dev)
- boost (sudo apt-get install libboost-filesystem-dev libboost-program-options-dev)
- libcrypto (sudo apt-get install libcrypto++-dev)
- libmicrohttpd (sudo apt-get install libmicrohttpd-dev)
- libssl (sudo apt-get install libssl-dev)
Make sure to download the current development trunk of all these libraries and install. Then, the standard:
- make
- sudo make install
- ./faustweb starts FaustWeb on port 8888
From a browser at URL http://localhost:8888/
Select a file kisana.dsp and send it. The sent file can be a either a .dsp or an .zip archive containing a .dsp and .lib files. Next use the returned for example cf55531c580cc7d3485a5161259f0571d3e6bdef
Session-level endpoints:
- http://localhost:8888/<key>/generated.cpp returns the generated C++ source code from Faust compilation
- http://localhost:8888/<key>/errors.log returns compilation errors log (empty if no errors)
- http://localhost:8888/<key>/svg.zip returns a ZIP archive containing all SVG block diagrams
- http://localhost:8888/<key>/svg/<filename>.svg returns individual SVG block diagram files
- http://localhost:8888/<key>/filename returns the original uploaded filename
- http://localhost:8888/<key>/diagram/<filename>.svg returns SVG diagrams (alias for svg/ endpoint)
- http://localhost:8888/<key>/<platform>/<architecture>/binary.zip returns compiled binary archive
- http://localhost:8888/<key>/<platform>/<architecture>/binary.apk returns Android APK package
- http://localhost:8888/<key>/<platform>/<architecture>/installer.sh returns installation script
- http://localhost:8888/<key>/<platform>/<architecture>/precompile triggers compilation without download (returns location header)
- http://localhost:8888/<key>/<platform>/<architecture>/web/pwa/* serves Progressive Web App files
- http://localhost:8888/<key>/<platform>/<architecture>/web/pwa-poly/* serves PWA files with polyfills
For OSX :
osx/coreaudio-qt
osx/coreaudio-qt-midi
osx/csound
osx/jack-qt
osx/max
osx/plot
osx/puredata
osx/puredata-poly
osx/supercollider
osx/vst
osx/vsti
The local service run on the http://localhost:8888/ URL, and can be tested like in the following examples:
List available targets: curl http://localhost:8888/targets
Upload and get session key: curl -F'file=@"clarinet.dsp";filename="clarinet.dsp"' http://localhost:8888/filepost # Returns SHA key: 5ADBDAF2AFFF8387F4FCB9F05BA84E374DE3ABAF
Access session-level resources: curl http://localhost:8888/5ADBDAF2AFFF8387F4FCB9F05BA84E374DE3ABAF/generated.cpp curl http://localhost:8888/5ADBDAF2AFFF8387F4FCB9F05BA84E374DE3ABAF/errors.log curl http://localhost:8888/5ADBDAF2AFFF8387F4FCB9F05BA84E374DE3ABAF/svg.zip --output diagrams.zip
Compile for specific platform/architecture: curl http://localhost:8888/5ADBDAF2AFFF8387F4FCB9F05BA84E374DE3ABAF/android/android/binary.apk --output binary.apk
Compile and download in a single command:
curl -F'file=@"clarinet.dsp";filename="clarinet.dsp"' http://localhost:8888/compile/android/android/binary.apk --output clarinet.apk
curl -F'file=@"kisana.dsp";filename="kisana.dsp"' http://localhost:8888/compile/web/pwa/binary.zip --output kisana.zip
curl http://35.229.105.70/faustservice/targets
curl -F'file=@"clarinet.dsp";filename="clarinet.dsp"' http://35.229.105.70/faustservice/compile/android/android/binary.apk --output binary3.apk
curl http://35.229.105.70/faustservice/5ADBDAF2AFFF8387F4FCB9F05BA84E374DE3ABAF/android/android/binary.apk --output binary3.apk
journalctl -f /home/orlarey/FaustInstall/faustservice/faustweb
sudo systemctl restart faustweb
sudo systemctl restart apache2
curl http://35.190.180.34/targets
curl http://104.196.34.150/targets
curl localhost:8888/targets
curl -F'file=@"kisana.dsp";filename="kisana.dsp"' localhost:8888/filepost
curl -F'file=@"kisana.dsp";filename="kisana.dsp"' localhost:8888/compile/android/android/binary.apk --output kisana.apk
The remote compilation service run on the http://faustservice.grame.fr URL, and can be used like in the following examples:
curl http://faustservice.grame.fr/targets
curl -F'file=@"kisana.dsp";filename="kisana.dsp"' http://faustservice.grame.fr/filepost
curl -F'file=@"kisana.dsp";filename="kisana.dsp"' http://faustservice.grame.fr/compile/soul/soul/binary.zip --output kisana.zip