Skip to content

Releases

v0.6.1

Choose a tag to compare

@GabryDX GabryDX released this 16 Nov 16:05
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)

v0.6.0

Choose a tag to compare

@GabryDX GabryDX released this 09 Nov 14:02
17c0fdb

🛡️ MetaJammer v0.6.0 — Release Notes

Summary

MetaJammer v0.6.0 introduces lossless, zero-recompression container-level HEIC / HEIF metadata stripping and poisoning with an in-place free-box padding architecture, completely eliminates legacy external storage permissions (WRITE_EXTERNAL_STORAGE) across all supported Android versions (API 26–37), reorganizes technical audits into a dedicated docs/ hierarchy with an official GitHub security policy (SECURITY.md), synchronizes localized onboarding and format guides across 24 languages, and updates Android Gradle Plugin to 9.5.0.


🌟 Key Changes & Improvements

1. Lossless Zero-Recompression HEIC / HEIF Processing

  • Pure ISO-BMFF Container Rewriter: Direct box-level parser, scrubber, and metadata injector (meta, iinf, iloc, iref, idat, mdat) for modern HEIC/HEIF images without decompressing or recompressing HEVC raster image data—guaranteeing 100% lossless output, zero generational quality loss, and instant processing speeds.
  • In-Place free-Box Padding Architecture: Modifies meta child atoms (iinf, iloc, iref) and pads meta with standard ISO-BMFF free boxes so it retains its exact original byte length. The massive mdat media data box, all image extents, and internal idat items remain 100% bit-exact and unshifted.
  • Multi-Tile iPhone Grid Support: Corrected 12-bit reserved / 4-bit construction_method nibble ordering in iloc versions 1 & 2, properly preserving relative offsets for multi-tile image grids (e.g., 48-tile Apple iPhone photos) without corrupting image descriptors.
  • Thumbnail De-synchronization Fix: Discovers thumbnailItemIds from iref prior to iinf filtering, dropping thumbnail items from both iinf and iloc simultaneously to permanently eliminate strict decoder rejections (Item has no data: Item with ID ... has no compressed data) on Nokia and Samsung devices.
  • Secure Extent Zeroing in mdat: Any dropped data extents in mdat (original EXIF, XMP, IPTC, or thumbnail payloads) are securely overwritten with zeros (0x00) using 64KB chunked I/O prior to output streaming.
  • Granular Preservation & Metadata Poisoning: Fully supports selective category preservation (preserving GPS, device info, date/time, camera settings, or comments) and realistic fake metadata injection with camera hardware profiles and location presets.
  • Universal Standalone EXIF Extraction: Direct extent parsing bypasses Android platform ExifInterface limitations, ensuring reliable metadata previewing and diffing across all supported Android versions (API 26–37) and unit-test JVM environments.

2. Zero Storage Permissions Across All Android Versions (F-Droid Compliance)

  • Complete Elimination of WRITE_EXTERNAL_STORAGE: Removed all legacy storage permission declarations from AndroidManifest.xml.
  • 100% Storage-Permission-Free: Modern Android (API 29+) uses MediaStore and Scoped Storage; legacy Android 8.0–9.0 (API 26–28) routes exports through the Storage Access Framework (SAF) and app-specific external media storage, eliminating all runtime and install-time storage permissions across the entire platform.
  • Resolves F-Droid Code Quality Scans: Directly addresses and clears F-Droid Code Quality scan findings regarding external storage permissions and shortens Fastlane changelogs to under 500 characters.

3. Security Architecture & Documentation Hierarchy

  • Dedicated docs/ Directory: Reorganized repository documentation, moving and updating technical audits into docs/FOSS_AUDIT.md and docs/SECURITY_AUDIT.md.
  • Official GitHub Security Policy (SECURITY.md): Added repository-level security policy covering supported versions, private vulnerability reporting (GitHub Security Advisories & maintainer email), 48-hour response SLAs, and OWASP MASVS compliance mappings.

