Create README.MD

This commit is contained in:
theipw
2026-02-17 18:57:33 +00:00
committed by GitHub
parent 4d1b7149dc
commit 55beff0918
+38
View File
@@ -0,0 +1,38 @@
# Private Amazon Wrapper (Android)
A hardened, open-source WebView wrapper for Amazon.co.uk designed to provide a "Digital Faraday Cage" for your shopping experience. This app eliminates background telemetry, strips tracking headers, and isolates your Amazon session from the rest of your device.
## 🛡️ Privacy Features
Unlike the official Amazon app or standard mobile browsers, this wrapper implements several layers of active privacy hardening:
* **X-Requested-With Stripping**: Prevents Amazon from identifying that you are using a specific Android app, masking your traffic as a standard mobile browser.
* **Telemetry & Ad Blocking**: Includes a built-in `filters.txt` that actively intercepts and drops requests to known Amazon tracking endpoints (e.g., `fls-eu`, `unagi`, `device-metrics`).
* **Fingerprint Mitigation**: Injects custom JavaScript to break common browser fingerprinting techniques:
* Disables **WebRTC** to prevent local IP leaks.
* Muffles **Canvas & WebGL** reporting.
* Reduces hardware concurrency reporting to a generic value.
* **Zero Permissions**: This app requires **zero** Android permissions. It cannot access your location, contacts, camera, microphone, or external storage.
* **Cookie Isolation**: Blocks all third-party cookies by default, preventing cross-site tracking while maintaining your login session for Amazon.co.uk.
* **HTTPS Enforcement**: Hardened via `network_security_config` to deny all cleartext (HTTP) traffic.
## 🚀 Technical Implementation
* **Language**: Kotlin
* **Engine**: Android System WebView (Chromium-based)
* **UI**: Edge-to-edge support with dynamic status bar insets to prevent UI overlap.
* **Persistence**: Uses `CookieManager.flush()` to ensure login sessions survive app restarts without compromising privacy.
## 🛠️ How to Build
1. Clone the repository.
2. Open in **Android Studio**.
3. Ensure you have a `filters.txt` file in `app/src/main/assets/`.
4. Build the APK: `Build > Build Bundle(s) / APK(s) > Build APK(s)`.
## 📜 License
This project is licensed under the **GNU GPLv3** - see the [LICENSE](LICENSE) file for details. This ensures the code remains free, open, and private for everyone.
---
*Disclaimer: This is an independent open-source project and is not affiliated with, authorized, maintained, sponsored, or endorsed by Amazon.com, Inc. or any of its affiliates.*