VPN4TV Native

Native Kotlin VPN client for Android TV, built on sing-box core with embedded protocol bridges for xhttp, Outline SS, and AmneziaWG.

Features JNI in-process — sing-box core via libbox.aar, no gRPC/TCP localhost issues Xray bridge — xhttp/splithttp transport support via embedded xray-core Outline bridge — SIP002 prefix Shadowsocks via embedded outline-sdk AmneziaWG bridge — WireGuard/AmneziaWG via embedded wireproxy-awg Proxy mode (SOCKS5) — for devices without VPN permission dialog (SberBox etc.) Subscription formats — URI links (vless/hy2/trojan/ss/wg), Xray JSON, sing-box JSON, AmneziaVPN vpn://, .conf/.wg/.vpn files Telegram bot — add subscription via @VPN4TV_Bot (10-digit code) Server selection — URLTest auto-select + manual switching with delay display D-pad navigation — designed for TV remote control LAN bypass — Chromecast, Plex/NAS, router admin work while VPN is on Auto-refresh on expired — detects expired subscription and refreshes before connecting Subscription info — shows expiry date and traffic usage from provider headers Play Core in-app update — force-prompt for critical hotfixes (graceful no-Play fallback) Logs viewer — real-time logs with level filtering, default Warn+ Multiple subscriptions — add, update, switch between profiles with collision-free naming

Supported protocols Protocol URI Xray JSON Bridge VLESS (+ Reality, XTLS Vision) vless:// "protocol": "vless" sing-box native VLESS xhttp/splithttp vless:// "protocol": "vless" Xray bridge Hysteria2 hy2:// — sing-box native Trojan trojan:// "protocol": "trojan" sing-box native Shadowsocks ss:// "protocol": "shadowsocks" sing-box native Shadowsocks SIP002 prefix ss://?prefix= — Outline bridge VMess vmess:// "protocol": "vmess" sing-box native WireGuard / AmneziaWG wg://, vpn://, .conf — wireproxy-awg bridge

Transports: TCP, WebSocket, gRPC, HTTP/2, xHTTP, splitHTTP, HTTPUpgrade.