[ This APK Doesn't require the "Advanced Flow" to install on Android Devices. ]
FocusGram Logo # FocusGram **Use Instagram on your terms** [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL_3.0-blue.svg?style=for-the-badge)](LICENSE) [![Android](https://img.shields.io/badge/Android-8.0%2B-3DDC84.svg?style=for-the-badge&logo=android&logoColor=white)](https://developer.android.com) [![Release](https://img.shields.io/github/v/release/Ujwal223/FocusGram?style=for-the-badge&color=0969da)](https://github.com/Ujwal223/FocusGram/releases) [![Downloads](https://img.shields.io/github/downloads/Ujwal223/FocusGram/total?style=for-the-badge&color=fa8900)](https://github.com/Ujwal223/FocusGram/releases) [![Uptodown](https://img.shields.io/badge/Uptodown-Download-00A859?style=for-the-badge&logo=android&logoColor=white)](https://focusgram.en.uptodown.com/android) [![Support](https://img.shields.io/badge/Support-BuyMeMomo-FFDD00.svg?style=for-the-badge&logo=buymeacoffee&logoColor=black)](https://buymemomo.com/ujwal) [![Security Audit](https://img.shields.io/badge/Security_Audit-Passed_(MASVS)-success?style=for-the-badge&logo=shield)](Reports/SECURITY_REPORT.md)
--- ## The Problem & The Solution

FocusGram App Demo

Instagram is designed to hook your attention with autoplay videos, endless feeds, and nonstop recommendations. Most people do not want to quit Instagram entirely. You just want to chat with friends, check stories, and share photos without losing hours down an endless Reels rabbit hole. FocusGram fixes this without modifying Instagram's app or using private APIs. It loads the clean mobile web version of Instagram inside a private, secure browser with built-in uBlock Origin. Ads get blocked, distractions stay hidden, and healthy timers keep you in control. Everything runs directly on your device, so your data and login stay completely private. --- ## FocusGram vs Official Instagram | Feature | Official Instagram | FocusGram | | :--- | :---: | :---: | | **Ads & Sponsored Content** | Everywhere in feeds & stories | Completely blocked (uBlock Origin) | | **Reels** | Endless scrolling trap | Block entirely or set timed sessions (1-30 min) | | **Feed & Explore** | Constant recommendations | Option to blur or hide feeds until tapped | | **Video Autoplay** | Plays automatically | Blocked, videos only play when you tap them | | **Screen Time Limits** | Basic reminders | Strict daily limits and habit insights | | **Mindfulness Gates** | None | Optional reflection pause, cooldowns, or typing challenge | | **App & Chat Lock** | None | Lock the entire app or specific chats with PIN / Fingerprint | | **Link Tracking** | Appends tracking tags (`igsh`, `fbclid`) | Automatically stripped before opening or sharing | | **Data Privacy** | Telemetry and tracking | Zero tracking, zero analytics, 100% on-device | --- ## Core Capabilities

Focus Guardrails

  • Timed Reel Sessions: Watch Reels in structured blocks (1-30 min) before a gentle pause.
  • Daily Screen Time Limits: Set strict daily quotas for overall usage.
  • Mindfulness Breath Gate: A reflection pause before entering the app.
  • Cooldown Periods: Enforce mandatory break intervals between sessions.

Calm Feeds & Content Control

  • Blur Explore & Feed: Keep recommendation grids blurred until tapped.
  • Autoplay Blocker: Prevents intrusive video playback from hijacking attention.
  • Minimal Mode: Strips unnecessary clutter down to essential DMs and Feed.
  • Grayscale Filter: Eliminates vibrant dopamine colors on demand or on schedule.

Privacy & Security Locks

  • Biometric & PIN App Lock: Secure the entire app behind Android Keystore authentication.
  • Individual Chat Lock: Lock specific sensitive direct message conversations with separate PINs.
  • Link Sanitizer: Strips fbclid and tracking parameters before sharing.
  • Zero Data Transmission: No telemetry, no analytics, no third-party network SDKs.

Native Android Experience

  • Modern Onboarding: Clear guided setup explaining permissions and boundaries.
  • Update Checker: In-app GitHub release notifications with one-tap downloads.
  • Dynamic Launcher Icons: Custom app icons including OLED Pitch Black, Abstract, and Classic.
  • Reel History & Local Snapshots: Save and revisit content stored completely offline in Room DB.
--- ## Quick Start ### Installation - **Direct APK**: Download the latest release from [GitHub Releases](https://github.com/Ujwal223/FocusGram/releases). Available in architecture splits (`arm64-v8a`, `armeabi-v7a`, `x86_64`) and Universal APK. - **Uptodown**: Download verified builds on [FocusGram on Uptodown](https://focusgram.en.uptodown.com/android). - **Uncloned Edition (`com.instagram.android`)**: Replace the official Instagram app directly on your device via our [Uncloned Distribution Channel](https://focusgram.blogspot.com/). --- ### Building from Source #### Prerequisites - Android 8.0+ (API Level 26+) - JDK 21 (Temurin / Adoptium recommended) - Android SDK Command-line Tools (Build-Tools 35.0.0) #### Build Commands ```bash # Clone repository git clone https://github.com/Ujwal223/FocusGram.git cd FocusGram # Run unit tests ./gradlew :app:testDebugUnitTest # Build debug APK ./gradlew :app:assembleDebug # Build standard release APKs (Universal & ABI splits) ./gradlew :app:assembleRelease # Build uncloned edition with official package name (com.instagram.android) ./gradlew :app:assembleRelease -PuseInstaPackage=true # Or launch the interactive build selector ./build-release.sh ``` --- ## Security & Privacy Boundary > [!IMPORTANT] > **Why FocusGram Presents Instagram's Web Login Screen:** > Meta does not offer public OAuth or user-generated app passwords for third-party consumer apps. To connect to Instagram securely without risking account bans or scraping violations, FocusGram loads the official web login directly from `https://www.instagram.com/` inside an isolated Mozilla GeckoView browser session. - **Zero Credential Interception**: The login interface is rendered inside GeckoView as a sealed black box. FocusGram's Kotlin codebase cannot inspect, intercept, or log passwords or 2FA codes. - **Strictly Local Storage**: All settings, screen time stats, and session records stay encrypted on your phone. - **No Third-Party SDKs**: Zero Google Firebase, zero analytics, zero crash reporting services, and zero network calls from Kotlin to external servers. ### Independent Security Audit (AI Agents) FocusGram undergoes deep automated architectural and security reviews conducted by autonomous AI Security Research Agents. The full independent assessment report, threat model analyses, and OWASP MASVS compliance verification are published directly in the repository: * **[Security Architecture & Audit Report](Reports/SECURITY_REPORT.md)**: Comprehensive review covering trust boundaries, OWASP MASVS compliance, KeyStore cryptographic hardening, direct message notification sandboxing, DOM injection defenses, and zero-backup rules. For detailed security architecture, threat model explanations, and vulnerability disclosure instructions, see **[SECURITY.md](SECURITY.md)**. For contribution guidelines and development standards, see **[CONTRIBUTING.md](CONTRIBUTING.md)**. --- ## Frequently Asked Questions **Will this get my Instagram account banned?** No. FocusGram's web traffic is identical to accessing Instagram inside a standard Firefox or Chrome browser on Android. FocusGram does not use Instagram's private internal API, does not automate actions, and does not scrape content. **Can I use FocusGram alongside the official Instagram app?** Yes! The default release uses package name `com.ujwal.focusgram` so it installs side-by-side with Instagram. If you wish to replace the official app completely so system links open in FocusGram automatically, build or download the Uncloned Edition (`com.instagram.android`). --- ## Legal Disclaimer FocusGram is an independent, free, and open-source productivity tool licensed under AGPL-3.0. It is not affiliated with, endorsed by, or associated with Meta Platforms, Inc. or Instagram in any way. - **How it works**: FocusGram embeds a sandboxed browser engine (Mozilla GeckoView) that loads `instagram.com`, the same website accessible in any mobile browser. All user-facing features operate exclusively via client-side modifications and are never transmitted to or processed by Meta's servers. - **What we do not do**: - Use or alter Instagram's or Meta's private APIs - Intercept, read, log, or store user credentials, session data, or sensitive content - Modify any server-side Meta or Instagram services - Scrape, harvest, or collect any user data - Claim ownership of any Meta or Instagram trademarks, logos, or intellectual property - **Terms**: Using FocusGram is functionally equivalent to accessing Instagram through a mobile web browser with a content blocker extension. By using FocusGram, you acknowledge that you remain bound by Instagram's Terms of Service. For legal concerns, contact `notujwal@proton.me` before taking any other action. --- ## License & Support Copyright (c) 2025-2026 [Ujwal Chapagain](https://github.com/Ujwal223). Licensed under the [GNU Affero General Public License v3.0 (AGPL-3.0)](LICENSE). If FocusGram has helped you regain control of your attention, support continuous open-source development: [![Buy Me a Momo](https://img.shields.io/badge/-%F0%9F%A5%9F%20Buy%20Me%20a%20Momo-FF6B35?style=for-the-badge&labelColor=1a1a1a)](https://buymemomo.com/ujwal)