Block Keeper is a cross platform desktop cubing timer. Block Keeper provides an event based session system with an elegant interface to provide relevant statistics and tools for speedcubing.

Main Features:

If you encounter any bugs, issues or want to suggest any improvements, please let me know so I can make Block Keeper even better. You can contact me on Twitter [@dmcneil_]( or email

System Requirements

Block Keeper uses Electron and should run on all supported platforms.



Run Block-Keeper-Setup.exe to install Block Keeper. Block Keeper is installed in Users/YourName/AppData/Local. Save data and preferences are stored in Users/YourName/AppData/Roaming/storage by default. You may need to enable hidden folders to access these folders.


Block Keeper is a standalone application and can be run from anywhere. You can place Block wherever you want (Applications folder is recommended). Save data and preferences are stored in /Users/YourName/Library/Application Support/Block Keeper/storage by default.


Block Keeper can be launched through the blockkeeper AppImage executable file. Save data and preferences are stored in $HOME/.config/Block Keeper/storage or $XDG_CONFIG_HOME by default.


Block Keeper will check for updates automatically at startup and will download any new versions. When Block Keeper is closed the update will be installed.


  1. Timer: Displays the current time of a solve and the time of the last solve in addition to inspection countdown
  2. Scramble: Displays a scramble for the current event and solve. Click to set the scrambler or a list of custom scrambles. Use left arrow to view the previous scramble or the right arrow to view the next scramble.
  3. Stats and times: See below for additional information
  4. Tools: Provides additional information and tools. See the Tools section
  5. Tool select: Used to select a tool to add
  6. Add tool: Add the selected tool
  7. Preferences: Open preferences menu to view options. See the Preferences section
  8. Video preview: Open video menu to view and save recorder video. See the Video Record section
  1. Event select: Used to select the current event
  2. Event manager: Open event manager. See Sessions section
  3. Session select: Used to select the current session
  4. Edit session: Toggles session options, allowing you to change the name of the current session, create a new session, delete the current session, transfer the current session to a different event or remove all records from the session.
  5. Session statistics
  6. Records table: Ordered table of records presenting times of solves. A + on the end of a time indicates a +2 time penalty which is already added to the time and a DNF indicates a DNF penalty. Ao5 and Ao12 times are composed of the solve adjacent including the previous 4 and 11 solves respectively. A - indicates that there are not enough solves to calculate a Ao5 or Ao12. Clicking a time will present the scramble used, date created, full time, result and an editable comment for the solve with options to change the penalty or delete the solve completely. Clicking any average results will present the list of times and scrambles used to generate the average.
  7. Add time: Shows dialog with option to add custom time and scramble to session

Keyboard and Menu Shortcuts

NOTE: On MacOS, the CTRL key is replaced with the Command Key.


Keys Description
CTRL + 1 Set last solves result to OK
CTRL + 2 Set last solves result to +2
CTRL + 3 Set last solves result to DNF
CTRL + T Add new time
CTRL + Backspace Delete last solve
CTRL + N Create new session
CTRL + E Edit current Session
CTRL + Left Previous scramble
CTRL + Right Next scramble
CTRL + R View video recording of last solve


Keys Description
CTRL + W Close Block Keeper
SHIFT + CTRL + F Toggle full-screen
CTRL + M Minimize/hide window
CTRL + R Refresh
SHIFT + CTRL + I Toggle developer tools
CTRL + + Zoom in
CTRL + - Zoom out

MacOS Specific

Keys Description
Command + , Open preferences
Command + H Hide window
Command + Option + H Hide other windows
Command + Q Quit Block Keeper

Timer Operation

The timer is inactive between solves and will present the time of your previous solve. Activating the timer and beginning a solve is different depending on a number of factors.

Timer Key(s)

By default, the space-bar is the timer key. By pressing and holding the space-bar down the timer will turn red. Releasing the key before it has turned green will cancel the timer. When the timer is green, it is ready. Releasing the space-bar will begin the timer and your solve.

An alternative is to use split keys to operate the timer. By default they are Z and / but can be changed in preferences. Pressing and holding each key will show an indicator on the left and right side of the window. Once both keys are down, the timer will turn red. If one or both keys are released before the timer turns green, the timer will cancel. Once it turns green, releasing one or both of the keys will begin the timer and your solve.

WCA Inspection

With inspection enabled, pressing and holding the timer key(s) will turn the timer immediately green. Upon releasing the key(s), inspection will begin. The timer will turn yellow and countdown from 15 to 0 seconds. With inspection announcements enabled, after 8 seconds and 12 seconds have passed, a voice will announce the current time of the inspection. To end the inspection and start the timer, follow the timer procedure above.

If 15 seconds pass before the timer is started, a +2 time penalty will be indicated and added. If 17 seconds pass, a DNF penalty will be indicated and added. This is in compliance with WCA regulations.

Stopping or Cancelling the Timer

Upon completing your solve, pressing any key (excluding the Escape key) will stop the timer. Your time will be presented and be added to the records table.

Pressing Escape before the timer begins will cancel the timer. Pressing Escape while the timer is timing will stop the timer but set the result of the time to DNF.

Blind Events

If the current event is blindfolded, the timer will have a few notable differences. Inspection will be disabled and at the end of the solve, you will be prompted to input the result before seeing the time. Default blind events have 2 splits.

Time Splits

If enabled, time splits can be recorded. Pressing any key during the solve will not stop the timer but will store the time as a split. Multiple splits can be stored before the timer is stopped. For example, 4 time splits could be used in a 3x3x3 event to record the stages of CFOP.


Block Keeper divides sessions into event categories. Selecting an event from the event dropdown will show a list of it's sessions below in a separate dropdown. All sessions created will be added to the current event. A scramble for the current event will also be shown.

In this system, every session belongs to a specific event, keeping them organized and providing the correct scramble for every solve.

Everyone chooses to use sessions differently, however, with this system it allows for many more sessions to be created and used effectively. As an example, you could create a session each day to record your times. You're free to use sessions however you choose.

Event Management

You may also create new events using the event manager, available next to the event select dropdown. A table of all the events will appear which allows you to modify properties of event, name and the scrambler. If an event is not enabled, it will not be shown in the event select, however it still exists and all of it's sessions are still kept. You cannot delete a default event, but you may disable it. Deleting an event will delete all of it's sessions as well.

You could create a new event for a specific method, or training technique, e.g A '3x3x3 Roux' event or a '3x3x3 Cross' event.

Video Record

After enabling Video Record Solves in preferences, your webcam or attached camera will be used to record your solves. Upon starting the timer, the camera will begin recording, until the timer is stopped. There is also the option to record inspection and just after the solve. After a recording has been made, the video can be viewed through the video record button in the bottom right corner. The video can also be saved from here as a .webm file.

IMPORTANT: Only the most recent solve is available to view and save. When you begin another solve, the previous recorded video will be deleted. If you want to view/save your solve, do so before you start your next solve.


Tools offer additional visual information and functionality. After selecting a tool to add form the selection menu, click the plus button to add the tool. Multiple tools can be added. To remove any tool, press the cross button on it.






Thanks for using Block Keeper!