A Swift Package Manager wrapper for aubio - a powerful audio analysis library for tempo detection, pitch detection, beat tracking, and more.

The original aubio library is only available via CocoaPods. This fork adds Swift Package Manager (SPM) support, making it easy to integrate aubio into modern Swift and iOS projects without CocoaPods.

aubio is a library to label music and sounds. It listens to audio signals and attempts to detect events such as:

• When a drum is hit
• At which frequency a note is playing
• At what tempo a rhythmic melody is playing

• 🎵 Tempo/BPM Detection - Accurate beat tracking and tempo estimation
• 🎼 Pitch Detection - Fundamental frequency analysis
• 🎹 Note Detection - Musical note tracking
• 📊 Spectral Analysis - FFT, phase vocoder, MFCC
• 🔊 Onset Detection - Attack time detection
• 🎚️ Digital Filters - Low pass, high pass, and more
• ⚡ Accelerate Optimized - Uses Apple's Accelerate framework for performance
• 📦 SPM Ready - No CocoaPods required
• 🍎 Native Apple - Built-in CoreAudio integration

Add to your Package.swift:

dependencies: [
    .package(url: "https://github.com/vitallica/aubio", from: "0.5.0")
]

Or in Xcode: File → Add Package Dependencies and paste the repository URL.

import Aubio

// Detect tempo from audio samples
func detectTempo(audioSamples: [Float], sampleRate: UInt32 = 44100) -> Double? {
    let hopSize: UInt32 = 512
    let windowSize: UInt32 = 1024

    guard let tempo = new_aubio_tempo("default", windowSize, hopSize, sampleRate) else {
        return nil
    }
    defer { del_aubio_tempo(tempo) }

    guard let inputBuffer = new_fvec(hopSize) else { return nil }
    defer { del_fvec(inputBuffer) }

    var bpmValues: [Float] = []

    for chunkStart in stride(from: 0, to: audioSamples.count, by: Int(hopSize)) {
        let chunkEnd = min(chunkStart + Int(hopSize), audioSamples.count)
        let chunk = Array(audioSamples[chunkStart..<chunkEnd])

        for (i, sample) in chunk.enumerated() {
            inputBuffer.pointee.data[i] = sample
        }

        aubio_tempo_do(tempo, inputBuffer, nil)

        let bpm = aubio_tempo_get_bpm(tempo)
        if bpm > 0 {
            bpmValues.append(bpm)
        }
    }

    guard !bpmValues.isEmpty else { return nil }
    let sortedBPMs = bpmValues.sorted()
    return Double(sortedBPMs[sortedBPMs.count / 2])
}

📖 Full Documentation - Complete API reference, examples, and integration guide

Quick Links:

• Installation Instructions
• Usage Examples
• iOS App Integration Guide
• API Reference
• Troubleshooting

• Aubio Manual - Official aubio documentation
• Developer Documentation - Doxygen-generated API docs
• Homepage - Official aubio website

• iOS 13.0+ or macOS 11.0+
• Xcode 14.0+
• Swift 5.9+

Check out examples/AubioUsageExample.swift for complete working examples:

• ✅ Tempo detection with confidence scoring
• ✅ Pitch detection with YIN algorithm
• ✅ Musical key detection
• ✅ AVFoundation audio file loading
• ✅ Integration patterns for iOS apps

This fork adds:

• ✅ Package.swift manifest for SPM support
• ✅ C module map for Swift interop (src/include/module.modulemap)
• ✅ Swift usage examples
• ✅ iOS/macOS optimizations with Accelerate framework
• ✅ Comprehensive documentation for Swift developers

All original aubio functionality is preserved and unchanged.

This wrapper maintains aubio's original GPL v3 license. See COPYING for full details.

aubio is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

⚠️ Important for Commercial Apps: GPL v3 is a copyleft license. If you're building a commercial app, you must either:

• Open source your app under GPL v3
• Obtain a commercial license from the aubio developers
• Use an alternative library

• Aubio Library: Paul Brossier and contributors
• Original Repository: aubio/aubio
• SPM Wrapper: Community contribution for Swift/iOS support

When citing this work, please reference the original aubio project:

The home page of this project can be found at: https://aubio.org/

For more information, see the about page in the aubio manual.

Found a bug or want to improve the SPM wrapper? Contributions are welcome!

• For aubio library issues: Report to aubio/aubio
• For SPM wrapper issues: Open an issue in this repository

• aubio - Original C library
• aubio-iOS CocoaPod - CocoaPods version

Happy audio analysis! 🎵

Made with ❤️ for the Swift community