Block Keeper Guide
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.
- Cross platform support, Windows, MacOS and Linux
- 100% offline and no Java required
- Event based session organisation
- Simple and stylish interface with multiple themes
- Scrambler for all WCA events
- WCA inspection support with voice announcements
- Event and session graphs
- Video recorder to view and save last solve
- Stackmat support
- Session import and export
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_](https://twitter.com/dmcneil_) or email firstname.lastname@example.org.
- Windows 7 or higher (32 and 64 bit)
- MacOS 10.9 or higher (64 bit only)
- Linux (32 bit, 64 bit and armv7, untested, see supported platforms above)
Block Keeper can be launched through
Block Keeper.exe. It is recommended you place the
Block Keeper folder in a permanent location and create a shortcut to
Block Keeper.exe and place it wherever you would like. Save data and preferences are stored in
Users/YourName/AppData/Roaming/Block Keeper or
%APPDATA%. You may need to enable hidden folders to access them.
Block Keeper is a standalone application and can be run from anywhere. You can place
Block Keeper.app wherever you want (Applications folder is recommended). Save data and preferences are stored in
/Users/YourName/Library/Application Support/Block Keeper.
Block Keeper can be launched through the
Block Keeper executable file. Save data and preferences are stored in
- Timer: Displays the current time of a solve and the time of the last solve in addition to inspection countdown
- Scramble: Displays a scramble for the current event and solve
- Stats and Times: See below for additional information
- Tool: Presents additional information about the current session or event. See the Tools section
- Tool Select: Used to select a tool to be displayed above
- Preferences: Open preferences menu to view options. See the Preferences section
- Video Preview: Open video menu to view and save recorder video. See the Video Record section
- Event Select: Used to select the current event
- Session Select: Used to select the current session
- Edit Session: Toggles session options, allowing you to change the name of the current session, create a new session or delete the current session
- Session Statistics
- Solves: Number of valid solves (not including DNF solves) over number of solves.
- Mean: Total time of all valid solves over the number of valid solves, a mean of all valid solves.
- Median: Middle time of all valid solves in order.
- Standard Deviation: Rough measure of average distance from mean time any time is.
- Best and Current: Table of best and current solves in session. Expands to present best and current time, Mo3, Ao5, Ao12 and Ao100. Clicking any results will present the list of times and scrambles used to generate the result.
- Records Table: Ordered table of records presenting times of solves. A
+on the end of a time indicates a
+2time penalty which is already added to the time and a
DNFpenalty. 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 any average results will present the list of times and scrambles used to generate the average.
- Add Time: Shows dialog with option to add custom time to session
- Solve Details: Hovering over a time will present the scramble used for the solve with options to change the penalty or delete the solve completely
Keyboard and Menu Shortcuts
NOTE: On MacOS, the
CTRL key is replaced with the
||Set last solves result to OK|
||Set last solves result to +2|
||Set last solves result to DNF|
||Add new time|
||Delete last solve|
||Create new session|
||Generate a new scramble|
||Edit current Session|
||View video recording of last solve|
||Close Block Keeper|
||Hide other windows|
||Quit Block Keeper|
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.
By default, the
spacebar is the timer key. By pressing and holding the
spacebar 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
spacebar will begin the timer and your solve.
An alternative is to use split keys to operate the timer. By default they are
/ 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.
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
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 organised 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. Your more than free to use sessions however you choose.
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. 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 are selectable from the bottom right of the window and offer additional visual information.
- Drawn Scramble: Shows the current scramble for the current event applied to a solved puzzle. Some events such as Skewb and MBLD are not supported.
- Session Trend: Shows a trend-line of record stats within the currently selected session for time, Mo3, Ao5 and Ao12. This shows your progress through a session.
- Event Trend: Shows a trend-line of session stats within the currently selected event for best time, best Ao5 and mean. This shows your progress in an event.
- Event Statistics: Shows a table of current and best time, Mo3, Ao5, Ao12 and session means for the current event.
- Distribution: Shows a histogram of times within the currently selected session, showing the number of times within certain ranges.
- Inspection Announcements: Voice announcements at 8s and 12s through WCA inspection (WCA inspection must be enabled)
- Time Detail: Number of decimal points to show for times throughout the application
- Timer Start Delay: Delay in seconds between keys being pressed and timer turning green and becoming ready.
- Hide Timer While Solving: Current time during solve is replaced with
solve, hiding the time
- Format Time: Times shown throughout the application will have a format of
mm:ssrather than just seconds (e.g
- WCA Inspection: Enable WCA inspection before solve. See the Timer Operation section
- Use Mouse for Timer: Use primary mouse button like
spacebarto control the timer by clicking on timer
- Split Timer Controls: Use 2 specific keys rather than the
spacebarto operate the timer. See the Timer Operation section
- Stop Timer with Split Keys: Require both split keys to be pressed to stop the timer rather than any key
- OH Split Keys: Enable split keys for the 3x3x3 OH event and require one key to be held down during a solve or receive a
- Use Stackmat Timer: Use an external Stackmat Timer as input. May not connect if the timer is not plugged in before Block Keeper is opened. Try restarting if Block Keeper does not recognise your timer. For a guide on connecting Stackmat Timers to computers (specifically Macs) see here
- Video Record Solves: Enables an attached webcam to video record a solve for viewing and saving after. See the Video Record section
- Video Autosave Location: Automatically saves recorded videos to the specified folder. Leave empty to not autosave.
- Announce Best Time: When best time for event is beaten, displays
New Best Time!under timer and causes confetti to fall.
- Scramble Font Size: Set the arbitrary font size of scrambles presented
- Scramble Text Alignment: Set text alignment of scramble text to left, right of center.
- Background Image: Specify a path to an image file which will be shown in the background. Image can be a .png and include transparency to the standard background. Optionally the Select Image button will present a dialog to find an image using a file browser.
- Theme: Set color scheme of the application to predefined options or set to custom to use defined color scheme
- Custom Theme Colors: Specify the color of specific UI elements. All colors specified should be in hexadecimal form (e.g
#FF0000for red), rgb form (e.g
rgb(255,0,0)for red) or rgba form (e.g
rgba(255,0,0,0.5)for red at half opacity). If any values have been input incorrectly, the default theme (Dark) will be used.
- Block Keeper Export: Exports all session data to a JSON file.
- Block Keeper Import: Imports all session data from a compatible JSON file. This merges the data with pre-existing data.
- csTimer Import: Imports session times, results and scrambles from a csTimer JSON file. After selecting the file, you will need to specify the event you would like to place each session under. The first time and result for each session will be shown to identify the session. Use the event select dropdown to choose the event to import the session into. Repeat this for all sessions.
- CSV Export: Exports all session times into a flat CSV file, specifying the event, session, order, time, result and scramble for every record stored.
- Current Session as Pretty Text: Exports current session to a text file or copies text to clipboard specifying the currently selected sessions times and results along with session bests. This is designed to share and present.
Thanks for using Block Keeper!