Repository navigation
IG Guard v4.4
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 theApproved IG Friends(trusted_csv) andFlagged Offenderslists 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 whenEXTRA_CONVERSATION_TITLEdiffered fromsender_person(android.app.Personon Android 9+), ensuring follow-up messages after the first alert are never ignored. -
Added Persistent
Flagged OffendersWatchlist (已封鎖高危帳號): Any account that sends sexual or grooming content is added toflagged_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 fromflagged_offenders_csvand syncs to the Child Phone.
v4.2 — End-to-End Encryption, Random 30–95m Heartbeats & Stronger Authentication
-
End-to-End Encryption (
AES-256-GCMover TLS): EnforcedHttpsURLConnectionand encrypted all payloads (alert,heartbeat,sync_trusted,unlock_code,key_rotated,remote_reset_child) usingAES/GCM/NoPaddingwith a fresh 96-bitSecureRandomIV 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_PATTERNto 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-25615-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_keyto highlightIG 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://pairdeep 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) inbuild-apk.ymlso updates install directly over existing versions without uninstalling, and scopedaccessibility_config.xmlstrictly to Instagram and Settings packages.