TheAmazingAudioEngine 1.5.8

TheAmazingAudioEngine 1.5.8

LangLanguage Obj-CObjective C
License zlib
ReleasedLast Release Nov 2016

Maintained by Michael Tyson.

  • By
  • Michael Tyson

Important Notice: The Amazing Audio Engine has been retired. See the announcement here


Copyright (C) 2012-2015 A Tasty Pixel

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

  2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

  3. This notice may not be removed or altered from any source distribution.



  • Fixed a crash that can occur with rapid adding/removing of channels



  • Replaced internal use of synchronous cross-thread messaging with async messaging, to avoid risk of deadlocks and other timing issues
  • Fixed a crash that can occur when input format is changing
  • Watch for audio unit stream format changes in order to better react to sample rate changes
  • Implemented AEMessageQueue message exchange blocks


  • Added AEAudioBufferManager class, to enable management of AudioBufferList structures using normal ARC/retain-release memory management techniques
  • Addressed a problem introduced in 1.5.3 that could cause a 30s hang when restarting audio system
  • Revised timestamp management with Audiobus/IAA: now, TAAE will pass uncompensated timestamps to ABReceiverPortReceive, and will assume incoming timestamps, when hosted via IAA or Audiobus, are uncompensated.


  • Fixed an output latency compensation issue when hosted via Inter-App Audio
  • Deprecated "audiobusSenderPort" facility (use ABSenderPort's audioUnit initializer instead, with AEAudioController's audioUnit property)
  • Improved performance reports (made these less verbose, added percentage of render budget)
  • Fixed a crash when using AEPlaythroughChannel and changing the sample rate


  • Added AEAudioBufferListCreateOnStack utility
  • Enable automaticLatencyManagement by default
  • Fixed a race condition when using setAudiobusSenderPort*
  • Added tvOS support (thanks to Florian Doyon)
  • Added playAtTime: facility to AEMemoryBufferPlayer (thanks to Anton Holmberg)
  • Added setup/teardown methods to AEInputReceiver
  • Fixed missing setup/teardown calls to input filters
  • Replaced AEPlaythroughChannel initializer


  • Added composite setAudioDescription:inputEnabled:outputEnabled: update method
  • Added new initializer with AEAudioControllerOptions bitmask (thanks to Jonatan Liljedahl)
  • Added setting to always use the hardware sample rate (thanks to Jonatan Liljedahl)
  • Added missing teardown procedure for channels and filters
  • Fixed incorrect audio input conversion for interleaved formats
  • Fixed conversion issue with AEAudioUnitFilter
  • Fixed OS X build issue by removing AEReverbFilter for OS X (not supported on that platform)
  • Added 'audioGraphNode' properties to ABAudioUnitFilter/Channel
  • Updated TPCircularBuffer with added safety measures that will refuse to compile or crash early when a version mismatch is detected with other instances in your project
  • Address Audiobus issues for apps with both receiver and filter ports


  • Important fixes for the iPhone 6S
  • Added some AudioStreamBasicDescription utilities
  • Added extra AudioBufferList utilities and renamed existing ones for consistent naming
  • Added wrapper classes for Apple's effect audio units (thanks to Dream Engine's Jeremy Flores!)
  • Added Audio Unit parameter facilities (setParameterValue:forId: and getParameterValue:forId:)
  • Added AEMemoryBufferPlayer (a reincarnation of the previous in-memory AEAudioFilePlayer class)
  • Implemented 'playAtTime:' synchronisation method on AEAudioFilePlayer
  • Refactored out cross-thread messaging system into AEMessageQueue (thanks Jonatan Liljedahl!)
  • Replaced 'updateWithAudioDescription:...' mechanism with separate 'setAudioDescription', 'setInputEnabled' and 'setOutputEnabled' methods
  • Bunch of other little improvements; see git log for details.


  • OS X support! Many, many thanks to Steve Rubin!
  • Replaced in-memory version of AEAudioFilePlayer with an audio unit version which streams from disk (thanks to Ryan King and Jeremy Huff of Hello World Engineering, and Ryan Holmes for their contributions to this great enhancement).
  • Bunch of other little improvements; see git log for details.