39 lines
2.3 KiB
Markdown
39 lines
2.3 KiB
Markdown
# 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.*
|