Skip to content

IG Guard v4.4

Choose a tag to compare

@Derek317 Derek317 released this 01 Nov 09:16
· 35 commits to main since this release

Changelog — IG Teen Guard (v4.0 to v4.4)

v4.4 — Precision DM Geometry, Comment/Story Filtering & Child Account Separation (Latest)

  • Shrunk 1-on-1 DM Reading Area to Incoming Left Bubbles Only: Restricted active chat scanning vertically to the 22% band directly above the message composer (composerTop - 0.22 * screenHeight .. composerTop) and horizontally to left-aligned incoming bubbles (left <= 27% of screen width, right <= 86%), preventing the child's own right-aligned sent messages from triggering false alerts.

  • True 1-on-1 DM vs. Post Comments & Stories Distinction: Verified 1-on-1 DM conversations by checking for top-header Audio/Video Call buttons (call / 通話) and excluding Post Comment sheets (Comments / 留言 / 新增留言) and Story viewers (Send message / 傳送訊息). When the child views Post Comments or Stories, other users' comments and story captions are ignored; only replies actively typed by the child inside the editable input box (isEditable) are inspected.

  • Dedicated Child Self Handle (child_self_handle): Added a separate setting for the child's own Instagram account ID (e.g., @zuck), keeping it distinct from the Approved IG Friends (trusted_csv) and Flagged Offenders lists so approving a friend never mixes in the child's own account and notification headers always resolve to the stranger's handle.

v4.3 — Flagged Offenders Watchlist & Uninterrupted Parent Supervision

  • Fixed Self-Handle Poisoning Bug: Removed rememberChildOwnHandle(), which previously misclassified stranger handles when EXTRA_CONVERSATION_TITLE differed from sender_person (android.app.Person on Android 9+), ensuring follow-up messages after the first alert are never ignored.

  • Added Persistent Flagged Offenders Watchlist (已封鎖高危帳號): Any account that sends sexual or grooming content is added to flagged_offenders_csv.

    • Child Phone (Blocked): Immediately exits the chat (GLOBAL_ACTION_BACK) if the child tries to open a flagged offender's DM thread and wipes incoming notifications (cancelNotification) from that offender.

    • Parent Phone (Full Visibility): Continues forwarding every follow-up message from a flagged offender (even non-sexual text) to the Parent Phone as a high-priority 🔴 色情 / 高危封鎖對象訊息 alert with a 3-second burst deduplication window (NOTIF_BURST_DEDUPE_MS = 3_000L).

  • One-Tap Parent Un-Ban: Approving a handle from the Parent Phone (+ Approve) automatically removes it from flagged_offenders_csv and syncs to the Child Phone.

v4.2 — End-to-End Encryption, Random 30–95m Heartbeats & Stronger Authentication

  • End-to-End Encryption (AES-256-GCM over TLS): Enforced HttpsURLConnection and encrypted all payloads (alert, heartbeat, sync_trusted, unlock_code, key_rotated, remote_reset_child) using AES/GCM/NoPadding with a fresh 96-bit SecureRandom IV and 128-bit authentication tag derived from the 128-bit Family Key.

  • Random 30–95 Minute Heartbeat & 100-Minute Offline Watchdog: Added a randomized 30–95 minute background heartbeat on the Child Phone reporting permission states (ON ✅ / OFF ❌), paired with a Parent Phone watchdog that fires an urgent offline/uninstall alert if more than 100 minutes pass without a heartbeat.

  • Remote Key Rotation & Forgotten-Password Rescue: Added Parent Phone controls to rotate the Family Key (automatically updating the Child Phone over the encrypted channel) or remotely unlock and reset the Child Phone (remote_reset_child) if the Master Password is forgotten.

  • Bottom-Only Active Chat Scan & Status Label Filter: Added NON_MESSAGE_UI_PATTERN to filter out Instagram delivery/presence strings ("Recently seen", "Seen 5m ago", "Active now", "已讀", "最近上線", timestamps) and stopped scanning upper-screen historical messages.

  • 8+ Character Alphanumeric Master Password & Brute-Force Lockout: Upgraded the Parent Master Password from a 4-digit PIN to an 8+ character alphanumeric password, upgraded the 15-minute temporary unlock code to 6 alphanumeric characters, and added a 10-minute lockout (plus parent tamper alert) after 5 failed attempts.

v4.1 — Active DM Access Fix & 15-Minute Temporary Unlock Code Generator

  • Fixed Instant-Quit When Entering DM Inbox: Removed the overly broad "通知+訊息+關閉" mute check and stopped scanning 1-line thread previews on the DM Inbox list so children can open their DM Inbox and chat normally while active-chat interception runs in the background.

  • Added 15-Minute Temporary Unlock Code Generator: Added a Parent Phone generator that creates a temporary unlock code (valid via offline SHA-256 15-minute time buckets and live channel sync) to unlock the Child Phone for 15 minutes with a live countdown timer—without revealing the Master Password.

v4.0 — Guided Permission Wizard, 128-Bit Collision-Free Pairing & In-Place Updates

  • Automatic 2-Step Permission Popup Wizard (AlertDialog): Added automatic onboarding popups on the Child Phone that jump directly to Notification Access and Accessibility Settings (using :settings:fragment_args_key to highlight IG Guard) plus a 1-tap shortcut to App Info to unlock Android 13+ "Restricted Settings".

  • 128-Bit UUID Family Pairing & 4-Emoji Fingerprint: Replaced short manual pairing codes with a 128-bit UUID.randomUUID() Family Key shared via 1-tap WhatsApp/SMS invite (igguard://pair deep link or clipboard auto-paste) and verified with a 4-emoji visual fingerprint on both phones.

  • In-Place APK Updates & Scoped Accessibility Config: Embedded a persistent 2048-bit RSA keystore and auto-incrementing versionCode (100 + github.run_number) in build-apk.yml so updates install directly over existing versions without uninstalling, and scoped accessibility_config.xml strictly to Instagram and Settings packages.