flutter_soloud Documentation

A cross-platform audio plugin for Flutter using the SoLoud audio engine

Platform Support

LinuxWindowsAndroidMacOSiOSWeb
Support💙💙💙💙💙💙
Minimum VersionAnyAny2110.1513.0Any

What is flutter_soloud?

A high-performance audio plugin designed primarily for games and immersive applications. If you merely need to play audio (such as playing a single sound effect or a non-looped song), and you don't need to worry about latency, there are other Flutter plugins you can use, such as the popular audioplayers plugin.

Built on the SoLoud audio engine, it provides low latency, high-quality audio playback with advanced features.

from the underlying engine's homepage

SoLoud is an easy to use, free, portable c/c++ audio engine for games.

The engine has been designed to make simple things easy, while not making harder things impossible.

The flutter_soloud plugin uses the SoLoud (C++) audio engine with the miniaudio backend through Dart's C interop (dart:ffi). In other words, it is calling the C/C++ methods of the underlying audio engine directly — there are no method channels in use.

For a full API Reference, see the flutter_soloud documentation.

Key Features

Core Audio

  • Low latency, high performance playback
  • 🔄 Gapless looping for background music and ambience
  • 💾 Flexible memory management (RAM or disk streaming)
  • 🎵 Multiple concurrent voices
  • 📊 Real-time audio visualization (wave/FFT data)

Advanced Audio Control

  • 🎮 3D positional audio with Doppler effect
  • 🌊 Live waveform generation
  • Time-based faders for attributes
  • Audio parameter oscillators

Format Support

  • 🎵 MP3, WAV, OGG, and FLAC playback
  • 🌊 Multiple waveform types:
    • Square, Saw, Sine, Triangle
    • Bounce, Jaws, Humps
    • Filtered Square and Saw

Effects & Streaming

  • Rich effects system including:
    • Echo, Freeverb, Bassboost, Biquad Resonant
    • Equalizer, Pitch Shifter, Flanger, Wave Shaper
    • Limiter, Compressor, Lofi, Robotize
  • 🔄 Buffered audio streaming with:
    • Multiple PCM formats (signed le 8/16/32-bit and float 32-bit)
    • Opus codec with Ogg container

When to Use flutter_soloud

Choose flutter_soloud when you need:

  • Low-latency audio playback
  • Complex audio manipulation
  • 3D positional audio
  • Multiple concurrent sound effects
  • Advanced audio effects

Technical Details

The plugin uses: