twistypuzzle-gui

The desktop interface for twistypuzzle: a graphical interface rendering via the simulator's CPU software rasterizer, independent of external GPU or browser runtimes.

pip install "twistypuzzle[gui]"
twistypuzzle-gui

Drag rotates the camera, clicking an arrow executes a layer turn, and scroll zooms. Keyboard shortcuts: Space scrambles, R resets, U undoes.

Command-Line Interface

twistypuzzle-gui provides both an interactive graphical interface and command-line execution. It initializes the specified puzzle at the requested configuration, while information flags display data and exit without spawning a window.

twistypuzzle-gui "Rubik's Cube (3x3x3)"          # a cataloged puzzle, by name
twistypuzzle-gui '?shell=C$1&cut=C$1/3'          # arbitrary puzzle recipe query
twistypuzzle-gui Megaminx --scramble 20 --seed 7 # initialize with scramble
twistypuzzle-gui --moves "A B2' C" --theme dark  # apply move sequence
twistypuzzle-gui --list                          # list all cataloged puzzles
twistypuzzle-gui --help                          # complete command options

Invalid command-line invocations return an error message with exit code 2.

Python Integration

The wheel installs the executable as twistypuzzle-gui, and the twistypuzzle_gui module forwards arguments to the underlying executable, allowing programmatic invocation from Python scripts or notebooks:

import twistypuzzle_gui

twistypuzzle_gui.launch("Megaminx", "--scramble", "12")  # blocks until closed
twistypuzzle_gui.launch("Megaminx", wait=False)  # asynchronous execution
print(twistypuzzle_gui.capture("--list"))  # capture stdout from command-line query flags

python -m twistypuzzle_gui [OPTIONS] [PUZZLE] passes through command arguments.

The desktop interface operates as an independent binary or via the optional [gui] extra, decoupling windowing toolkit dependencies from headless simulator workflows.