All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• Builds without the symphonia feature did not compile

• Support for ALAC/AIFF
• Add automatic_gain_control source for dynamic audio level adjustment.
• New test signal generator sources:
  • SignalGenerator source generates a sine, triangle, square wave or sawtooth of a given frequency and sample rate.
  • Chirp source generates a sine wave with a linearly-increasing frequency over a given frequency range and duration.
  • white and pink generate white or pink noise, respectively. These sources depend on the rand crate and are guarded with the "noise" feature.
  • Documentation for the "noise" feature has been added to lib.rs.
• New Fade and Crossfade sources:
  • fade_out fades an input out using a linear gain fade.
  • linear_gain_ramp applies a linear gain change to a sound over a given duration. fade_out is implemented as a linear_gain_ramp and fade_in has been refactored to use the linear_gain_ramp implementation.

• Sink.try_seek now updates controls.position before returning. Calls to Sink.get_pos done immediately after a seek will now return the correct value.

• SamplesBuffer is now Clone

• Adds a new source track_position. It keeps track of duration since the beginning of the underlying source.

• Mp4a with decodable tracks after undecodable tracks now play. This matches VLC's behaviour.

• Seek no longer hangs if the sink is empty.

• Source trait is now also implemented for Box<dyn Source> and &mut Source
• fn new_vorbis is now also available when the symphonia-vorbis feature is enabled

• Adds a new method try_seek to all sources. It returns either an error or seeks to the given position. A few sources are "unsupported" they return the error Unsupported.
• Adds SpatialSink::clear() bringing it in line with Sink

• channel upscaling now follows the 'WAVEFORMATEXTENSIBLE' format and no longer repeats the last source channel on all extra output channels. Stereo content playing on a 5.1 speaker set will now only use the front left and front right speaker instead of repeating the right sample on all speakers except the front left one.
• mp3::is_mp3() no longer changes the position in the stream when the stream is mp3

• Build fix for minimp3 backend.

• Add EmptyCallback source.
• Fix index out of bounds bug.
• Use non-vulnerable minimp3 fork.
• Add filter functions with additional q parameter.

• Disable symphonia's default features.

• Update cpal to 0.15.
• Default to symphonia for mp3 decoding.

• Update cpal to 0.14.
• Update symphonia to 0.5.

• Remove requirement that the argument Decoder::new and LoopedDecoder::new implement Send.
• Add optional symphonia backend.
• WavDecoder's total_duration now returns the total duration of the sound rather than the remaining duration.
• Add 32-bit signed in WAV decoding.
• SineWave::new() now takes a f32 instead of a u32.
• Add len() method to SpatialSink.

• Re-export cpal in full.
• Replace panics when calling OutputStream::try_default, OutputStream::try_from_device with new StreamError variants.
• OutputStream::try_default will now fallback to non-default output devices if an OutputStream cannot be created from the default device.

• Fix panic when no pulseaudio-alsa was installed.

• Update cpal to 0.13.
• Add Android support.

• Breaking: Update cpal to 0.12.
• Breaking: Rework API removing global "rodio audio processing" thread & adapting to the upstream cpal API changes.
• Add new_X format specific methods to Decoder.
• Fix resampler dependency on internal Vec::capacity behaviour.

• Update lewton to 0.10.
• Breaking: Update cpal to 0.11

• Removal of nalgebra in favour of own code.
• Fix a bug that switched channels when resuming after having paused.
• Attempt all supported output formats if the default format fails in Sink::new.
• Breaking: Update cpal to 0.10.

• Remove exclusive &mut borrow requirements in Sink & SpatialSink setters.
• Use nalgebra instead of cgmath for Spatial source.

• Update lewton dependency to 0.9
• Change license from Apache-2.0 only to Apache-2.0 OR MIT

• Add mp3 decoding capabilities via minimp3

• Update cpal dependency to 0.8, and adopt the new naming convention
• BREAKING CHANGES:
  • renamed Endpoint to Device
  • split default_endpoint() into default_output_device() and default_input_device()
  • renamed endpoints() to devices()
  • introduced output_devices() and input_devices()