Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
This branch is 74 commits ahead, 1 commit behind jhasse:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

ears Build Status Build status

Ears aims to be a convenient and easy to understand Rust interface over OpenAL.

It's designed first and foremost for game development, giving you easy access to complex functionality like HRTF, spatialization, and environmental effects with almost no configuration required.

View documentation

Supports a wide variety of audio formats, including:

  • Ogg Vorbis
  • Microsoft WAV
  • Lossless FLAC
  • AIFF

For a full list please see the documentation for libsndfile here:

Before you start

You need to install OpenAL and libsndfile on your system.

Linux (Debian and Ubuntu):

sudo apt install libopenal-dev libsndfile1-dev

Linux (Fedora):

sudo dnf install openal-soft-devel libsndfile-devel


brew install openal-soft libsndfile


The easiest way to get up and running is using the GNU toolchain. So first check which toolchain is currently active:

rustup show

If the GNU toolchain is not active, you can either set it as the system wide default:

rustup default stable-gnu

Or set it per directory:

rustup override set stable-gnu

Then install MSYS2 according to the instructions. Be sure to use the default installation folder (i.e. C:\msys32 or C:\msys64), as currently ears is hard coded to link against libraries in that location.

Then, run the following in the MSYS2 shell:

pacman -S mingw-w64-x86_64-libsndfile mingw-w64-x86_64-openal


Include ears in your Cargo.toml dependencies.

ears = "0.8.0"

Playing a sound effect while simultaneously streaming music off disk is as simple as it gets.

extern crate ears;
use ears::{Music, Sound, AudioController};

fn main() {
    let mut music = Music::new("your-music.ogg").unwrap();;

    let mut sound = Sound::new("your-sound-effect.wav").unwrap();;

    while music.is_playing() || sound.is_playing() {};

Running examples

cargo run --example basic
cargo run --example advanced
cargo run --example music
cargo run --example record
cargo run --example simple_player
cargo run --example threads
cargo run --example direct_channel