diff --git a/ATTRIBUTION.md b/ATTRIBUTION.md --- a/ATTRIBUTION.md +++ b/ATTRIBUTION.md @@ -15,6 +15,11 @@ the SoundCraft contributors) is listed under Files below. ## Audio +`crates/audio-io/tests/fixtures/` contains original synthetic tones generated by Codex for Jack +and encoded with macOS Audio File Convert or FFmpeg. The source recipe is in that folder's +README.md. These test fixtures are licensed MIT OR Apache-2.0, like this project; no third-party +recordings or proprietary sample content are included. + The demo session's audio (drums, bass, pad) and its MIDI parts are synthesised in code in `crates/engine/src/demo.rs` by the SoundCraft contributors (MIT OR Apache-2.0). No sample files are bundled. @@ -29,6 +34,7 @@ and, at runtime, the operating system's own UI fonts when available (never redis | Path | Author | Source | License | |---|---|---|---| +| `crates/audio-io/tests/fixtures/` | Codex for Jack | Original generated test tones; recipe in folder | MIT OR Apache-2.0 | | `docs/brand/artcraft-logo.svg` | ArtCraft Team | craftrules `assets/brand/` | ArtCraft brand terms (`docs/brand/LICENSE-brand.txt`) | | `docs/brand/artcraft-logo.png` | ArtCraft Team | craftrules `assets/brand/` | ArtCraft brand terms | | `docs/brand/artcraft-logo-white.svg` | ArtCraft Team | craftrules `assets/brand/` | ArtCraft brand terms | diff --git a/Cargo.lock b/Cargo.lock --- a/Cargo.lock +++ b/Cargo.lock @@ -3321,6 +3321,12 @@ dependencies = [ "wait-timeout", ] +[[package]] +name = "rusty_aac" +version = "1.1.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9408128402e729f7f5b71f05870198b9140bcb597e6e09dddc75f1272f7aec48" + [[package]] name = "same-file" version = "1.0.6" @@ -3604,6 +3610,7 @@ version = "0.10.0" dependencies = [ "log", "proptest", + "rusty_aac", "serde", "serde_json", "symphonia", diff --git a/crates/audio-io/Cargo.toml b/crates/audio-io/Cargo.toml --- a/crates/audio-io/Cargo.toml +++ b/crates/audio-io/Cargo.toml @@ -12,6 +12,7 @@ serde.workspace = true thiserror.workspace = true log.workspace = true symphonia.workspace = true +rusty_aac = { version = "=1.1.1", default-features = false } [dev-dependencies] proptest.workspace = true diff --git a/crates/audio-io/src/aac.rs b/crates/audio-io/src/aac.rs new file mode 100644 --- /dev/null +++ b/crates/audio-io/src/aac.rs @@ -0,0 +1,117 @@ +//! AAC packets from Symphonia's demuxer, decoded with SBR/PS and multichannel support. +//! The scalar-only dependency has no native runtime or unsafe acceleration enabled. + +use symphonia::core::{codecs::CodecParameters, errors::Error as SymError, formats::FormatReader, units::TimeBase}; + +use crate::{AudioBuffer, AudioError, AudioInfo, Result, pcm::check_decode_samples}; + +fn decoder_error(error: rusty_aac::Error) -> AudioError { + match error { + rusty_aac::Error::Unsupported(message) => AudioError::Unsupported(format!("AAC: {message}")), + other => AudioError::Malformed(format!("AAC: {other}")), + } +} + +/// Container trim counts use its time base, which may be the AAC core's rate. +fn trim_frames(trim: u32, time_base: TimeBase, output_rate: u32) -> Result { + if time_base.denom == 0 || time_base.numer == 0 { + return Err(AudioError::Malformed("AAC has an invalid time base".into())); + } + let frames = u128::from(trim) * u128::from(time_base.numer) * u128::from(output_rate) / u128::from(time_base.denom); + usize::try_from(frames).map_err(|_| AudioError::TooLarge("AAC trim exceeds addressable memory".into())) +} + +pub(crate) fn run( + mut reader: Box, + params: &CodecParameters, + track: u32, + mut info: AudioInfo, + count_only: bool, +) -> Result<(AudioInfo, AudioBuffer)> { + let mut decoder = match params.extra_data.as_deref() { + Some(config) => rusty_aac::AacDecoder::with_config_bytes(config).map_err(decoder_error)?, + None => { + let channels = params.channels.map(|c| c.count()).unwrap_or(usize::from(info.channels)); + // ADTS demuxing supplies the standard AAC configuration's channel count. + let configuration = match channels { + 1..=6 => channels as u16, + 8 => 7, + _ => return Err(AudioError::Unsupported("AAC requires a supported channel configuration".into())), + }; + rusty_aac::AacDecoder::with_config(rusty_aac::AudioSpecificConfig { + object_type: 2, + sample_rate: info.sample_rate, + channels: configuration, + }) + } + }; + let time_base = params.time_base.unwrap_or(TimeBase { numer: 1, denom: info.sample_rate }); + let mut planar: Vec> = Vec::new(); + let mut frames = 0u64; + let mut format = None; + loop { + let packet = match reader.next_packet() { + Ok(packet) => packet, + Err(SymError::IoError(error)) if error.kind() == std::io::ErrorKind::UnexpectedEof => break, + Err(error) => return Err(AudioError::Malformed(format!("AAC container: {error}"))), + }; + if packet.track_id() != track { + continue; + } + let decoded = decoder.decode(packet.buf(), None).map_err(decoder_error)?; + let channels = usize::from(decoded.channels); + if decoded.sample_rate == 0 || !(1..=8).contains(&channels) || !decoded.samples.len().is_multiple_of(channels) { + return Err(AudioError::Malformed("AAC decoder returned an invalid audio layout".into())); + } + let current = (decoded.sample_rate, decoded.channels); + if format.is_some_and(|previous| previous != current) { + return Err(AudioError::Unsupported("AAC changes sample rate or channel layout within the stream".into())); + } + if format.is_none() { + format = Some(current); + info.sample_rate = decoded.sample_rate; + info.channels = decoded.channels; + if !count_only { + planar = (0..channels).map(|_| Vec::new()).collect(); + } + } + let start = trim_frames(packet.trim_start(), time_base, decoded.sample_rate)?; + let end_trim = trim_frames(packet.trim_end(), time_base, decoded.sample_rate)?; + let n = decoded.frames(); + let end = n + .checked_sub(end_trim) + .filter(|&end| start <= end) + .ok_or_else(|| AudioError::Malformed("AAC packet trim exceeds decoded frames".into()))?; + frames = frames.checked_add((end - start) as u64).ok_or_else(|| AudioError::TooLarge("AAC frame count overflow".into()))?; + check_decode_samples(frames, decoded.channels, decoded.sample_rate)?; + if !count_only { + for dst in &mut planar { + dst.try_reserve(end - start).map_err(|_| AudioError::TooLarge("not enough memory to decode AAC".into()))?; + } + let samples = + decoded.samples.get(start * channels..end * channels).ok_or_else(|| AudioError::Malformed("AAC trim is out of range".into()))?; + for frame in samples.chunks_exact(channels) { + for (dst, &sample) in planar.iter_mut().zip(frame) { + dst.push(if sample.is_finite() { sample } else { 0.0 }); + } + } + } + } + if format.is_none() { + return Err(AudioError::Malformed("AAC stream contains no audio packets".into())); + } + info.frames = frames; + Ok((info.clone(), AudioBuffer { sample_rate: info.sample_rate, channels: planar })) +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn trims_follow_the_output_rate_and_reject_invalid_time_bases() { + assert_eq!(trim_frames(512, TimeBase { numer: 1, denom: 24_000 }, 48_000).unwrap(), 1024); + assert_eq!(trim_frames(1024, TimeBase { numer: 1, denom: 48_000 }, 48_000).unwrap(), 1024); + assert!(trim_frames(1, TimeBase { numer: 1, denom: 0 }, 48_000).is_err()); + } +} diff --git a/crates/audio-io/src/lib.rs b/crates/audio-io/src/lib.rs --- a/crates/audio-io/src/lib.rs +++ b/crates/audio-io/src/lib.rs @@ -14,6 +14,7 @@ //! of any length never has to fit in memory. #![deny(clippy::unwrap_used, clippy::expect_used, clippy::panic, clippy::unimplemented, clippy::todo, clippy::unreachable)] +mod aac; mod aiff; mod buffer; mod caf; diff --git a/crates/audio-io/src/mp4.rs b/crates/audio-io/src/mp4.rs --- a/crates/audio-io/src/mp4.rs +++ b/crates/audio-io/src/mp4.rs @@ -104,3 +104,222 @@ fn sample_sizes(b: &[u8], body: usize, end: usize) -> Result { } Ok(fits) } + +// Edit-list support adapted from MarekSpodBiedry's SoundCraft pull request #713, +// commit 4a6228af98d3533c932a91ee1d667e347af94d8b, under this project's MIT/Apache-2.0 license. +/// The part of a decoded MP4 audio track that the file's edit list keeps, in frames at the +/// track's sample rate. AAC streams start with encoder delay that only the edit list excludes. +#[derive(Debug, Clone, Copy, PartialEq, Eq)] +pub(crate) struct Trim { + /// Frames to drop from the start of the decoded stream. + pub skip: u64, + /// Frames to keep after those, or all that remain. + pub len: Option, +} + +impl Trim { + /// Total frames left of a decoded stream of `total` frames. + pub(crate) fn frames(self, total: u64) -> u64 { + let rest = total.saturating_sub(self.skip); + self.len.map_or(rest, |n| n.min(rest)) + } + + /// Cut every channel down to the kept frames. + pub(crate) fn apply(self, channels: &mut [Vec]) { + for ch in channels { + let skip = usize::try_from(self.skip).unwrap_or(usize::MAX).min(ch.len()); + ch.drain(..skip); + if let Some(n) = self.len { + ch.truncate(usize::try_from(n).unwrap_or(usize::MAX)); + } + } + } +} + +/// Child atoms in `pos..end` as (kind, body start, atom end). Stops at the first header that +/// does not fit. +fn children(b: &[u8], mut pos: usize, end: usize) -> Vec<([u8; 4], usize, usize)> { + let end = end.min(b.len()); + let mut out = Vec::new(); + while pos < end { + if out.len() >= 65_536 { + break; // Metadata lookup must not allocate in proportion to an unbounded atom count. + } + let (Some(size), Some(kind)) = (be_u32(b, pos), crate::pcm::tag(b, pos + 4)) else { break }; + let (head, len) = match size { + 0 => (8, (end - pos) as u64), + 1 => (16, be_u64(b, pos + 8).unwrap_or(0)), + n => (8, u64::from(n)), + }; + let Some(atom_end) = usize::try_from(len).ok().filter(|_| len >= head).and_then(|n| pos.checked_add(n)).filter(|&n| n <= end) else { break }; + out.push((kind, pos + head as usize, atom_end)); + pos = atom_end; + } + out +} + +/// The timescale of an `mvhd` or `mdhd` atom whose body starts at `body`. +fn timescale(b: &[u8], body: usize) -> Option { + let at = match *b.get(body)? { + 0 => body.checked_add(12)?, + 1 => body.checked_add(20)?, + _ => return None, + }; + be_u32(b, at).filter(|&t| t > 0).map(u64::from) +} + +/// `value` units of a clock running at `from` Hz, as frames at `rate` Hz. +fn rescale(value: u64, rate: u64, from: u64) -> Option { + u64::try_from(u128::from(value) * u128::from(rate) / u128::from(from)).ok() +} + +/// The frames kept by the edit list of the first sound track of the MP4 file `b`, for a track +/// decoded at `rate` Hz. None without a usable edit list: several entries, an empty edit, or a +/// cut that keeps everything. +pub(crate) fn edit_trim(b: &[u8], rate: u32) -> Option { + let rate = u64::from(rate); + let moov = children(b, 0, b.len()).into_iter().find(|c| &c.0 == b"moov")?; + let parts = children(b, moov.1, moov.2); + let mvhd = parts.iter().find(|c| &c.0 == b"mvhd")?; + let movie_scale = timescale(b.get(..mvhd.2)?, mvhd.1)?; + for (_, trak, trak_end) in parts.iter().filter(|c| &c.0 == b"trak") { + let kids = children(b, *trak, *trak_end); + let mdia = kids.iter().find(|c| &c.0 == b"mdia")?; + let media = children(b, mdia.1, mdia.2); + let is_sound = + media.iter().find(|c| &c.0 == b"hdlr").is_some_and(|h| b.get(..h.2).and_then(|b| crate::pcm::tag(b, h.1 + 8)) == Some(*b"soun")); + if !is_sound { + continue; + } + let mdhd = media.iter().find(|c| &c.0 == b"mdhd")?; + let media_scale = timescale(b.get(..mdhd.2)?, mdhd.1)?; + let edts = kids.iter().find(|c| &c.0 == b"edts")?; + let elst = children(b, edts.1, edts.2).into_iter().find(|c| &c.0 == b"elst")?; + let b = b.get(..elst.2)?; + let body = elst.1; + let wide = match *b.get(body)? { + 0 => false, + 1 => true, + _ => return None, + }; + if be_u32(b, body + 4)? != 1 { + return None; + } + let (duration, start) = if wide { + (be_u64(b, body + 8)?, i64::from_be_bytes(be_u64(b, body + 16)?.to_be_bytes())) + } else { + (u64::from(be_u32(b, body + 8)?), i64::from(i32::from_be_bytes(be_u32(b, body + 12)?.to_be_bytes()))) + }; + let media_rate = if wide { body + 24 } else { body + 16 }; + // Reverse, freeze and accelerated edits require timeline rendering, not a trim. + if be_u32(b, media_rate)? != 0x0001_0000 { + return None; + } + let skip = rescale(u64::try_from(start).ok()?, rate, media_scale)?; + let len = if duration == 0 { None } else { Some(rescale(duration, rate, movie_scale)?) }; + return (skip > 0 || len.is_some()).then_some(Trim { skip, len }); + } + None +} + +/// Apple's encoder stores priming in iTunSMPB instead of an edit list. Its counts +/// use the media clock, which is the core rate for dual-rate HE-AAC. +pub(crate) fn itunes_trim(b: &[u8], rate: u32) -> Option { + let find = |pos, end, kind: &[u8; 4]| children(b, pos, end).into_iter().find(|c| &c.0 == kind); + let moov = find(0, b.len(), b"moov")?; + let mut sound = children(b, moov.1, moov.2).into_iter().filter(|c| &c.0 == b"trak").filter_map(|trak| { + let mdia = find(trak.1, trak.2, b"mdia")?; + let hdlr = find(mdia.1, mdia.2, b"hdlr")?; + (crate::pcm::tag(b.get(..hdlr.2)?, hdlr.1 + 8)? == *b"soun").then_some(mdia) + }); + let mdia = sound.next()?; + if sound.next().is_some() { + return None; // A global tag cannot identify which audio track it describes. + } + let mdhd = find(mdia.1, mdia.2, b"mdhd")?; + let scale = timescale(b.get(..mdhd.2)?, mdhd.1)?; + let udta = find(moov.1, moov.2, b"udta")?; + let meta = find(udta.1, udta.2, b"meta")?; + let ilst = find(meta.1.checked_add(4)?, meta.2, b"ilst")?; + for item in children(b, ilst.1, ilst.2).into_iter().filter(|c| &c.0 == b"----") { + let mean = find(item.1, item.2, b"mean")?; + let name = find(item.1, item.2, b"name")?; + if b.get(mean.1.checked_add(4)?..mean.2)? != b"com.apple.iTunes" || b.get(name.1.checked_add(4)?..name.2)? != b"iTunSMPB" { + continue; + } + let data = find(item.1, item.2, b"data")?; + let text = std::str::from_utf8(b.get(data.1.checked_add(8)?..data.2)?).ok()?; + let mut fields = text.split_ascii_whitespace(); + let reserved = u64::from_str_radix(fields.next()?, 16).ok()?; + let delay = u64::from_str_radix(fields.next()?, 16).ok()?; + let _padding = u64::from_str_radix(fields.next()?, 16).ok()?; + let length = u64::from_str_radix(fields.next()?, 16).ok()?; + if reserved != 0 || length == 0 { + return None; + } + return Some(Trim { skip: rescale(delay, u64::from(rate), scale)?, len: Some(rescale(length, u64::from(rate), scale)?) }); + } + None +} + +#[cfg(test)] +mod tests { + use super::*; + + fn atom(kind: &[u8; 4], body: &[u8]) -> Vec { + let mut v = ((body.len() + 8) as u32).to_be_bytes().to_vec(); + v.extend_from_slice(kind); + v.extend_from_slice(body); + v + } + + fn header(scale: u32) -> Vec { + let mut v = vec![0u8; 12]; + v.extend_from_slice(&scale.to_be_bytes()); + v.extend_from_slice(&[0; 8]); + v + } + + fn file(movie_scale: u32, media_scale: u32, entries: &[(u32, i32)]) -> Vec { + let mut elst = vec![0, 0, 0, 0]; + elst.extend_from_slice(&(entries.len() as u32).to_be_bytes()); + for &(d, t) in entries { + elst.extend_from_slice(&d.to_be_bytes()); + elst.extend_from_slice(&t.to_be_bytes()); + elst.extend_from_slice(&[0, 1, 0, 0]); + } + let mut hdlr = vec![0u8; 8]; + hdlr.extend_from_slice(b"soun"); + let mdia = [atom(b"hdlr", &hdlr), atom(b"mdhd", &header(media_scale))].concat(); + let trak = [atom(b"mdia", &mdia), atom(b"edts", &atom(b"elst", &elst))].concat(); + let moov = [atom(b"mvhd", &header(movie_scale)), atom(b"trak", &trak)].concat(); + [atom(b"ftyp", b"M4A \0\0\0\0"), atom(b"moov", &moov)].concat() + } + + #[test] + fn edit_list_drops_priming_and_padding() { + let t = edit_trim(&file(48_000, 48_000, &[(48_000, 1024)]), 48_000); + assert_eq!(t, Some(Trim { skip: 1024, len: Some(48_000) })); + assert_eq!(t.map(|t| t.frames(49_152)), Some(48_000)); + } + + #[test] + fn edit_list_scales_movie_and_media_clocks() { + // A 1000 Hz movie clock (as ffmpeg writes) and a 44.1 kHz media clock. + let t = edit_trim(&file(1000, 44_100, &[(1000, 2112)]), 44_100); + assert_eq!(t, Some(Trim { skip: 2112, len: Some(44_100) })); + } + + #[test] + fn empty_or_split_edit_lists_are_ignored() { + assert_eq!(edit_trim(&file(1000, 48_000, &[(500, -1)]), 48_000), None); + assert_eq!(edit_trim(&file(1000, 48_000, &[(500, 0), (500, 100)]), 48_000), None); + } + + #[test] + fn trim_cuts_every_channel() { + let mut ch = vec![vec![1.0, 2.0, 3.0, 4.0], vec![5.0, 6.0, 7.0, 8.0]]; + Trim { skip: 1, len: Some(2) }.apply(&mut ch); + assert_eq!(ch, vec![vec![2.0, 3.0], vec![6.0, 7.0]]); + } +} diff --git a/crates/audio-io/src/pcm.rs b/crates/audio-io/src/pcm.rs --- a/crates/audio-io/src/pcm.rs +++ b/crates/audio-io/src/pcm.rs @@ -7,6 +7,44 @@ use std::io::Write; /// Maximum number of decoded `f32` samples (all channels) we will produce: 4 GiB of output. pub(crate) const MAX_DECODE_SAMPLES: u64 = (4u64 << 30) / 4; +pub(crate) fn check_decode_samples(frames: u64, channels: u16, rate: u32) -> Result<()> { + if frames.saturating_mul(u64::from(channels)) > MAX_DECODE_SAMPLES { + return Err(decode_limit_error(frames, channels, rate)); + } + Ok(()) +} + +/// Compressed file size is not the decoded allocation. Keep the guard and explain +/// what users can do, rather than suggesting an apparently small file is corrupt. +pub(crate) fn decode_limit_error(frames: u64, channels: u16, rate: u32) -> AudioError { + let samples = frames.saturating_mul(u64::from(channels)); + let gib = samples as f64 * 4.0 / (1u64 << 30) as f64; + let minutes = if rate == 0 { 0.0 } else { frames as f64 / f64::from(rate) / 60.0 }; + AudioError::TooLarge(format!( + "{minutes:.1} minutes at {rate} Hz with {channels} channels requires {gib:.2} GiB of decoded audio; \ + the per-file decode limit is 4 GiB regardless of compressed file size. Split the source into shorter files before importing" + )) +} + +#[cfg(test)] +mod limit_tests { + use super::*; + + #[test] + fn large_compressed_import_error_explains_decoded_memory_and_recovery() { + assert!(check_decode_samples(MAX_DECODE_SAMPLES / 2, 2, 48_000).is_ok()); + assert!(matches!(check_decode_samples(MAX_DECODE_SAMPLES / 2 + 1, 2, 48_000), Err(AudioError::TooLarge(_)))); + assert!(check_decode_samples(u64::MAX, u16::MAX, 48_000).is_err()); + let error = decode_limit_error(MAX_DECODE_SAMPLES / 2 + 1, 2, 48_000); + assert!(matches!(error, AudioError::TooLarge(_))); + let text = error.to_string(); + assert!(text.contains("4 GiB")); + assert!(text.contains("compressed file size")); + assert!(text.contains("Split the source")); + assert!(decode_limit_error(u64::MAX, u16::MAX, 0).to_string().contains("decode limit")); + } +} + /// Little-endian `u16` at `pos`. pub(crate) fn le_u16(b: &[u8], pos: usize) -> Option { let s = b.get(pos..pos.checked_add(2)?)?; diff --git a/crates/audio-io/src/symph.rs b/crates/audio-io/src/symph.rs --- a/crates/audio-io/src/symph.rs +++ b/crates/audio-io/src/symph.rs @@ -16,7 +16,7 @@ use symphonia::core::io::{MediaSourceStream, MediaSourceStreamOptions, ReadBytes use symphonia::core::meta::MetadataOptions; use symphonia::core::probe::Instantiate; -use crate::pcm::{MAX_DECODE_SAMPLES, be_u32}; +use crate::pcm::{be_u32, check_decode_samples}; use crate::{AudioBuffer, AudioError, AudioInfo, FileFormat, Result, SampleFormat}; /// The most frames a packet may declare: decoders allocate a packet's frames up front, and ALAC @@ -160,11 +160,10 @@ fn run(bytes: &[u8], detected: FileFormat, count_only: bool) -> Result<(AudioInf } }; let (track_id, mut info) = info_of(reader.as_ref(), detected)?; - if let Some(n) = reader.tracks().iter().find(|t| t.id == track_id).and_then(|t| t.codec_params.n_frames) { - let total = n.saturating_mul(u64::from(info.channels.max(1))); - if !count_only && total > MAX_DECODE_SAMPLES { - return Err(AudioError::TooLarge(format!("{total} samples exceeds the decode limit"))); - } + if let Some(n) = reader.tracks().iter().find(|t| t.id == track_id).and_then(|t| t.codec_params.n_frames) + && !count_only + { + check_decode_samples(n, info.channels.max(1), info.sample_rate)?; } let params = reader .tracks() @@ -176,6 +175,16 @@ fn run(bytes: &[u8], detected: FileFormat, count_only: bool) -> Result<(AudioInf if params.max_frames_per_packet.into_iter().chain(alac.map(u64::from)).any(|n| n > MAX_PACKET_FRAMES) { return Err(AudioError::Malformed("the file declares packets far longer than any codec uses".into())); } + if params.codec == CODEC_TYPE_AAC { + let (mut info, mut audio) = crate::aac::run(reader, ¶ms, track_id, info, count_only)?; + if let Some(trim) = crate::mp4::edit_trim(bytes, info.sample_rate).or_else(|| crate::mp4::itunes_trim(bytes, info.sample_rate)) { + info.frames = trim.frames(info.frames); + if !count_only { + trim.apply(&mut audio.channels); + } + } + return Ok((info, audio)); + } let mut decoder = symphonia::default::get_codecs().make(¶ms, &DecoderOptions::default()).map_err(map_err)?; let mut planar: Vec> = Vec::new(); @@ -216,16 +225,15 @@ fn run(bytes: &[u8], detected: FileFormat, count_only: bool) -> Result<(AudioInf if ch == 0 { continue; } + let channels = u16::try_from(ch).map_err(|_| AudioError::Unsupported("too many channels".into()))?; if planar.is_empty() { // The decoded stream is authoritative for the channel count. - info.channels = u16::try_from(ch).map_err(|_| AudioError::Unsupported("too many channels".into()))?; + info.channels = channels; planar = (0..ch).map(|_| Vec::new()).collect(); } let n = decoded.frames() as u64; frames = frames.saturating_add(n); - if frames.saturating_mul(ch as u64) > MAX_DECODE_SAMPLES { - return Err(AudioError::TooLarge("decoded audio exceeds the 4 GiB limit".into())); - } + check_decode_samples(frames, channels, info.sample_rate)?; if count_only { continue; } @@ -259,6 +267,11 @@ pub(crate) fn probe(bytes: &[u8], detected: FileFormat) -> Result { Opened::Empty(info) => return Ok(info), }; let (_, info) = info_of(reader.as_ref(), detected)?; + if reader.tracks().iter().any(|t| t.codec_params.codec == CODEC_TYPE_AAC) { + // AAC extensions may change rate and channels only when packets are decoded. + // Header-only answers otherwise describe the core, not the audible stream. + return run(bytes, detected, true).map(|(i, _)| i); + } if info.frames > 0 && info.channels > 0 { return Ok(info); } diff --git a/crates/audio-io/tests/aac_profiles.rs b/crates/audio-io/tests/aac_profiles.rs new file mode 100644 --- /dev/null +++ b/crates/audio-io/tests/aac_profiles.rs @@ -0,0 +1,43 @@ +use soundcraft_audio_io::{decode, probe}; + +#[test] +fn aac_extensions_preserve_duration_rate_and_channels() { + for (name, bytes, rate, channels) in [ + ("HE v1", include_bytes!("fixtures/he-v1.m4a").as_slice(), 32_000, 2), + ("HE v2", include_bytes!("fixtures/he-v2.m4a").as_slice(), 48_000, 2), + ("5.1", include_bytes!("fixtures/aac-51.m4a").as_slice(), 48_000, 6), + ("LC stereo", include_bytes!("fixtures/lc-stereo.m4a").as_slice(), 48_000, 2), + ] { + let (info, audio) = decode(bytes, None).unwrap_or_else(|err| panic!("{name}: {err}")); + assert_eq!(info.channels, channels, "{name}"); + assert_eq!(info.sample_rate, rate, "{name}"); + assert_eq!(audio.sample_rate, rate, "{name}"); + assert_eq!(audio.frames(), rate as usize, "{name}: one second, including gapless trimming"); + assert_eq!(info.frames, audio.frames() as u64); + assert_eq!(probe(bytes, None).unwrap(), info, "{name}: probe and decode disagree"); + assert!(audio.channels.iter().flatten().all(|s| s.is_finite())); + } +} + +#[test] +fn adts_without_a_container_config_still_decodes() { + let (info, audio) = decode(include_bytes!("fixtures/lc-stereo.aac"), None).unwrap(); + assert_eq!((info.sample_rate, info.channels), (48_000, 2)); + assert!(audio.frames() >= 48_000); + assert_eq!(probe(include_bytes!("fixtures/lc-stereo.aac"), None).unwrap(), info); +} + +#[test] +fn truncated_and_mutated_aac_profiles_never_escape_as_panics() { + for bytes in [include_bytes!("fixtures/he-v2.m4a").as_slice(), include_bytes!("fixtures/aac-51.m4a").as_slice()] { + for end in (0..bytes.len()).step_by(37) { + let _ = probe(&bytes[..end], None); + let _ = decode(&bytes[..end], None); + } + for at in (0..bytes.len()).step_by(29) { + let mut damaged = bytes.to_vec(); + damaged[at] ^= 0xff; + let _ = decode(&damaged, None); + } + } +} diff --git a/crates/audio-io/tests/fixtures/README.md b/crates/audio-io/tests/fixtures/README.md new file mode 100644 --- /dev/null +++ b/crates/audio-io/tests/fixtures/README.md @@ -0,0 +1,18 @@ +# Original Advanced Audio Coding (AAC) test fixtures + +Generated by Codex for Jack, October 19, 2026; MIT OR Apache-2.0. +No recorded audio or third-party samples. Input: one second at 48000 hertz, 16-bit signed +samples, amplitude 2000. Channel c is round(2000 * sin(2*pi*(220+c*110)*i/48000)). +Stereo uses two channels; surround uses six in waveform-file channel order. + +he-v1.m4a: afconvert -f m4af -d aach -b 32000 stereo.wav he-v1.m4a +he-v2.m4a: afconvert -f m4af -d aacp -b 32000 stereo.wav he-v2.m4a +aac-51.m4a: afconvert -f m4af -d 'aac ' -b 256000 surround.wav aac-51.m4a +lc-stereo.m4a: ffmpeg -i stereo.wav -c:a aac -b:a 128k -f ipod lc-stereo.m4a +lc-stereo.aac: ffmpeg -i stereo.wav -c:a aac -b:a 128k -f adts lc-stereo.aac + +Apple's encoder chooses 32000-hertz output for high-efficiency version 1 at this bitrate; version 2 is 48000. +FFmpeg 9.0.2 independently decodes the three Apple files and the LC container to exactly +one second. The ADTS elementary stream has no container gapless metadata; it has encoder +priming and padding and is therefore intentionally longer. Binary hashes are in the review +manifest. Regeneration requires the encoders; normal regression tests use these fixed files. diff --git a/crates/audio-io/tests/fixtures/aac-51.m4a b/crates/audio-io/tests/fixtures/aac-51.m4a new file mode 100644 index 0000000000000000000000000000000000000000..0f0c1ddba1638359d231d51ea24edf0a537d0dff GIT binary patch literal 20802 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 literal 0 HcmV?d00001 diff --git a/crates/audio-io/tests/fixtures/he-v1.m4a b/crates/audio-io/tests/fixtures/he-v1.m4a new file mode 100644 index 0000000000000000000000000000000000000000..f9b7d5aefbb9ee0e2e1ee2bbd58421049335e0c2 GIT binary patch literal 5749 zcmeHLdsLHG62Bo35{wWe6pG23AWGb-1bKw57Gl&27D}|(MYJXeK`8`SlBg(1z@Vt7 zf{y~efUR0wRKO~_x++0Xv07tY5kZuwYs30PMM)v#cD@9T)jfOm?EjgQ-=I}J( zuwl`pCV66VJeVAL;(ytfb-wqq#MI2;R7JWfZP*^xq%3)IS`v&H3b}Qqp@>hS)z3=I zlo4@4h#u*x%v6rmCViq%E=dJDOQBR)*tPmmGMoU>9U*V`WrrAqgWw$`Sf)r+5C&PT zR*wU1586Y>M4n*tcnIYn2k$^=WGDiT_mci!4?ID$lQLzNzK9-dVq?I@fQa3 zF<@iB#(<51|H%L)M-F!xE{7~!HhRTBkcLPg&p;$~2>0{*7{j33rFs4RUo~^DE1gGW zOmuCl|7psGT3n6OPPIiR;71LTs(Gp>W0$^uQ|DWH{2GV4GCYaP44x2l!lzyGQS0In zmlkcSK4sXDx@Tm^tD}nY9K-#Myzk(*=?!v;s(d6XSs){mOWh|lwb!=Z4c^nX^TtKL ziC)s=yb?OyEf^~o_H~LGjmCO&he+w89?(z`@ZOzI)e22H+v@4eqe9YbVVc3GW`t+`O10Bi&t(B1wZgPw04#xjZVr%jp zIO;-f9__*1+=p$?j+gott~45rAMV(JDxCjyEUiB-SUFJD)wu|57KsZvB8L6Caa8J` zpX+K}%wNU!Pml-1s!4|JobT(eiN7%2_<3*C$*a8w{PLbn$xd?E_CUXSV4&EOzvO)3 zY4t(SjN|6ZK7yM%3pzREl)wF_=T6O(uWM+?Ow!caE=F&X8(& ztIg#C{EYtONpD+iY!x0GV3#z!2qG4_BI(J^HO9aqW5(hGG#d4OtE;&CPo6QN5rY0T zyRj*+(+7lnKD%6a_6&DEQJx;BwWLM^TgH2AP3Vl?UdPvRLCLscn%j5^Ra8`@GZ@;i zk+gsB{>HL0RH47@^s%y_6>>pG>cRqF z9jrci)$T#JgT}jVtvz?P!DukxyHj)x7d~Jvy<(zfLHCvi5P;P2F$~=qp(uCBlXI8yPX)cJrahy@7VZIrhI(PycogsmqalXC%>1Rh|S|_jG0^;io@`q1y z7Amv@*r>`821Sus5~k51WReKxG88hsCX{u%xtY21P$J?`Uq)&Ft)@n*wpMA%?X1+?Lk|}CN?wuLvdgsh7d(Ht^ z$Jw)9%_nKO6I#${=xUSq_`;bqLI0|9)y3VVPj4REH);Q?j0m5S;`6>6zRPMzFzs6O zht;~CtZ7|Ly>adO_3IA_9UoD~y12xu5!nlyvsbI`6)q7qCe{TmaO*U$`1XERQ`z-P z(z65le6l3xaXxiw$jHb>8daDUnkzTv`UUiPcSr>GTO$@So27auNxixDlYjPhvW_qU z`Ja0D9*SP~x61|fhpSjQDMG=KRX5lDloEHt`OucsE8#J}e-u7Hs}IAb`rhu?HEyp5 zE_wy5y56BJUyM3~zCZVr>;0nIe@buAH;$K8bNoL(7`HQN@efe}>0fV)d|VR|*c90w z=fPggy}kVOWUAM~;3v21Qrqi-0i*5WN_&`Lj_$%Ib@1XZQqSJEcGj!zr{ddMr31Tl gzU4&$G_v4nkrMw~w7nGWoD5`NiO?~C`+RZ8Z@aj9hyVZp literal 0 HcmV?d00001 diff --git a/crates/audio-io/tests/fixtures/he-v2.m4a b/crates/audio-io/tests/fixtures/he-v2.m4a new file mode 100644 index 0000000000000000000000000000000000000000..81c6cd8fb623290a81a2dca1c7398c929156fbf1 GIT binary patch literal 6315 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 literal 0 HcmV?d00001 diff --git a/crates/audio-io/tests/fixtures/lc-stereo.aac b/crates/audio-io/tests/fixtures/lc-stereo.aac new file mode 100644 index 0000000000000000000000000000000000000000..1c4118f406526aef6a0a00977d76921492d7a87a GIT binary patch literal 16117 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 Kl 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 Vec { diff --git a/crates/engine/src/io.rs b/crates/engine/src/io.rs --- a/crates/engine/src/io.rs +++ b/crates/engine/src/io.rs @@ -153,8 +153,13 @@ fn stamp_at_rate(stamp: u64, file_rate: u32, session_rate: u32) -> u64 { pub fn import_audio_bytes(e: &mut Engine, name: &str, bytes: &[u8], path: Option<&str>, target: Option, at: Samples) -> Result { let ext = Path::new(name).extension().and_then(|x| x.to_str()).map(str::to_ascii_lowercase); let (info, buf) = soundcraft_audio_io::decode(bytes, ext.as_deref()).map_err(|err| EngineError::Io(format!("{name}: {err}")))?; - let buf = at_rate(buf, e.session().sample_rate.hz(), MAX_IMPORT_SAMPLES) - .ok_or_else(|| EngineError::Io(format!("{name}: file is too large to import")))?; + let buf = at_rate(buf, e.session().sample_rate.hz(), MAX_IMPORT_SAMPLES).ok_or_else(|| { + EngineError::Io(format!( + "{name}: decoded audio would exceed the 4 GiB per-file memory limit after conversion to the session's {} Hz sample rate. \ + Compressed file size does not determine decoded memory; split the source into shorter files before importing", + e.session().sample_rate.hz() + )) + })?; if buf.frames() == 0 { return Err(EngineError::Io(format!("{name}: no audio"))); } diff --git a/docs/file-format-parity.md b/docs/file-format-parity.md --- a/docs/file-format-parity.md +++ b/docs/file-format-parity.md @@ -1,6 +1,6 @@ # File-format parity -> **Last reviewed:** 2026-10-13 · **Last updated:** 2026-10-13 · **Change:** trivial (WAV: empty data chunk with trailing metadata (#466); previously minor: continuous fade curvature in SoundCraft sessions) · **Target:** Avid Pro Tools Ultimate 2026.4.1 +> **Last reviewed:** 2026-10-20 · **Last updated:** 2026-10-20 · **Change:** minor (AAC extension decoding and gapless trim; readiness estimate unchanged) · **Target:** Avid Pro Tools Ultimate 2026.4.1 Every format Pro Tools reads or writes, and ours. The Pro Tools list comes from the document types its bundle declares (`CFBundleDocumentTypes` in Info.plist: names only, nothing else read) and its @@ -39,7 +39,7 @@ Legend: ✅ supported and tested · 🟡 partial · ❌ missing · — not appli | AIFF / AIFF-C | native | ✅ | ✅ (`fl32`) | Native | | FLAC | import | ✅ | ✅ | Own encoder | | MP3 | import, bounce | ✅ (symphonia) | ❌ | G-21 | -| AAC / M4A / MP4 audio | import, bounce | ✅ (symphonia) | ❌ | G-21 | +| Advanced Audio Coding (AAC) / M4A / MP4 audio | import, bounce | ✅ (Symphonia demuxing, scalar rusty_aac decoding) | ❌ | High-efficiency extensions retain reconstructed rate and stereo; six-channel decoding tested. Single ordinary MP4 edit and Apple priming metadata handled. Export still G-21; complex edit lists and broad codec conformance remain unqualified | | ALAC | import | ✅ | ❌ | | | Ogg Vorbis | — | ✅ | ❌ | Beyond Pro Tools | | CAF | — | ✅ | ❌ | | @@ -80,6 +80,7 @@ Legend: ✅ supported and tested · 🟡 partial · ❌ missing · — not appli | Date | Change | Summary | |---|---|---| +| 2026-10-19 | minor | AAC extensions and six-channel decoding use pure Rust with scalar dependency features. Regressions cover actual duration, rate, channels and ordinary priming metadata; no readiness percentage change | | 2026-10-13 | trivial | WAV: empty data chunk with trailing metadata (#466) | | 2026-10-13 | minor | Fade curvature round-trips in sessions with a zero default for older files. Format version and readiness estimate unchanged | | 2026-10-10 | major | Created: format inventory against Pro Tools 2026.4.1's declared document types and import/bounce options |