    FaustLive
    ============================
    ## The swiss knife for [Faust](https://faust.grame.fr) development.
    --------------

    master : [![Build Status](https://travis-ci.org/grame-cncm/faustlive.svg?branch=master)](https://travis-ci.org/grame-cncm/faustlive)
    dev : [![Build Status](https://travis-ci.org/grame-cncm/faustlive.svg?branch=dev)](https://travis-ci.org/grame-cncm/faustlive)

    FaustLive is an advanced self-contained prototyping environment for the Faust programming language with an ultra-short edit-compile-run cycle. Thanks to its fully embedded compilation chain, FaustLive is simple to install and doesn't require any external compiler, development toolchain or SDK to run.

    FaustLive is the ideal tool for fast prototyping. Faust programs can be compiled and run on the fly by simple drag and drop. They can even be edited and recompiled while running, without sound interruption.
    It supports also native applications generation using the [Faust online compiler](https://faust.grame.fr/tools/onlinecompiler/).

    FaustLive is based on the [Faust](https://faust.grame.fr) library and on [LLVM](http://llvm.org).

    ## Libraries

    Faust libraries are now in a [separated subproject](https://github.com/grame-cncm/faustlibraries). They are synchronized from time to time in the main FaustLive repository using the following commands:

        git submodule update --remote --merge
        git add Resources/Libs
        git commit -m "Updating libraries"
        git push

    ### Limitations and known bugs

     - crashes on Windows when compiling a dsp with input signals, on a machine without input audio device
     - may crash on startup due to incorrect cache. In this case, find the `FaustLive-CurrentSession-2.XX` folder in your home folder, remove it and restart. On Unix like stations (Linux, MacOS), this folder is hidden and located at `$HOME/.FaustLive-CurrentSession-2.XX`

    ## Building

    ### Versionning

    - use the *version* script to raise the version number, like `./version 2.5.8`.
    - manually raise the `APP_VERSION` flag in Build/CMakeLists.txt (line 213)

    ### Application building

    To build the FaustLive project, go to the `Build` folder and start with the README file.

    <!--p align="center">
      <img width="70" src="./Resources/FaustLiveIcon.png"> <br />
      <img width="100" src="./Resources/faust.png">
    </p-->

    --------------
    #### [Grame](http://www.grame.fr) - Centre National de Creation Musicale
    <br /><br />
    ###Change log

    ----------------------------------------------------
    19/09/20234: version 2.5.19

    - integrates Faust compiler version 2.75.7
    - based on LLVM 16.0.6 on macOS and 17.0.6 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    31/03/20234: version 2.5.18

    - integrates Faust compiler version 2.72.13
    - based on LLVM 15.0.7 on macOS and 16.0.6 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    05/01/20234: version 2.5.17

    - integrates Faust compiler version 2.70.3
    - based on LLVM 15.0.7 on macOS and 16.0.6 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    10/07/2023: version 2.5.16

    - integrates Faust compiler version 2.61.1
    - based on LLVM 15.0.7 on macOS and 16.0.6 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    05/09/2023: version 2.5.15

    - restore the parameters between successive compilations
    - integrates Faust compiler version 2.59.5
    - based on LLVM 15.0.7 on and OS X and Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    03/27/2023: version 2.5.14

    - integrates Faust compiler version 2.58.11
    - based on LLVM 15.0.7 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    12/17/2022: version 2.5.13

    - integrates Faust compiler version 2.54.9
    - based on LLVM 14.0.6 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    09/28/2022: version 2.5.12

    - integrates Faust compiler version 2.50.5
    - based on LLVM 14.0.6 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    06/27/2022: version 2.5.11

    - integrates Faust compiler version 2.41.1
    - based on LLVM 14.0.5 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    04/25/2022: version 2.5.10

    - integrates Faust compiler version 2.40.5, solving an incorrect optimisation bug
    - based on LLVM 14.0.1 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    04/23/2022: version 2.5.9

    - integrates Faust compiler version 2.40.4, solving an issue when exporting code
    - based on LLVM 14.0.1 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    03/22/2022: version 2.5.8

    - integrates Faust compiler version 2.40.0
    - based on LLVM 13.0.1 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    10/21/2021: version 2.5.7

    - correct FaustLive-CurrentSession folder versioning to raise it for each release.
    - integrates Faust compiler version 2.37.2
    - based on LLVM 12.0.0 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    ----------------------------------------------------
    05/03/2021: version 2.5.6

    - support for -double option
    - integrates Faust compiler version 2.33.1
    - based on LLVM 12.0.0 on and OS X and 10.0.0 on Windows
    - latest version of the Faust libraries

    Known issues:

     - Http control (using the 'Window/View QRCode' menu item) is sometimes buggy
     - DSPs using the 'soundfile' primitive cannot be exported on the remote compilation service

    ----------------------------------------------------
    01/05/2021: version 2.5.5

    - integrates Faust compiler version 2.30.5
    - based on LLVM 10.0.0 on Windows and OS X
    - latest version of the Faust libraries

    Known issues:

     - Http control (using the 'Window/View QRCode' menu item) is sometimes buggy
     - DSPs using the 'soundfile' primitive cannot be exported on the remote compilation service

    ----------------------------------------------------
    10/10/2019: version 2.5.4

    - integrates Faust compiler version 2.27.1
    - based on LLVM 10.0.0 on Windows and OS X
    - latest version of the Faust libraries

    Known issues:

     - Http control (using the 'Window/View QRCode' menu item) is sometimes buggy
     - DSPs using the 'soundfile' primitive cannot be exported on the remote compilation service

    ----------------------------------------------------
    10/10/2019: version 2.5.3

    - integrates Faust compiler version 2.19.1
    - based on LLVM 9.0.0 on Windows and OS X
    - on OS X, the binary works starting from OS 10.12
    - latest version of the Faust libraries

    Known issues:

     - Http control (using the 'Window/View QRCode' menu item) is sometimes buggy
     - DSPs using the 'soundfile' primitive cannot be exported on the remote compilation service

    ----------------------------------------------------
    12/03/2019: version 2.5.2

    - integrates Faust compiler version 2.15.11
    - based on LLVM 7.0.0
    - on OS X, the binary works (again) starting from OS 10.11 (El Capitan)

    Known issues:

     - Http control (using the 'Window/View QRCode' menu item) is sometimes buggy
     - DSPs using the 'soundfile' primitive cannot be exported on the remote compilation service

    ----------------------------------------------------
    05/03/2019: version 2.5.1

    - integrates Faust compiler version 2.15.10
    - based on LLVM 7.0.0
    - on OS X, the binary works (again) starting from OS 10.11 (El Capitan)

    Known issues:

     - Http control (using the 'Window/View QRCode' menu item) is sometimes buggy
     - DSPs using the 'soundfile' primitive cannot be exported on the remote compilation service

    ----------------------------------------------------
    31/01/2019: version 2.5.0

     - improves session restoration
     - integrates Faust compiler version 2.14.4
     - based on LLVM 7.0.0