Skip to content
SpaceSquare640 edited this page Jul 11, 2026 · 3 revisions

PokéTrack Wiki

PokéTrack is an unofficial, non-commercial Pokémon GO community activity monitor. It fetches upcoming and live events from the community-maintained ScrapedDuck feed (a structured mirror of Leek Duck), stores them locally, and shows them through two interfaces that share one design system — a CustomTkinter desktop app and a Flask web app, both in a consistent Midnight Blue dark theme.

Unofficial fan project. Not affiliated with, endorsed by, or sponsored by Niantic, Nintendo, The Pokémon Company, or Leek Duck. See Legal & Disclaimer before using or redistributing.

Pages

Page For
User Guide Installing, running, and using the desktop/web apps day to day
Configuration Every config.json setting, webhooks, Telegram, i18n
Web API The Flask app's JSON/HTML routes, for scripting or a custom front-end
Architecture Layer boundaries, the polyglot (Rust + TypeScript) design, module map
Contributing Dev setup, running tests, adding a language/region, coding conventions
Deployment Docker, the Windows .exe build, the release process
Legal & Disclaimer Trademarks, data attribution, no-warranty notice

Quick links

At a glance

Data source ScrapedDuck JSON feed (primary), best-effort official-blog HTML source (fallback)
Interfaces Desktop (CustomTkinter) + Web (Flask + TypeScript), one shared Midnight Blue theme
Languages English, Traditional Chinese, Simplified Chinese, Japanese, Korean
Persistence SQLite (indexed, WAL mode), auto-pruned
Alerts Desktop notifications, webhooks (Discord/Slack/generic, HMAC-signed), Telegram
Native fast path Optional Rust (PyO3) extension for feed parsing + region classification
Distribution CI (pytest matrix), Docker image, one-file Windows .exe

Polyglot by design — Python orchestrates and renders, an optional Rust extension accelerates the data path, and the web front-end is TypeScript. Both additions degrade gracefully: a plain checkout runs with neither a Rust nor a Node toolchain installed.

Clone this wiki locally