Partiels

Partiels is a free and open-source software suite for analysing and exploring the content and characteristics of sounds.

Website

The Partiels website presents the application and gathers all the information for users:

• Download Partiels and the Vamp plugins
• Manual
• Videos and publications (with the references to cite Partiels)
• Support and feedback

For bug reports or feature requests, you can create an issue on this Github repository. For more general feedback and questions, you can create a discussion.

Compilation

The compilation system is based on CMake. On macOS, you can use the XCode generator with the command cmake -G Xcode. On Windows, you can use the Visual Studio generator with the command cmake -G "Visual Studio 17 2022". On Linux, you can use the Makefile or Ninja generators with the commands cmake -G "Unix Makefiles" or cmake -G Ninja, using Clang or GCC as the compiler.

Here is an example:

git clone --recursive https://github.com/Ircam-Partiels/Partiels.git
cd partiels
cmake . -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug # Example using Ninja generator; use XCode on macOS or Visual Studio on Windows.
cmake --build build
ctest -C Debug -VV --test-dir build # Note: The `-VV` flag is optional and provides verbose output for debugging purposes.

⚠️ For Linux, JUCE dependencies must be installed: Refer to the file JUCE/docs/Linux Dependencies.md.

💡 You can refer to the GitHub Actions workflow for compilation instructions.

Website development

The website is built with Astro Starlight from the Website directory (Node.js 22.23.4 or higher) and deployed to GitHub Pages by the Website workflow. The manual and its images are imported from the Docs directory at each build.

cd Website
npm ci
npm run dev # Local server with live reload, or `npm run build && npm run preview` to check the published version

Release versions

Partiels uses GitHub Actions for continuous integration and automated releases. The release is created when a new tag is pushed (e.g., 2.1.0). This is the preferred approach for final stable releases. The CI workflow automatically:

• Builds the project in Release mode
• Creates a draft release with the tag name
• Uploads all platform-specific installers and documentation

git tag 2.1.0
git push origin 2.1.0

Debug builds

You can manually trigger a debug build from the GitHub Actions UI.

1. Go to the Actions tab
2. Click "Run workflow"
3. Configure the workflow inputs:
   • Build type: Choose Debug (default Release)

💡 The CI workflow also automatically detects [debug] in commit messages to build in Debug mode for regular commits.

License

Partiels is distributed under the GNU Affero General Public License v3 (AGPL-3.0). Unless otherwise stated, this license applies to all source files in this repository; the Git submodules and third-party dependencies remain under their own licenses.

Credits

Partiels: Design, architecture and development by Pierre Guillot at IRCAM IMR department.
Copyright 2026 IRCAM.

Contributions by Thomas Barbé, Nolan Dupont, and Guilherme Zanchetta.

Dependencies:

• Vamp SDK by Chris Cannam, copyright (c) 2005-2024 Chris Cannam and Centre for Digital Music, Queen Mary, University of London.
• Ircam Vamp Extension by Pierre Guillot at IRCAM IMR department.
• JUCE by Raw Material Software Limited.
• tinycolormap by Yuki Koyama.
• JSON C++ by Niels Lohmann.
• Magic Enum by Daniil Goncharov.
• ASIO SDK by Steinberg Media Technologies GmbH.