About this project

# PokerTH Web Client A browser-based Texas Hold'em poker client for PokerTH servers, reachable at https://webclient.pokerth.net/. Players can connect to any PokerTH server through a WebSocket-to-TCP proxy without installing anything. ## Capabilities - **Zero install** — open a URL and play immediately; available as an installable PWA for fullscreen app experience on iOS and Android - **Three play modes**: join the public pokerth.net server over TLS, connect to a LAN/dedicated server, or play offline training mode against bots with no connection required - **Full Texas Hold'em implementation** — flying card deals, sliding chips, 3D card flips, emoji reactions, in-game chat, hand logs, and action bar with quick-bets and auto-modes - **Responsive design** — works on desktop, tablet, and phone with portrait and landscape seat layouts - **Account sync** — registered accounts sync all settings (config.xml-compatible plus web-only preferences like themes, keyboard shortcuts, voice, vibration, and bot difficulty) across devices - **Deep theming** — table felt, card deck, card back, and seat style picker with 14+ official styles, 4 built-in decks, and import support for custom .zip styles - **53 languages** localized, with instant switching - **Lobby features** — real-time table list with filters, player search, lobby chat, private messages, forum news, ranking leaderboards (PokerTH, BBC, WEC), operator polls, and avatar gallery with 500+ emoji icons - **In-game assistance** — pre-flop hand-strength hints (Sklansky-Malmuth), post-flop Monte Carlo win probability, voice announcements, vibration feedback, and configurable blinds display (BB or chip values) - **Tracking the official QML client** — F-key shortcuts, admin tools, sounds, full chat, seat placement, and behavior kept in sync as the official client evolves ## Self-Hosting The client can be self-hosted via Docker, a one-liner install, or manual installation on Ubuntu/Debian. A Raspberry Pi build is available. The self-hosted proxy enables registered account settings sync for connections routed through it. The admin panel includes default theme configuration, service management, MySQL mirror option, and leaderboard reset. ## Architecture The web client uses a WebSocket-to-TCP proxy that bridges browser WebSocket connections to the TCP protocol used by PokerTH servers. TLS is supported for secure connections. Game data flows through the proxy, with registered account settings stored on the proxy server after successful authentication. ## Known Limitations See the project README for known issues. Private messages are lobby-only as the PokerTH server refuses messages aimed at seated players. ## License AGPL v3