FreesoundKit — unofficial Swift client library for the Freesound API

[Cody B]

<Re-posting because I originally sent from the wrong email — Apologies!>

Hi everyone,

I wanted to introduce myself and share an unofficial Swift client library for the Freesound API I've been working on called FreesoundKit.

FreesoundKit is a Swift package targeting the latest Apple platforms (macOS 15+, iOS 18+, tvOS 18+, watchOS 11+, visionOS 2+) as well as Linux and Android via SPM. I built it in Swift 6 language mode so it's fully Sendable-safe and plays nicely with Swift concurrency.

Here's a quick rundown of what's covered:

• API key and OAuth2 bearer auth (including authorization-code exchange and token refresh) 
  
• All search endpoints (textSearch, contentSearch, combinedSearch) with pagination helpers 
  
• Sound retrieval, analysis, comments, downloads (originals, packs, and unauthenticated previews) 
  
• Write endpoints (upload, describe, edit, bookmark, rate, comment) 
  
• User and pack endpoints, plus /me and bookmark categories 
  
• Typed Decodable models for sound metadata and audio descriptor fields 
  
• A FreesoundError enum that surfaces rate-limit Retry-After hints, OAuth requirements, and API error details 
  

I'm also the developer of Blankie, a free open-source macOS (and soon iOS!) ambient sound mixer. The released version of Blankie doesn't use FreesoundKit yet, but Freesound has been an integral part of my project and I started exploring the API to think through what a future integration could look like. 

This library is young, so feedback, bug reports, or questions are very welcome, either here or as GitHub issues. If you're also building something with Swift and the Freesound API I'd love to hear about it. 

Thanks for building and maintaining such a great API. 

Best, 

Cody Bromley