Repository navigation
Releases
v0.6.1
🛡️ 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)
v0.6.0
🛡️ 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: Modifiesmetachild atoms (iinf,iloc,iref) and padsmetawith standard ISO-BMFFfreeboxes so it retains its exact original byte length. The massivemdatmedia data box, all image extents, and internalidatitems remain 100% bit-exact and unshifted. - Multi-Tile iPhone Grid Support: Corrected 12-bit reserved / 4-bit
construction_methodnibble ordering inilocversions 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
thumbnailItemIdsfromirefprior toiinffiltering, dropping thumbnail items from bothiinfandilocsimultaneously 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 inmdat(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
ExifInterfacelimitations, 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 fromAndroidManifest.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 intodocs/FOSS_AUDIT.mdanddocs/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_descacross 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_bodyacross all 24 locales to explicitly recognizeHEIF/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_heiffull-resolution image decoding (100% tests passing).
📦 Build Artifacts
- Package:
com.heronikostudios.metajammer - Version:
0.6.0(Code12) - 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
🛡️ 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 /Watermarkor/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 ... EMCand/<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.readMetadatato detect and display embedded EXIF thumbnails (IFD1JPEGInterchangeFormat/StripOffsets), JFIF APP0 thumbnails (including dimensionsWxH), 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.21and Kotlinx Serialization to1.12.0. - Localization: Added
loading_metadatastring resource across all 24 supported languages with 100% string parity.
📦 Build Artifacts
- Package:
com.heronikostudios.metajammer - Version:
0.5.6(Code11) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
v0.5.5
🛡️ 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 2Hidden,/F 1Invisible,/F 32NoView) 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.readMetadatato 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 (
APP0withJFXX\u0000).
3. Streaming Engine Performance & Memory Optimization
- Streaming JPEG & PNG Scrubbers: Rewrote
stripJpegMarkersandstripPngChunksinto streaming pipelines streaming directly fromInputStreamtoOutputStreamwith a fixed 64 KB buffer, eliminating multi-megabyteByteArrayallocations 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 rasterIDATchunks 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(Code10) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
v0.5.4
🛡️ 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
OggMetadataReaderto 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
OggSmagic byte detection inFileRepositoryand routed OGG containers directly throughOggMetadataReaderinMediaMetadataProcessor, bypassing AndroidMediaMuxercodec limitations.
2. SVG Routing & Dublin Core / RDF Sanitization
- MIME Route Precedence: Prioritized
image/svg+xmlandapplication/pdfahead of genericimage/*checks inMetadataRepository, ensuring vector files are never hijacked by rasterExifInterface. - Dublin Core & Creative Commons Stripping: Enhanced
SvgMetadataProcessorto 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_requiredstring to all 23 localizedstrings.xmlresource 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
LocationPickerScreento localized string resources (R.string.latitude_hintandR.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(Code9) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
v0.5.3
🛡️ 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
Mp4MetadataReaderto parse metadata directly from ISO-BMFF boxes (moov/udta,ilst,©xyz, and custom iTunes tags likeCameraModel,GPS,Classification,LeadInvestigator) without depending solely on native decoders. - Container Scrubber Fallback: Replaces
udtaand metadatauuidatoms with standardfreepadding 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
PngMetadataReaderand fast-path chunk stripping to parse and completely wipe physical pixel dimension (pHYs),tEXt,zTXt,iTXt, andeXIfchunks. - 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
0values.
4. Comprehensive PDF Structure Sanitization
- PageLabels & Catalogs: Resets
PageLabelsand 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-streamMIME 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(Code8) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
v0.5.2
🛡️ 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.SystemForegroundServicewithandroid:foregroundServiceType="dataSync"inAndroidManifest.xml. - Added Permission: Declared
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />. - Updated Worker
ForegroundInfo: PassedServiceInfo.FOREGROUND_SERVICE_TYPE_DATA_SYNCtoForegroundInfoon API 29+ withinMetadataProcessingWorker.kt. - Defensive Error Handling: Wrapped
setForeground()inrunCatchingto prevent background restriction exceptions from crashing the application.
📦 Build Artifacts
- Package:
com.heronikostudios.metajammer - Version:
0.5.2(Code7) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
v0.5.1
🛡️ 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 FOSSkotlinx.serialization. - Zero Binary Blobs: Eliminates the
Found binary at app/src/main/assets/map/world_land.binerror during F-Droid build pipeline verification.
2. Network Surface Hardening
- Explicit Removal of
ACCESS_NETWORK_STATE: Addedtools:node="remove"forandroid.permission.ACCESS_NETWORK_STATEinAndroidManifest.xmlto prevent transitive library injection from AndroidX WorkManager. - True Zero-Network Binary: The compiled release APK now contains literally zero network-related permissions (
INTERNETandACCESS_NETWORK_STATEare 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(Code6) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
v0.5.0
🛡️ 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
TetheredNetanti-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.ktusing Jetpack ComposeCanvaswith nativePathrendering 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.
- Clean coordinate display in standard decimal degrees (
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
VectorWorldMapmodal 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
- FOSS & Security Audits: Updated
foss_audit.mdandsecurity_audit.mdto formally reflect the air-gapped architecture, zero network surface, and OWASP MASVS-NETWORK / MASVS-PLATFORM compliance. - 100% Localization Parity: Added localized strings for custom location presets across all 24 supported languages with complete string parity.
- Store Metadata & Readme: Updated
README.md,fastlane/metadata/android/en-US/full_description.txt, andfastlane/metadata/android/en-US/changelogs/5.txt.
📦 Build Artifacts
- Package:
com.heronikostudios.metajammer - Version:
0.5.0(Code5) - Target SDK: 37 (Android 16) | Min SDK: 26 (Android 8.0)
v0.4.3
🚀 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 { ... }withuseCompatacrossMetadataRepositoryandMediaMetadataProcessor. This prevents runtimeNoSuchMethodError/IncompatibleClassChangeErrorcrashes on API 26–28 whereMediaMetadataRetrieverdid not implementAutoCloseable. - OGG Audio Remux Guard: Added an explicit API level check (
Build.VERSION_CODES.Q) before attempting native OGG remuxing inMediaMetadataProcessor, gracefully failing closed with an explicit error on legacy Android versions. - Notification Permission Guard: Guarded
POST_NOTIFICATIONSruntime permission request launcher inMainActivitywithBuild.VERSION_CODES.TIRAMISU.
2. Library Deprecations & Lifecycle Cleanup
- Room Database Migration: Upgraded
fallbackToDestructiveMigration()tofallbackToDestructiveMigration(dropAllTables = true)inAppDatabase. - WorkManager Data Handling: Replaced deprecated
inputData.getStringArray()with null-safeinputData.getNullableStringArray()inMetadataProcessingWorker. - ViewModel Lifecycle: Removed redundant
super.onCleared()call inMainViewModel.
3. Jetpack Compose UI Guidelines Alignment
- Modifier Parameter Ordering: Positioned
modifier: Modifier = Modifieras the first optional parameter acrossProcessingScreen,QuickScrubScreen, andSettingsScreenin accordance with Android Compose API conventions.
4. F-Droid Pipeline & Metadata Hardening
- Zero-Sed Build Recipe: Switched from
signingConfigs.getByName("release")to null-safesigningConfigs.findByName("release")?.let { ... }inapp/build.gradle.kts. This allows F-Droid's build server to cleanly strip signing blocks without crashing Gradle or requiringprebuild: sedscripts. - Zero-Scanignore Configuration: Removed external Gradle
foojay-resolverplugin fromsettings.gradle.ktsto eliminate scanner flags (suss.json). - Fastlane & Metadata Polish: Shortened Fastlane
short_description.txtto 69 characters (complying with F-Droid's 80-char limit) and formatted YAMLprebuildas an inline scalar string forfdroid rewritemeta. - Fastlane Changelog: Added
fastlane/metadata/android/en-US/changelogs/4.txt.
5. Version Bump
- Bumped
versionNameto0.4.3andversionCodeto4.