Skip to content

v0.6.1

Latest

Choose a tag to compare

@GabryDX GabryDX released this 16 Nov 16:05
· 2 commits to main since this release
c7e327f

🛡️ MetaJammer v0.6.1 — Release Notes

Summary

MetaJammer v0.6.1 introduces a high-performance, pure Kotlin streaming MP3 (MPEG Audio Layer III) metadata stripper, poisoner, and inspector engine (Mp3MetadataReader.kt). This eliminates reliance on Android's native MediaMuxer (which lacked support for raw audio/mpeg muxing, causing Failed to add the track to the muxer crashes), actively neutralizes Content Authenticity Initiative (C2PA) provenance tracking manifests embedded in ID3v2 GEOB frames, strips trailing ID3v1/APEv2 tags via a rolling stream FIFO buffer, and guarantees 100% bit-exact, lossless elementary audio stream preservation with zero recompression.


🌟 Key Changes & Improvements

1. Pure Kotlin Lossless MP3 Container Engine (Mp3MetadataReader.kt)

  • Zero-Allocation Stream Scrubber: Uses a constant-memory 128-byte tail buffer that completely eliminates garbage collection churn ($O(1)$ heap allocation, capped at 64.1 KB regardless of audio file size), achieving sub-millisecond stripping throughput (>20,000 MB/s in-memory).
  • Fixes Native MediaMuxer Crash: Permanently eliminates the IllegalStateException: Failed to add the track to the muxer crash encountered when processing MP3 files through platform media muxers.
  • Full ID3 Tag Coverage: Strips and parses all major ID3 specifications, including ID3v2.2, ID3v2.3, ID3v2.4 headers and extended headers, as well as legacy ID3v1 and ID3v1.1 tags.
  • Trailing Tag Removal with Rolling FIFO: Uses a memory-efficient 128-byte rolling FIFO buffer to identify and drop trailing ID3v1 tags (TAG...) from the end of the stream without requiring random file seeks or buffering entire files in memory.

2. C2PA Provenance Tracking & ID3 Frame Neutralization

  • Active C2PA Manifest Removal: Specifically detects, flags, and strips Content Authenticity Initiative (C2PA) authenticity and provenance tracking manifests embedded within GEOB (General Encapsulated Object) frames (commonly injected into AI-generated audio such as Gemini audio).
  • Private & Media Tag Scrubbing: Completely removes private tracking identifiers (PRIV), embedded album artwork (APIC), user comments (COMM), and encoding tool signatures (TSSE).
  • Metadata Poisoning & ID3v2.3 Synthesis: Generates clean, spec-compliant ID3v2.3 header and frames containing realistic poisoned metadata (TIT2, TPE1, TALB, TYER, COMM, TSSE) prepended directly before raw audio frames, leaving zero provenance or tracking residue.

3. Architecture & Robust Fallback Routing

  • Format-Aware Dispatcher: Updated MediaMetadataProcessor.kt to inspect MIME types and format signatures, cleanly routing MP3 files to Mp3MetadataReader while keeping MP4/MOV and OGG routed to their respective zero-recompression container processors.
  • Raw MPEG Sync Detection: Enhanced FileRepository.kt MIME detection to accurately detect stripped MP3 files lacking ID3 headers by inspecting MPEG audio frame sync words (0xFF 0xEx / 0xFF 0xFx).
  • Metadata Extraction Parity: Integrated Mp3MetadataReader.readMetadata() into MetadataRepository.kt to extract original metadata for pre-processing previews and visual diffs without triggering irrelevant MP4 box scanner warnings.

4. Security Audits & Multi-Format Documentation

  • Security Architecture Audit (docs/SECURITY_AUDIT.md): Added Section 4.9 detailing MP3 ID3 & C2PA Container Sanitization, memory limits, and streaming frame preservation.
  • FOSS Compliance Audit (docs/FOSS_AUDIT.md): Added Section 3 verifying that the MP3 container parser uses 100% standard Kotlin/Java I/O streams with zero proprietary or third-party binary dependencies.
  • Store Listing & Documentation Parity: Updated README.md, PLAY_STORE_PUBLISHING_GUIDE.md, and Fastlane store listings to include MP3 in multi-format audio support.

5. Automated Unit & Integration Testing

  • Test Suite Expansion: Added comprehensive unit tests in Mp3MetadataReaderTest.kt verifying metadata extraction, C2PA manifest identification, lossless ID3 stripping, ID3v1/ID3v1.1 parsing, and ID3v2.3 metadata poisoning.
  • Test Path Resiliency & Benchmarks: Updated all test suites to support dual-path test data (test_data/fake/ and test_data/real/), achieving 100% passing tests (159 total tests) and benchmarked real 4.2MB MP3 stripping at 0.18ms.

6. Internationalization, Store Metadata & Graphics Polish

  • Help & Tutorials Multi-Locale Parity: Updated help_item_video_body to include MP3 container support across all 24 supported application languages.
  • Store Listing Localizations (F-Droid / Fastlane): Added localized short_description.txt (strictly $\le 80$ characters) and comprehensive full_description.txt across all 23 non-English locales (it, de, es, fr, pt, ru, ja, zh, etc.) using native in-app terminology.
  • Feature Graphic Vectorization: Eliminated missing font/emoji "tofu" squares on the 1024×500 feature graphic, replacing them with crisp, resolution-independent vector icons (Security Shield, Lightning bolt, Padlock) and re-aligned badge bounding boxes with sub-pixel precision.
  • Store Assets Standardization: Consolidated Fastlane store icons to 512×512 icon.png and standardized phone screenshots to numeric naming (1.jpg–7.jpg) to ensure clean in-place updates on F-Droid without orphan files.
  • Distribution & Transparency: Added Obtainium one-click installation support with web redirect handling, and added documentation clarifying MetaJammer's rationale for opting out of the Google Play Store (mandatory residential address disclosure and 20-tester corporate hurdles).

📦 Build Artifacts

  • Package: com.heronikostudios.metajammer
  • Version: 0.6.1 (Code 13)
  • Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)