Repository navigation
🛡️ 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 muxercrash 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.ktto inspect MIME types and format signatures, cleanly routing MP3 files toMp3MetadataReaderwhile keeping MP4/MOV and OGG routed to their respective zero-recompression container processors. - Raw MPEG Sync Detection: Enhanced
FileRepository.ktMIME 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()intoMetadataRepository.ktto 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.ktverifying 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/andtest_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_bodyto 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 comprehensivefull_description.txtacross 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.pngand 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(Code13) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)