Awesome
<p align="center"> <h1 align="center">Kiwi</h1> <p align="center"> A real-time collaborative audio patching software </p> <p align="center"> <a href="https://travis-ci.org/Musicoll/Kiwi"><img src="https://travis-ci.org/Musicoll/Kiwi.svg?branch=master" alt="Travis"></a> <a href="https://ci.appveyor.com/project/CICM/kiwi/history"><img src="https://ci.appveyor.com/api/projects/status/github/Musicoll/Kiwi?branch=master&svg=true" alt="Appveyor CI"></a> </p> <p align="center"> <a href="http://kiwi.mshparisnord.fr/"><img src="https://img.shields.io/badge/@-website-blue.svg" alt="Website"></a> <a href="http://musicoll.github.io/Kiwi"><img src="https://img.shields.io/badge/@-documentation-blue.svg" alt="Documentation"></a> <a href="https://github.com/Musicoll/Kiwi/releases"><img src="https://img.shields.io/badge/@-download-blue.svg" alt="Download"></a> </p> </p>Presentation
Kiwi is a graphical programming environment dedicated to music and sound creation, such as Max or Pure Data softwares, but offering a real-time collaborative approach: Kiwi allows several distant users to work simultaneously on the same patch hosted online.
Kiwi is part of the French ANR-funded MUSICOLL project that unites the CICM and OhmForce. The main goal of this project is to study how collaboration can enhance the way digital audio music composition is taught and more generally how it can renew music creation practices and improve its workflow.
- You can download the latest version in the release page :
- Access online software documentation
Compilation
The compilation of Kiwi uses CMake. Most of the dependencies are included as git submodules, the others will be installed during automatically during the CMake configuration phase. Thus, the compilation requires the default git and CMake steps such as:
git clone https://github.com/Musicoll/Kiwi.git
cd Kiwi
git submodule update --init --recursive
mkdir Build && cd Build
cmake ..
cmake --build .
This default CMake approach downloads and compiles all the dependencies Flip, Boost and LLVM but the CMake approach also allows to use the personal/systems libraries.
-
Flip
Enables or disable the personal/system library for Flip with the optionUSE_SYSTEM_FLIP ON/OFF (default OFF)
. Flip must be compiled as a static library compatible with the commit c47e41da05. Use the variableFLIP_INCLUDE_DIRS PATHS
to define the Flip include directories and the variableFLIP_LIBRARY_DIRS PATHS
to define the Flip library directories. -
Boost
Enables or disable the personal/system library for Boost with the optionUSE_SYSTEM_BOOST ON/OFF (default OFF)
. Boost must be compiled as a static library with the system component and compatible with the version 1.69.0. See this documentation for more options. -
LLVM
Enables or disable the personal/system library for LLVM with the optionUSE_SYSTEM_LLVM ON/OFF (default OFF)
. LLVM must be compiled as a static library (with the dynamic runtime on Windows) and compatible with the version 5.0.0. See this documentation for more options.
Documentation
The documentation of Kiwi is available online and with the distribution. Generating the documentation requires to install github-wikito-converter:
npm install -g github-wikito-converter
Then, from the Kiwi root folder, run:
python ./Scripts/gendoc.py
Authors
Eliott Paris | Pierre Guillot | Jean Millot |
Papers
- E. Paris, Une Approche du patching audio collaboratif : Enjeux et développement du collecticiel Kiwi, thèse de doctorat, sous la direction d'A. Sèdes et A. Bonardi, Université de Paris 8, 2018 - URL (fr).
- P. Galleron, E. Maestri, J. Millot, A. Bonardi, E. Paris, Enseigner le patching de manière collective avec le logiciel collaboratif Kiwi, Journées d’Informatique Musicale (JIM 2018), 2018, Amiens, France, pp.105-114. URL (fr).
- E. Paris, J. Millot, P. Guillot, A. Bonardi, A. Sèdes, Kiwi : Vers un environnement de creation musicale temps reel collaboratif, Journées d’Informatique Musicale (JIM 2017), 2017, Paris, France. URL (fr).
- A. Sèdes, A. Bonardi, E. Paris, J. Millot, P. Guillot, Teaching, investigating, creating: MUSICOLL. Innovative Tools and Methods for Teaching Music and Signal Processing, 2017. URL (en).
Organizations
Credits
License
The Kiwi application is licensed under the terms of the GNU GPL-3.0 license. However, Kiwi also depends on the Flip library which is NOT open-source.