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
| Option | Description |
|---|---|
[PUZZLE], -p, --puzzle |
A cataloged puzzle by name, or a recipe query string. Anything beginning with ? is parsed as a recipe. |
-r, --recipe |
Explicit recipe query string. |
-s, --scramble, --seed |
Pseudo-random walk scramble with deterministic seed. |
-m, --moves |
Apply a written sequence, such as "A B2' C". |
--depth, --no-animate |
Depth for the Scramble button, and optional animation toggle. |
--yaw, --pitch, --distance |
Initial camera orientation and distance. |
--no-arrows, --no-edges |
Toggle rendering of turn arrows and piece edges. |
--theme, --size |
dark, light, or system, and window dimensions in logical pixels. |
-l, --list, --polyhedra |
Print the catalog or polyhedron codes, then exit. |
-V, --version, -h, --help |
Print version or help information, then exit. |
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.
Metadata
Release files for twistypuzzle-gui 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| twistypuzzle_gui-0.1.1-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details for twistypuzzle_gui-0.1.1-py3-none-win_amd64.whl |
| twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details for twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
| twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details for twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
| twistypuzzle_gui-0.1.1-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for twistypuzzle_gui-0.1.1-py3-none-macosx_11_0_arm64.whl |
| twistypuzzle_gui-0.1.1-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details for twistypuzzle_gui-0.1.1-py3-none-macosx_10_12_x86_64.whl |
Total release size: 34.8 MB
Release files / twistypuzzle_gui-0.1.1-py3-none-win_amd64.whl
| Download URL | twistypuzzle_gui-0.1.1-py3-none-win_amd64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
261a9ec952481bd72440b3f8e452c5395c42917f7fe728d51639ae3214bbb1e0
|
|
BLAKE2b-256 checksum How to use checksums |
87429a5dfbccc38ac4cd8a048911768d2e9e6dd7a9bd35ea752934beb321821f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 8.2 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
737b4b834e1666eca575877104cf64f9d3b2d04c4022622990d469e6d6ecbf49
|
|
BLAKE2b-256 checksum How to use checksums |
2a7aa0fdb9554a3479218bf7a51472ca3b3b262a11d89a3976176527095e343b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | twistypuzzle_gui-0.1.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
d934a5a90b6a270cc9b2506387a6e2488f1c5b6891cb675c776099ad00a3c41a
|
|
BLAKE2b-256 checksum How to use checksums |
85b41e38ede135c56019af5ed60873dd0fa75bb3391e7be039c50a4eed07e64e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / twistypuzzle_gui-0.1.1-py3-none-macosx_11_0_arm64.whl
| Download URL | twistypuzzle_gui-0.1.1-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.0 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
82b3bed919fdaaa76407037accc43df9596bdec244c8102b22ca935e75e57f8b
|
|
BLAKE2b-256 checksum How to use checksums |
0b74cbd4331f1a1e0e286feb4f88e7c5bd99c029c0f2f20d8c29d748324ae26f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / twistypuzzle_gui-0.1.1-py3-none-macosx_10_12_x86_64.whl
| Download URL | twistypuzzle_gui-0.1.1-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 6.2 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
367c89dd5f37450fd2fbe48e7c03da8c851050bcea4b104ebb75661ac8716fce
|
|
BLAKE2b-256 checksum How to use checksums |
55bf32beb93d83514f4b5e08fdae6632ec64e708c4fe7b8f194a65921ca87ee5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logSecurity for twistypuzzle-gui 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 5 files in this release have been uploaded with provenance metadata.
Attestation for twistypuzzle_gui-0.1.1-py3-none-win_amd64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.