libgooey is a Rust-based audio engine which supports sound generation, processing, modulation and beyond. It's intended to be embedded as a library in other applications wherever general sound synthesis applies.

• Kick, Snare, Hihat and Tom drum synthesizer with comprehensive parameter control
• Parameter smoothing
• 16-step sequencer with sample-accurate timing
• C FFI for integration with Swift/iOS and other languages
• Cross-platform support (native, iOS)

# Build for native (desktop)
cargo build --release

# Run examples
cargo run --example kick
cargo run --example snare
cargo run --example hihat

Build for iOS devices and simulator:

./scripts/build-ios.sh

This produces:

• target/aarch64-apple-ios/release/libgooey.a (device)
• target/aarch64-apple-ios-sim/release/libgooey.a (simulator)
• include/gooey.h (C header)

iOS developers can download pre-built static libraries from GitHub Releases instead of building from source.

# Download a specific version
VERSION=v0.1.0
curl -L -o libgooey-ios.tar.gz \
  https://github.com/your-org/libgooey/releases/download/$VERSION/libgooey-ios-$VERSION.tar.gz

# Extract
tar -xzf libgooey-ios.tar.gz

The archive contains:

• device/libgooey.a - iOS device library (aarch64-apple-ios)
• simulator/libgooey.a - iOS simulator library (aarch64-apple-ios-sim)
• include/gooey.h - C header with FFI bindings
• README.md - Integration instructions

1. Add both libraries to your Xcode project
2. Configure Library Search Paths to include the library directories
3. Configure Header Search Paths to include the include/ directory
4. Add to your bridging header (for Swift):

   #include "gooey.h"

See the extracted README.md for detailed integration instructions.

To create a new iOS release:

1. Tag the release:

   git tag v0.1.0
   git push origin v0.1.0

2. The GitHub Actions workflow will automatically:

   • Build iOS libraries (device + simulator)
   • Generate C headers
   • Create a GitHub Release
   • Upload the tarball as a release asset

3. The release will be available at:

   https://github.com/your-org/libgooey/releases/download/v0.1.0/libgooey-ios-v0.1.0.tar.gz
   

You can also trigger builds manually via GitHub Actions UI (workflow_dispatch).

// Create engine
GooeyEngine* engine = gooey_engine_new(44100.0);

// Set parameters
gooey_engine_set_kick_param(engine, KICK_PARAM_FREQUENCY, 60.0);
gooey_engine_set_bpm(engine, 120.0);

// Configure sequencer
gooey_engine_sequencer_set_step(engine, 0, true);  // Step 0: on
gooey_engine_sequencer_set_step(engine, 4, true);  // Step 4: on
gooey_engine_sequencer_start(engine);

// Render audio
float buffer[512];
gooey_engine_render(engine, buffer, 512);

// Cleanup
gooey_engine_free(engine);

See include/gooey.h for complete API documentation.

MIT