cpjourney-miner

Automated mining for cpjourney.net on Linux.

---

Table of Contents

• Prerequisites
• Installation
• Usage
• Remote Mining (SSH)
• How It Works

Prerequisites

• xdotool (input automation)
• A screenshot tool in your PATH:
  • X11: scrot
  • Wayland: grim + slurp
• (optional) tesseract for coin OCR
• (optional) tmux + xterm for remote mining

Python 3.10+

Verify with: cpjourney-miner check

Installation

pipx install git+https://git.kvndl.xyz/kvndl/cpa_tools.git

Or from source:

git clone https://git.kvndl.xyz/kvndl/cpa_tools.git
cd cpa_tools && pip install -e .

Usage

cpjourney-miner              # start mining (default)
cpjourney-miner check        # verify dependencies
cpjourney-miner help         # show help

The calibration sequence prompts you to select:

1. Game window corners
2. Your penguin (for position tracking)
3. Player badge (for card recovery)
4. Coin readout region

Remote Mining (SSH)

Launch the miner on a headless machine over SSH. The session runs inside tmux so it survives disconnects.

cpjourney-miner run --launch              # start with chromium
cpjourney-miner run --launch firefox      # start with firefox
cpjourney-miner run --launch --stop       # stop active session

On first launch, the browser and terminal are positioned side-by-side on the remote display. Calibration is guided from SSH. After calibration, your terminal attaches to the tmux session.

Action	How
Detach (keep mining)	Ctrl+B D
Reattach later	cpjourney-miner run --launch
Stop mining	Ctrl+C or --launch --stop

How It Works

1. Screenshots the dirt zone and builds an obstacle mask
2. Computes a distance transform to find spots furthest from obstacles
3. Clicks the safest spot, waits for the penguin to walk, presses d to dig
4. Monitors coins via OCR, moves after 3 bursts or timeout

License

MIT