4. Internationalization (i18n) & Onboarding Privacy Alignment

  • Air-Gapped Privacy in Onboarding: Updated onboarding_permissions_desc across all 24 supported locales to remove obsolete references to internet map permissions and emphasize 100% offline, air-gapped privacy.
  • Format Guide Parity: Updated help_item_image_body across all 24 locales to explicitly recognize HEIF/HEIC.
  • 100% String Parity: Maintained 100% identical key coverage across all 24 locales: English, Arabic, German, Greek, Spanish, Persian, French, Hebrew, Hindi, Indonesian, Italian, Japanese, Korean, Latin, Dutch, Polish, Portuguese, Romanian, Russian, Thai, Turkish, Ukrainian, Vietnamese, and Chinese (242 strings per locale).

5. Build, Packaging & Dependency Modernization

  • Android Gradle Plugin (AGP): Updated AGP to 9.5.0.
  • Fastlane Changelog: Created fastlane/metadata/android/en-US/changelogs/12.txt (392 characters, strictly under F-Droid's 500-character limit).
  • Footprint Optimization: Release APK size optimized at 5.0 MB with full R8 byte-code shrinking and resource minification.
  • Automated Unit Verification: Added automated unit tests covering real-world Nokia and Apple iPhone HEIC files, verified with pillow_heif full-resolution image decoding (100% tests passing).

📦 Build Artifacts

  • Package: com.heronikostudios.metajammer
  • Version: 0.6.0 (Code 12)
  • Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
  • Release APK: MetaJammer-v0.6.0.apk (5.0 MB)
  • Release Signing SHA-256: 36:D6:9B:D7:8C:8A:44:90:C2:BC:3F:53:29:6A:BD:68:88:7E:2A:50:AD:9B:9D:A1:C3:6C:CC:D6:4E:96:AF:01

v0.5.6

Choose a tag to compare

@GabryDX GabryDX released this 21 Oct 13:52
1435279

🛡️ MetaJammer v0.5.6 — Release Notes

Summary

MetaJammer v0.5.6 brings deep PDF Form XObject user watermark removal with commercial evaluation stamp preservation, embedded thumbnail detection (EXIF IFD1 and JFIF/JFXX), progressive asynchronous metadata loading with UI loading indicators in Metadata Preview, performance optimizations for large PDF scanning, and dependency updates.


🌟 Key Changes & Improvements

1. PDF Form XObject User Watermark Removal & Trial Stamp Preservation

  • Watermark Detection & Scrubbing: Scans PDF page resources for Form XObjects tagged with /PieceInfo /Private /Watermark or /Subtype /Watermark. User-added watermarks (such as sample watermarks added across multi-page documents) are cleanly removed from page resources, and their invocation operators (/Artifact <</Subtype /Watermark...>> BDC ... /FmX Do ... EMC and /<cosName> Do) are thoroughly scrubbed from page content streams.
  • Commercial Software Trial Notice Preservation: Commercial software evaluation/trial notices (e.g., "Click to BUY NOW!", "PDF-XChange Editor", "Demo", "Evaluation") are explicitly recognized and preserved intact, fully honoring F-Droid inclusion requirements and preventing software piracy or licensing concerns.
  • Interactive Navigation Preservation: 100% of interactive document navigation links (/Link), table-of-contents navigation, and internal cross-references remain intact.
  • Image XObject Memory Bypass: Watermark scanning inspects res.isImageXObject(cosName) prior to loading XObjects, preventing PDFBox from decompressing and instantiating heavy raster image objects across dozens or hundreds of pages and drastically speeding up metadata extraction on large PDFs.

2. Embedded Thumbnail Detection

  • Proactive Thumbnail Inspection: Upgraded MetadataRepository.readMetadata to detect and display embedded EXIF thumbnails (IFD1 JPEGInterchangeFormat / StripOffsets), JFIF APP0 thumbnails (including dimensions WxH), and JFXX extension markers directly in the metadata inspection preview.
  • Visual Leak Prevention: Helps users identify embedded sub-raster thumbnail caches before exporting or sharing cropped or edited media.

3. Progressive Metadata Loading & UI Race Condition Hardening

  • Progressive Asynchronous Streaming: Metadata is extracted per-file asynchronously on background IO threads. Smaller/faster files populate immediately in the Metadata Preview screen without waiting for heavier files.
  • Loading State Feedback: Each file card displays a loading spinner and localized "Reading metadata…" indicator while its metadata is being extracted, eliminating premature "No metadata found" displays.
  • Action Gating: The "Continue" button is disabled with an inline spinner while any file's metadata is loading, preventing users from advancing to processing before metadata analysis is complete.
  • Fail-Closed Async Recovery: Isolated error handling ensures that corrupt files or parsing exceptions do not block other files or cause infinite loading loops.

4. Dependency Updates & Localization

  • Dependencies: Bumped Kotlin to 2.4.21 and Kotlinx Serialization to 1.12.0.
  • Localization: Added loading_metadata string resource across all 24 supported languages with 100% string parity.

📦 Build Artifacts

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

v0.5.5

Choose a tag to compare

@GabryDX GabryDX released this 05 Oct 12:07
e73173e

🛡️ MetaJammer v0.5.5 — Release Notes

Summary

MetaJammer v0.5.5 introduces deep PDF hidden annotation and user comment/markup sanitization while preserving clickable navigation links, JPEG JFIF density (DPI) preservation with embedded thumbnail zeroing and JFXX dropping, ultra-low-memory streaming image scrubbers dropping peak heap allocations to 64 KB, streamed PNG metadata inspection skipping raster IDAT chunks, and throttled foreground batch concurrency.


🌟 Key Changes & Improvements

1. PDF Hidden Annotation & Comment / Markup Sanitization

  • Hidden & Invisible Annotation Neutralization: Detects and strips annotations bearing hidden flags (/F 2 Hidden, /F 1 Invisible, /F 32 NoView) as well as Watermarks and Stamps, closing a covert channel where sensitive or steganographic data could be hidden in invisible PDF objects.
  • Interactive Navigation Preservation: Strictly preserves clickable document links (/Link), table-of-contents navigation, and internal cross-references while purging hidden or tracking annotations.
  • User Comments & Markup Purging: Configurably purges reviewer comments and markups (Text, FreeText, Highlight, Underline, Squiggly, StrikeOut, Stamp, Caret, Ink, Popup, FileAttachment, etc.) to remove editor notes, reviewer identities, and attachments.
  • Preview & Diff Inspection: Upgraded PdfMetadataProcessor.readMetadata to surface annotation counts, hidden flags, and author identities in the UI preview and visual diff before processing.
  • Granular Settings: Added dedicated, independent toggle switches in Settings (enabled by default) for stripping PDF hidden annotations and user comments/markups.

2. JPEG JFIF Header DPI Preservation & Thumbnail Sanitization

  • Resolution Density Preservation: Added a configurable setting (enabled by default) to preserve JFIF APP0 headers, retaining physical resolution density (DPI) for photo viewers and print workflows.
  • Embedded Thumbnail Zeroing: When JFIF preservation is active, embedded thumbnail dimensions are zeroed out (xThumbnail = 0, yThumbnail = 0), preventing visual preview data leaks of cropped or edited images.
  • JFXX Extension Thumbnail Stripping: Automatically removes JFXX extension thumbnail markers (APP0 with JFXX\u0000).

3. Streaming Engine Performance & Memory Optimization

  • Streaming JPEG & PNG Scrubbers: Rewrote stripJpegMarkers and stripPngChunks into streaming pipelines streaming directly from InputStream to OutputStream with a fixed 64 KB buffer, eliminating multi-megabyte ByteArray allocations and dropping peak memory consumption from ~150 MB down to 64 KB.
  • Streaming PNG Metadata Reader: Added PngMetadataReader.readMetadata(InputStream) that parses headers and ancillary chunks while seeking over raster IDAT chunks without loading the image raster into memory.
  • Optimized PDF Scanning: Fast pre-check of page.cosObject.containsKey(COSName.ANNOTS) avoids unnecessary annotation array allocations on annotation-free pages, and direct file persistence saves memory.
  • Concurrency Throttling: Foreground multi-file processing is throttled with a concurrency Semaphore (maximum 2 parallel workers) to prevent out-of-memory spikes and thread starvation on low-memory devices.

4. 100% Localization Parity

  • All 24 Supported Locales: Added localized string resources for all 3 new settings across 24 languages: English, Arabic, German, Greek, Spanish, Persian, French, Hebrew, Hindi, Indonesian, Italian, Japanese, Korean, Latin, Dutch, Polish, Portuguese, Romanian, Russian, Thai, Turkish, Ukrainian, Vietnamese, and Chinese (241 strings per locale).

5. Automated Test Suite

  • 139 Passing Unit Tests: Expanded test suite with comprehensive coverage for PDF hidden annotation removal on real-world files (PagedOut_008.pdf), comment filtering, JFIF thumbnail zeroing and JFXX dropping, and streaming-vs-bytearray parity tests.

📦 Build Artifacts

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

v0.5.4

Choose a tag to compare

@GabryDX GabryDX released this 02 Oct 16:25
a1b721e

🛡️ MetaJammer v0.5.4 — Release Notes

Summary

MetaJammer v0.5.4 introduces a standalone pure Kotlin OGG Vorbis & Opus container reader, comment stripper, and metadata poisoner, fixes SVG MIME routing precedence with deep Dublin Core RDF/XML comment stripping, restores 100% string parity across all 24 supported languages, and expands automated test coverage to 133 passing unit tests.


🌟 Key Changes & Improvements

1. Pure Kotlin OGG Vorbis & Opus Engine

  • Zero-Dependency Bitstream Parser: Added OggMetadataReader to parse OGG containers and unpack Vorbis comments (\x03vorbis) and Opus tags (OpusTags) directly at the bitstream level without external native libraries.
  • Lossless Comment Stripping & Poisoning: Strips user comments, GPS coordinates, location tags, contact info, embedded picture blocks (METADATA_BLOCK_PICTURE), and XMP packets without re-compressing or decoding audio elementary streams.
  • Bitstream Integrity & Checksum Recalculation: Recalculates 32-bit OGG page CRC checksums (0x04C11DB7) and maintains strictly consecutive sequence numbering for 100% RFC 3533 compliance and media player compatibility.
  • Magic Byte Detection & Processing Routing: Added OggS magic byte detection in FileRepository and routed OGG containers directly through OggMetadataReader in MediaMetadataProcessor, bypassing Android MediaMuxer codec limitations.

2. SVG Routing & Dublin Core / RDF Sanitization

  • MIME Route Precedence: Prioritized image/svg+xml and application/pdf ahead of generic image/* checks in MetadataRepository, ensuring vector files are never hijacked by raster ExifInterface.
  • Dublin Core & Creative Commons Stripping: Enhanced SvgMetadataProcessor to extract and wipe Dublin Core RDF entries (dc:title, dc:creator, dc:date, dc:coverage, dc:rights, dc:publisher, dc:contributor, dc:subject, dc:identifier, dc:source) and Creative Commons licenses (cc:license).
  • Editor Artifacts & Comment Stripping: Neutralizes editor metadata attributes (inkscape:version, sodipodi:docname), editor view elements (sodipodi:namedview), and full XML comments (<!-- ... -->).
  • Robust Fallback Regex: Upgraded XML stripping patterns to match <metadata>, <title>, and <desc> tags containing arbitrary XML attributes or namespaces.

3. 100% String Parity & Localization Polish

  • Storage Permission Translations: Added the storage_permission_required string to all 23 localized strings.xml resource files, ensuring complete localized guidance for Android 9 users.
  • 100% Parity Across 24 Locales: Verified 100% key parity and placeholder integrity across all 24 supported languages (235 strings each).
  • Hardcoded String Extraction: Extracted hardcoded latitude and longitude hints in LocationPickerScreen to localized string resources (R.string.latitude_hint and R.string.longitude_hint).

4. Expanded Test Suite

  • Comprehensive Test Coverage: 133 automated unit tests passing across all core modules, including end-to-end repository tests, OGG Vorbis bitstream manipulation tests, and SVG Dublin Core extraction tests.

📦 Build Artifacts

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

v0.5.3

Choose a tag to compare

@GabryDX GabryDX released this 02 Oct 14:36
6ecd226

🛡️ MetaJammer v0.5.3 — Release Notes

Summary

MetaJammer v0.5.3 delivers important stability fixes for Android 9, enhanced container-level metadata readers and scrubbers for MP4/MOV and PNG files, comprehensive PDF structure stripping, and hardened MIME type detection across Android's Storage Access Framework.


🌟 Key Changes & Improvements

1. Android 9 (API 28) MediaStore & Storage Fix

  • Resolved Storage Routing Crash: Fixed an abrupt exit when saving processed PDFs and media files to default folders on Android 9 and older ROMs.
  • Standard Scoped Storage Integration: Uses MediaStore.Files.getContentUri("external") for document routing instead of restricted collection URIs on legacy API levels.

2. Native ISO-BMFF / MP4 Container Reader & Fallback Scrubber

  • Direct Box Parsing: Added Mp4MetadataReader to parse metadata directly from ISO-BMFF boxes (moov/udta, ilst, ©xyz, and custom iTunes tags like CameraModel, GPS, Classification, LeadInvestigator) without depending solely on native decoders.
  • Container Scrubber Fallback: Replaces udta and metadata uuid atoms with standard free padding boxes, ensuring 100% metadata sanitization even for non-standard, synthetic, audio-only, or fragmented containers where native remuxers fail.

3. Deep PNG & JPEG Metadata Stripping

  • PNG pHYs & Ancillary Chunks: Added PngMetadataReader and fast-path chunk stripping to parse and completely wipe physical pixel dimension (pHYs), tEXt, zTXt, iTXt, and eXIf chunks.
  • JPEG Marker Stripping: Fast-path byte stream stripping removes COM (0xFFFE) and APP1–APP15 metadata markers without re-encoding image scan data.
  • Compatibility Tag Cleanup: Fixed preview logic so clean images with standard orientation hints don't display dummy 0 values.

4. Comprehensive PDF Structure Sanitization

  • PageLabels & Catalogs: Resets PageLabels and removes private application dictionary entries (PieceInfo, StructTreeRoot) alongside the document information dictionary and XMP metadata stream.

5. Hardened SAF Ingestion & Magic Byte Detection

  • MIME Type Recovery: Recovers missing or generic application/octet-stream MIME types from document picker URIs using sanitized display name extensions and file magic byte headers (%PDF-, \xFF\xD8\xFF, \x89PNG, ftyp, RIFF...WEBP, ID3).

📦 Build Artifacts

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

v0.5.2

Choose a tag to compare

@GabryDX GabryDX released this 01 Oct 10:03
0cbc10d

🛡️ MetaJammer v0.5.2 — Hotfix for Android 14+ / GrapheneOS

Summary

MetaJammer v0.5.2 is a critical stability hotfix resolving an InvalidForegroundServiceTypeException crash encountered during batch metadata processing on Android 14+ (including GrapheneOS on Pixel devices).


🌟 Fixes & Improvements

1. Foreground Service Type Configuration (Android 14+ / targetSdk 37)

  • Declared Foreground Service Type: Configured androidx.work.impl.foreground.SystemForegroundService with android:foregroundServiceType="dataSync" in AndroidManifest.xml.
  • Added Permission: Declared <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />.
  • Updated Worker ForegroundInfo: Passed ServiceInfo.FOREGROUND_SERVICE_TYPE_DATA_SYNC to ForegroundInfo on API 29+ within MetadataProcessingWorker.kt.
  • Defensive Error Handling: Wrapped setForeground() in runCatching to prevent background restriction exceptions from crashing the application.

📦 Build Artifacts

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

v0.5.1

Choose a tag to compare

@GabryDX GabryDX released this 30 Sep 13:56
e5b3734

🛡️ MetaJammer v0.5.1 — F-Droid Compliance & Hardening

Summary

MetaJammer v0.5.1 is a targeted compliance and hardening release ensuring seamless automated builds across F-Droid infrastructure while fortifying the application's air-gapped security posture.


🌟 Key Highlights & What's Changed

1. F-Droid SUSS Scanner Compliance

  • Transparent Landmass Dataset: Replaced the pre-compiled binary map asset (world_land.bin) with a transparent, human-readable JSON dataset (app/src/main/assets/map/world_land.json) parsed via standard FOSS kotlinx.serialization.
  • Zero Binary Blobs: Eliminates the Found binary at app/src/main/assets/map/world_land.bin error during F-Droid build pipeline verification.

2. Network Surface Hardening

  • Explicit Removal of ACCESS_NETWORK_STATE: Added tools:node="remove" for android.permission.ACCESS_NETWORK_STATE in AndroidManifest.xml to prevent transitive library injection from AndroidX WorkManager.
  • True Zero-Network Binary: The compiled release APK now contains literally zero network-related permissions (INTERNET and ACCESS_NETWORK_STATE are both absent).

3. Complete Localization Parity

  • 24 Languages Supported: Added localized translations for all new custom location preset strings across all 23 translation resource directories with 100% string parity.

📦 Build Artifacts

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

v0.5.0

Choose a tag to compare

@GabryDX GabryDX released this 30 Sep 13:35
d5b7baa

🛡️ MetaJammer v0.5.0 — The Air-Gapped Privacy Release

Summary

MetaJammer v0.5.0 is a milestone release delivering 100% air-gapped privacy. We have completely removed the android.permission.INTERNET permission, eliminated the F-Droid TetheredNet Anti-Feature, and replaced the OpenStreetMap WebView with a custom, hardware-accelerated Native Compose Vector World Map powered by a pre-compiled 20 KB binary landmass dataset.


🌟 Key Highlights & What's Changed

1. 100% Offline, Air-Gapped Privacy

  • Zero Network Permissions: Removed <uses-permission android:name="android.permission.INTERNET" /> from the Android manifest. MetaJammer has zero network capability, making data exfiltration technically impossible at the OS permission level.
  • F-Droid Anti-Feature Elimination: Removed the TetheredNet anti-feature flag from F-Droid metadata (metadata/com.heronikostudios.metajammer.yml). MetaJammer is now 100% free of all F-Droid Anti-Features.
  • Zero Friction Navigation: Removed network permission explanation dialogs and the "Enable map picker" toggle in Settings. Tapping "Edit Location" now opens the interactive map instantly with zero warnings.

2. Native Compose Vector World Map Engine

  • Hardware-Accelerated Canvas Rendering: Implemented VectorWorldMap.kt using Jetpack Compose Canvas with native Path rendering and sub-pixel antialiasing.
  • Ultra-Compact Landmass Dataset: Parsed Natural Earth 110m physical land polygons into an optimized binary format (world_land.bin) containing 128 polygon rings and 5,143 vertices in just 20.3 KB—loading in under 2 milliseconds.
  • Smooth Gestures & Interactions:
    • Fluid pinch-to-zoom (1.0x to 15.0x scale) with strict boundary clamping.
    • Drag-to-pan across the globe with inertial clamping.
    • Tap anywhere to reposition the GPS target pin.
    • Double-tap to zoom in toward the tap target.
    • Themed landmass fills, coastline outlines, and graticule grid (Equator, Prime Meridian, 30°/60° parallels).
    • Animated pulsing radar crosshair pin marker.
  • Mathematical Projection (MapProjection.kt): Linear equirectangular forward and inverse transformations between geographic coordinates (latitude, longitude) and virtual canvas coordinates, fully covered by unit tests.

3. Redesigned Location Picker Screen

  • Landmark Preset Chips: Horizontal scrollable row of popular geographic presets (e.g., Null Island, Tokyo, London, Paris, New York, Bermuda Triangle) with smooth animated map centering.
  • Interactive Bottom Control Card:
    • Clean coordinate display in standard decimal degrees (DD.DDDD° N/S, DDD.DDDD° E/W).
    • Manual Coordinate Input Dialog: Tap coordinates to manually enter precise latitude and longitude values, instantly updating and centering the map.
    • Randomize Button: Generate random worldwide coordinates with a single tap.
    • Center on Pin Button: Instantly pan the viewport back to the current pin location.
    • Confirm & Apply Button: Save picked coordinates directly to the file's metadata poisoning plan.

4. Custom Location Presets & Management

  • User-Defined GPS Presets: Added the ability to create, name, select, and delete custom location presets directly in Settings.
  • Interactive Map Picker in Settings: Users can visually pick custom location coordinates using the offline VectorWorldMap modal or manually type precise decimal coordinates.
  • Full App-Wide Integration: Custom presets are seamlessly integrated into the Settings default location picker, batch processing chips, landmark chips in the Location Picker screen, and the metadata poisoning generator with subtle anti-fingerprint drift.

5. Footprint & Memory Reduction

  • Eliminated WebView & JavaScript Engine: Removed all Leaflet CSS and JS assets (app/src/main/assets/leaflet/), reducing disk assets by 160 KB.
  • RAM Savings: Eliminated the ~30 MB memory overhead previously associated with spinning up an Android WebView runtime.
  • Streamlined Binary: Total release APK size remains at a lean 4.9 MB.

6. Documentation, Localization & Compliance


📦 Build Artifacts

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

v0.4.3

Choose a tag to compare

@GabryDX GabryDX released this 29 Sep 15:36
36f615a

🚀 MetaJammer v0.4.3 — Release Notes

Summary

MetaJammer v0.4.3 is a stability and compatibility hardening release focused on backward compatibility for Android 8.0–9.0 devices, resolving library deprecations, and eliminating build pipeline workarounds for official F-Droid inclusion.


🔄 What's Changed in v0.4.3 (from v0.4.2)

1. Android 8.0–9.0 (API 26–28) Backward Compatibility

  • Safe Media Metadata Lifecycle (MediaUtils.useCompat): Replaced standard Kotlin .use { ... } with useCompat across MetadataRepository and MediaMetadataProcessor. This prevents runtime NoSuchMethodError / IncompatibleClassChangeError crashes on API 26–28 where MediaMetadataRetriever did not implement AutoCloseable.
  • OGG Audio Remux Guard: Added an explicit API level check (Build.VERSION_CODES.Q) before attempting native OGG remuxing in MediaMetadataProcessor, gracefully failing closed with an explicit error on legacy Android versions.
  • Notification Permission Guard: Guarded POST_NOTIFICATIONS runtime permission request launcher in MainActivity with Build.VERSION_CODES.TIRAMISU.

2. Library Deprecations & Lifecycle Cleanup

  • Room Database Migration: Upgraded fallbackToDestructiveMigration() to fallbackToDestructiveMigration(dropAllTables = true) in AppDatabase.
  • WorkManager Data Handling: Replaced deprecated inputData.getStringArray() with null-safe inputData.getNullableStringArray() in MetadataProcessingWorker.
  • ViewModel Lifecycle: Removed redundant super.onCleared() call in MainViewModel.

3. Jetpack Compose UI Guidelines Alignment

  • Modifier Parameter Ordering: Positioned modifier: Modifier = Modifier as the first optional parameter across ProcessingScreen, QuickScrubScreen, and SettingsScreen in accordance with Android Compose API conventions.

4. F-Droid Pipeline & Metadata Hardening

  • Zero-Sed Build Recipe: Switched from signingConfigs.getByName("release") to null-safe signingConfigs.findByName("release")?.let { ... } in app/build.gradle.kts. This allows F-Droid's build server to cleanly strip signing blocks without crashing Gradle or requiring prebuild: sed scripts.
  • Zero-Scanignore Configuration: Removed external Gradle foojay-resolver plugin from settings.gradle.kts to eliminate scanner flags (suss.json).
  • Fastlane & Metadata Polish: Shortened Fastlane short_description.txt to 69 characters (complying with F-Droid's 80-char limit) and formatted YAML prebuild as an inline scalar string for fdroid rewritemeta.
  • Fastlane Changelog: Added fastlane/metadata/android/en-US/changelogs/4.txt.

5. Version Bump

  • Bumped versionName to 0.4.3 and versionCode to 4.