Skip to content

NullComma/freesound-unity-downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Freesound Unity Downloader

A powerful, native Unity Editor extension that seamlessly integrates the massive Freesound.org audio library directly into your engine. Perfect for game audio designers and developers who want ultra-fast prototyping and iterating.

Features

  • Live Search & Filtering: Perform text-based search queries using advanced tags (e.g., tag:loop, duration:[0.0 TO 10.0]).
  • Seamless OAuth 2.0: Painless authentication. Uses a secure external proxy (freesound-api.nullcomma.com/login) to bounce verification directly back to Unity — no backend setup required by you.
  • Visual Waveforms & Smart Cropping: Left/Right click on dynamically fetched waveforms to set start/end endpoints. Save space by cutting sounds before they encode.
  • FFMPEG Integration: If FFMPEG is available in your environment, cropped downloads are processed losslessly into your Assets/ directory.
  • HQ Preview Playback: Direct low-latency OGG audio streaming for previewing results over the web.

Installation

Option 1 — Unity Package Manager (recommended)

Open your project's Packages/manifest.json and add the following line inside the dependencies block:

"com.nullcomma.freesounddownloader": "https://github.com/NullComma/freesound-unity-downloader.git"

Or open the Package Manager window in Unity (Window > Package Manager), click the + button, select Add package from git URL..., and paste:

https://github.com/NullComma/freesound-unity-downloader.git

Option 2 — Manual

Copy the com.nullcomma.freesounddownloader folder into your project's Packages/ directory. The tool will compile automatically.

Usage

  1. Open the tool via Window > Audio > Freesound Downloader.
  2. Go to the Settings tab and authenticate with your Freesound account using the Authenticate Account button.
  3. Configure your local Download Path.
  4. Switch back to the Search tab and find sounds.
  5. Crop Audio:
    • Left-click on the waveform to define the start time.
    • Right-click on the waveform to define the end time.
    • You can also use the Crop Range slider.
  6. Hit Download Full Quality and enjoy.

Requirements

  • Unity 2020.1 or newer.
  • FFMPEG (optional, but recommended): used for locally clipping WAV/FLAC files after download. The tool also works without it.

About

A powerful, native Unity Editor extension to search, preview, crop, and download sounds directly from Freesound.org using seamless OAuth and FFMPEG integration.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages