Skip to main content

A CLI for pyTwistyScrambler, to generate random states for Rubik's cubes/twisty puzzles.

Project description


PyPi version Python 3.6|3.7 Build Status PRs Welcome

A CLI for pyTwistyScrambler, to generate random states for Rubik's cubes/twisty puzzles.

cube-scramble-cli demo gif


Requires python3.6+

$ pip3 install cube-scramble-cli


$ cube-scramble-cli

❯ cube-scramble-cli -h
usage: cube-scramble-cli [-h] [-s] [-H]

A command line based stopwatch and twisty puzzle scramble generator

optional arguments:
  -h, --help            show this help message and exit
  -s, --print-symbols   Print a list of the supported symbols
  -H, --hide-stopwatch  When using the stopwatch, don't display the time while

Supported Symbols:

3x3 WCA Scramble                           3x3
2x2 WCA Scramble                           2x2
4x4 WCA Scramble                           4x4
5x5 WCA Scramble                           5x5
6x6 WCA Scramble                           6x6
7x7 WCA Scramble                           7x7
Pyraminx Scramble                          PYRAMINX
Megaminx Scramble                          MEGAMINX
Square-1 Scramble                          SQUARE ONE
Skewb Scramble                             SKEWB
Clock scramble                             CLOCK
Last Layer Scramble                        LAST LAYER
First 2 Layers Scramble                    FIRST 2 LAYERS
<MU>-Last Six Edges Scramble               LAST SIX EDGES
<RU>-gen Scramble                          RU SCRAMBLE
Last Slot and Last Layer Scramble          LAST SLOT AND LAST LAYER
[Stopwatch]                                STOPWATCH
[Print Help]                               HELP
[Quit]                                     QUIT

You can press tab to scroll through the symbols at the prompt, and arrow keys scroll through history (stored at ~/.scramble_history.txt)

After selecting a scramble, you may repeatedly press return/enter to generate another scramble of the same type, or enter a number to generate that many scrambles of the selected type; e.g. 3x3 3

Use Ctrl+C or Ctrl+D, or type QUIT to quit

The STOPWATCH command will start a stopwatch that stops when any key is pressed. You can use the -H flag when starting cube-scramble-cli to hide the timer while solving.


python3 -m doctest cube_scramble_cli/

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for cube-scramble-cli, version 0.4.2
Filename, size File type Python version Upload date Hashes
Filename, size cube_scramble_cli-0.4.2-py3-none-any.whl (7.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size cube scramble cli-0.4.2.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page