linpuzs: Linkedin Puzzle Solver

For when you want the streak but not the 4 minutes of staring at coloured squares.

Plug in your Android phone, open today's LinkedIn puzzle and run linpuzs. It grabs a screenshot over ADB, figures out the board, solves it, and taps the answer in for you, usually in a few seconds.

Supported games

Install

You'll need Python 3.10+, adb (Android platform-tools) on your PATH, and USB debugging turned on in your phone's developer options.

With pipx (recommended, keeps it in its own environment):

pipx install linpuzs

Or with pip:

pip install linpuzs

Or with Homebrew (macOS/Linux):

brew install prat31/tap/linpuzs

Then plug in your phone and run linpuzs. To update later, use pipx upgrade linpuzs, pip install -U linpuzs or brew upgrade linpuzs.

Development setup

Requires uv and adb on your PATH.

uv sync
uv run linpuzs

Usage

linpuzs                      interactive: pick device (if several) → pick game → solve
linpuzs -g queens            solve one game without the menu
linpuzs -s SERIAL            use a specific device
linpuzs -n                   dry run: solve, but don't touch the screen
linpuzs --list               show games and solver status

Dry run: linpuzs -n (or --dry-run) reads the board from your phone, solves it and prints the solved board in the terminal, without tapping anything.

Tests

No phone needed. Each game has two test files:

• tests/test_<game>.py checks the real screenshot in media/example/.
• tests/test_<game>_fuzz.py draws random boards the way the app does, solves them, and replays the touches.

uv run pytest -q                                      # everything (~1-2 min)
uv run pytest -q tests/test_zip.py                    # one game's screenshot tests