# SocketFlip

> SocketFlip is a free, open-source Android app (GPL-3.0-or-later) that shows a floating button. One tap gives one chosen app a clean, instant network reconnect. Current version: 1.16. Requires Android 10 or newer.

Key facts:
- How it works: whenever a VPN covering an app starts or stops, Android closes that app's open TCP connections. SocketFlip runs a tiny per-app VPN that routes one unused private address (10.111.222.2), so the chosen app's real traffic still goes over normal Wi-Fi or mobile data. There is no server and nothing leaves the phone.
- It has no INTERNET permission, collects nothing and sends nothing. No accounts, analytics or ads.
- It resets TCP only. UDP traffic (voice and video calls, QUIC/HTTP/3) is not reset.
- Each reconnect is one tap by the user. There is no automatic or timed mode, by design.
- Not on the Google Play Store, because Google restricts the VPN API to VPN-type apps. Installed as an APK from GitHub releases; Obtainium can keep it updated.
- Common uses: unsticking an app stuck on "Connecting..." after a network change; testing an app's reconnect handling; skipping the combat replay in Hearthstone Battlegrounds, where the server has already decided the fight and a reconnect returns the player to the shop.
- Not affiliated with any game or app developer. Forcing reconnects in an online game may break that game's terms of service.
- Developed with AI assistance; all source code is public.

## Pages
- [Home](https://socketflip.app/): what it is and what it is for
- [Install guide](https://socketflip.app/install/): downloading the APK, Play Protect, first run
- [Is it safe?](https://socketflip.app/safety/): every install warning and permission explained, why it uses a VPN
- [FAQ](https://socketflip.app/faq/): troubleshooting and common questions
- [Hearthstone Battlegrounds](https://socketflip.app/hearthstone-battlegrounds/): skipping combat on Android
- [Privacy](https://socketflip.app/privacy/)

## Source
- [GitHub repository](https://github.com/socketflip-app/socketflip)
- [Latest release (APK)](https://github.com/socketflip-app/socketflip/releases/latest)
- [Full documentation as one text file](https://socketflip.app/llms-full.txt)