Sovereign 8s.is mirror of 8b-is/m8a
  • Rust 82.2%
  • TeX 16.5%
  • Shell 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
8bit-Wraith 2189d99055
Merge pull request #3 from 8b-is/copilot/add-audio-analysis-capabilities
[WIP] Add audio analysis capabilities to Phoenix Protocol toolkit
2025-11-30 01:26:02 -05:00
.hive-mind fix: Serialize phi and amp in HarmonicObject (critical bug!) 2025-11-28 14:23:47 -05:00
.swarm Add initial configuration and metrics files for performance tracking 2025-11-28 16:49:19 -05:00
crates feat: Add harmonic jitter (jitter_h) to Marine tracking 2025-11-28 22:24:03 +00:00
docs feat: Update FLAC encoder to support stereo interleaved samples and preserve channel count 2025-11-28 16:59:25 -05:00
paper Add initial stubs for analysis, conclusion, conformance object, container FSM, evaluation limits, introduction, and lock consensus sections; implement the Phoenix Protocol and HCF1 in the .m8a container with detailed algorithms, container format, and evaluation plan; draft patent strategy and provisional application for the MEM|8 audio codec. 2025-11-28 09:09:50 -05:00
patent Add audio files for testing: "Mr. Sandman" by The Chordettes and "The Entertainer" by Scott Joplin 2025-11-28 12:24:27 -05:00
src feat: Initialize MEM|8 Audio (.m8a) project structure with HCF1 codec 2025-11-28 08:08:41 -05:00
tests Refactor code structure for improved readability and maintainability 2025-11-28 16:51:34 -05:00
.claude_consciousness.m8 Add initial configuration and metrics files for performance tracking 2025-11-28 16:49:19 -05:00
.gitignore Refactor code structure for improved readability and maintainability 2025-11-28 16:51:34 -05:00
Cargo.lock Add initial configuration and metrics files for performance tracking 2025-11-28 16:49:19 -05:00
Cargo.toml Add initial stubs for analysis, conclusion, conformance object, container FSM, evaluation limits, introduction, and lock consensus sections; implement the Phoenix Protocol and HCF1 in the .m8a container with detailed algorithms, container format, and evaluation plan; draft patent strategy and provisional application for the MEM|8 audio codec. 2025-11-28 09:09:50 -05:00
CLAUDE.md feat: Initialize MEM|8 Audio (.m8a) project structure with HCF1 codec 2025-11-28 08:08:41 -05:00
context.md Add FLAC24 residual codec with 12x file size reduction 2025-11-28 14:53:41 -05:00
IMPLEMENTATION_GUIDE.md Add initial stubs for analysis, conclusion, conformance object, container FSM, evaluation limits, introduction, and lock consensus sections; implement the Phoenix Protocol and HCF1 in the .m8a container with detailed algorithms, container format, and evaluation plan; draft patent strategy and provisional application for the MEM|8 audio codec. 2025-11-28 09:09:50 -05:00
README.md feat: Initialize MEM|8 Audio (.m8a) project structure with HCF1 codec 2025-11-28 08:08:41 -05:00
SPEC.md Add initial stubs for analysis, conclusion, conformance object, container FSM, evaluation limits, introduction, and lock consensus sections; implement the Phoenix Protocol and HCF1 in the .m8a container with detailed algorithms, container format, and evaluation plan; draft patent strategy and provisional application for the MEM|8 audio codec. 2025-11-28 09:09:50 -05:00

MEM|8 Audio (.m8a) — Phoenix/HCF1

.m8a is a seekable container for MEM|8 Audio. It stores:

  • CODE: HCF1 HarmonicObject atoms (master + buddies + conformance).
  • RESI: optional residual stream (FLAC/ADPCM/RVQ).
  • INFO/IDXT/META: file metadata and a time index.

HCF1 (Phoenix) codes predictable sound as equations on a lattice (p,q,\phi,A) and only stores deviations (conformance ratios, damping). Everything else goes to a residual.

Features (MVP)

  • Deterministic, phase-coherent decode (no ML at runtime).
  • Streaming-friendly chunked container.
  • Forward-compatible atoms (flags + length-prefix).
  • Optional residual passthrough (FLAC 24-bit).

Quick Start

# build
cargo build --release

# encode
target/release/m8a-enc -i input.wav -o output.m8a \
  --block 2048 --hop 512 --snap-cents 8 --consensus-tau 12 \
  --conf-ncc 0.92 --conf-rmse 0.08 --env-type pcm --env-rate 800 \
  --residual flac --crc

# inspect
target/release/m8a-inspect output.m8a --summary

# decode to wav
target/release/m8a-dec -i output.m8a -o restored.wav