godot-csound

Godot gdextension csound library to allow playing music using csound. Currently works with Godot v4.7 stable release.

Project running in the browser godot-csound

Projects using godot-csound

• godot-csound-example - Simple godot-csound example.
• godot-synths - Music synths for Godot. (demo)
• geo icarus - A flying game featuring live synths for the audio.
• Quetzalcoatl — A game created for VelociCode 2026, a month-long game jam. (demo)

Documentation

The official documentation is hosted on Github pages. It is maintained in its own GitHub repository.

The class reference is also accessible from the Godot editor.

How to Install

Download latest release and extract into Godot project.

On MacOS disable the check for unsigned binaries:

xattr -dr com.apple.quarantine addons/csound/bin/macos

Before using godot-csound, import the project once so Godot can generate the required resource imports:

Import godot resources:

godot --headless --import

How to Build

This project uses docker to build the project for different platforms. The build scripts were developed using Ubuntu (x86_64).

Instructions

1. Install docker using apt:

sudo apt install docker.io

2. Add user to docker group:

sudo usermod -a -G docker $USER

3. Initialize git submodules:

git submodule update --init --recursive

4. Build project using make:

#build all platforms
make all

#build for ubuntu
make ubuntu

#build for windows
make mingw

#build for MacOS
make osxcross

#build for iOS
make ioscross

#build for Android
make android

#build for web
make web