From 3aabf4797b8d07a25bae9045c465eeae04401016 Mon Sep 17 00:00:00 2001
From: theipw <102994625+theipw@users.noreply.github.com>
Date: Tue, 17 Feb 2026 19:02:22 +0000
Subject: [PATCH] Create README.md

---
 README.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4203041
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Private Facebook Wrapper (Android)
+
+A high-security, open-source WebView wrapper for Facebook, engineered to provide a "Digital Faraday Cage" for your social media usage. This app is designed to break Facebook's cross-app tracking and hardware fingerprinting.
+
+## 🛡️ Advanced Privacy Features
+
+This wrapper goes beyond standard "privacy browsers" by implementing deep-level request interception:
+
+*   **Controlled Fetch Engine**: Unlike standard wrappers, this app intercepts Main Frame GET requests and performs a manual fetch. This allows for:
+    *   **Total X-Requested-With Stripping**: Completely removes the header that identifies the Android app to Facebook's servers.
+    *   **Strict Content Security Policy (CSP)**: Enforces a custom CSP that prevents Facebook from loading scripts or tracking pixels from third-party domains.
+*   **Fingerprint Mitigation**: Injects a hardened JavaScript layer to:
+    *   **Disable WebRTC**: Prevents your local/VPN IP address from being leaked via STUN servers.
+    *   **Canvas/WebGL Muffling**: Returns empty data for canvas read-back attempts used in hardware sketching.
+    *   **Hardware Masking**: Reports generic values for CPU cores and device plugins.
+*   **Zero Permissions**: Requires **no access** to your contacts, location, microphone, camera, or files.
+*   **Network Hardening**: Uses `network_security_config` to force HTTPS and block all cleartext traffic at the OS level.
+
+## 🚀 Technical Stack
+
+*   **Language**: Kotlin
+*   **Architecture**: Intercept-and-Modify (using `shouldInterceptRequest` and `HttpURLConnection`).
+*   **UI**: Edge-to-edge layout with dynamic Window Inset handling for modern Android status bars.
+*   **Persistence**: Session cookies are flushed to disk on page finish to ensure login persistence without background syncing.
+
+## 🛠️ How to Build
+
+1. Clone the repository.
+2. Open in **Android Studio**.
+3. Ensure `filters.txt` is present in `app/src/main/assets/`.
+4. Build APK: `Build > Build Bundle(s) / APK(s) > Build APK(s)`.
+
+## 📜 License
+
+Licensed under the **GNU GPLv3**. This ensures the code remains open, transparent, and free from corporate enclosure.
+
+---
+*Disclaimer: This is an independent open-source project and is not affiliated with, authorized, maintained, sponsored, or endorsed by Meta Platforms, Inc.*