PlayerBlink GX

Improved version of Player Blink with enhanced UI, error handling, and detection accuracy. Some features may be broken or not implemented yet.

Based on the original Project_Xs by niart120 and Player Blink by lincoln-lm.

• Polished, customizable UI - switchable themes, color pickers for the ROI and match preview, mouse-driven ROI editing with live feedback, and a built-in gallery to organize your blink templates.
• More accurate tracking - the game tick rate is auto-calibrated from your own gameplay instead of using a fixed value, so timing adapts to your hardware and capture device.
• Live predictions and timeline - shows upcoming advances with their expected blinks (player and Pokémon NPCs), the exact moment to press A, and a clear visual countdown to your target advance.
• Flexible video pipeline - pick the capture backend, codec, resolution and FPS that fit your setup, with GPU-accelerated, smoothly scaled display.
• "Always on top" window pinning to keep PlayerBlink GX visible while you play.

• Python 3.12+ (May work on previous versions)
• OpenCV (opencv-python)
• CVQt
• Pillow
• Qt (PySide6)

Easy install (recommended):

1. Install Python 3.12+ and make sure to check "Add Python to PATH" during installation.
2. Download or clone this repository.
3. Double-click run.bat.

The script will create a virtual environment, install all dependencies and launch the app automatically. The first run takes a few minutes; subsequent launches are nearly instant.

Manual install:

git clone https://github.com/AndrSator/PlayerBlink-GX
cd PlayerBlink-GX
pip install -r requirements.txt

git clone https://github.com/AndrSator/PlayerBlink-GX
cd PlayerBlink-GX

# Build toolchain + system libs for window capture (D-Bus + GStreamer/PipeWire)
sudo apt install build-essential python3-dev python3-venv pkg-config \
    libdbus-1-dev libgirepository-2.0-dev libcairo2-dev \
    libxcb-cursor0 \
    gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 \
    gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
    gstreamer1.0-pipewire

python3 -m venv venv
source venv/bin/activate
pip install -r requirements_linux.txt

Ubuntu note: If libgirepository-2.0-dev is not found (Ubuntu < 24.04), use libgirepository1.0-dev instead.

Windows: double-click run.bat, or run from the terminal:

python "PlayerBlink GX.py"

Linux:

python "PlayerBlink GX.py"

Most modern Linux distros default to a Wayland session. PlayerBlink GX works under Wayland but there are some differences compared to X11/Windows:

• Window capture (monitor mode) uses xdg-desktop-portal + PipeWire, the same API that OBS uses. When you activate monitor mode and start capture, the compositor's native window picker will appear. The required system packages are installed during the Linux installation steps above.

• "Always on top" (pin window) does not work under native Wayland because the compositor controls window stacking. To force PlayerBlink GX to run under XWayland where this feature works, launch it with:

  QT_QPA_PLATFORM=xcb python "PlayerBlink GX.py"

This project is licensed under the MIT License.

It includes code derived from Project_Xs by niart120 and lincoln-lm