Geekbench 4 Pro Command Line Tool

Geekbench 4 Pro comes with a command-line tool called geekbench4 that provides the same functionality as the graphical user interface. This tool allows you to use Geekbench 4 from a command prompt and automate it with shell scripts or batch files.

Install the Tool on Mac OS X

  • Click on the "Tools" menu.
  • Click on the "Install Terminal Command" menu item.

A dialog box will appear asking you to authenticate as an administrator; enter an administrator's username and password and click "Create Links". Another dialog box will appear with usage instructions (if the install was successful) or an error message (if the install encountered a problem). To use the tool enter the following command in a Terminal window:

geekbench4

Technical Details: The geekbench4 command line tool is found inside the Geekbench 4 application bundle. Installing the tool creates a symlink to the tool in /usr/local/bin. If you move Geekbench 4 to another location you will need to re-install the tool as the symlink will point to an invalid location.

Install the Tool on Windows

  • Click on the "Tools" menu.
  • Click on the "Install Command Prompt Tool" menu item.

A dialog box will appear with usage instructions (if the install was successful) or an error message (if the install encountered a problem). To use the tool open a new command prompt window (command prompt windows that are already open won't be able to find the tool) and enter the following command:

geekbench4

Technical Details: The geekbench4 command line tool is found inside the Geekbench 4 install directory. Installing the tool adds the Geekbench 4 install directory to your PATH environment variable.

Using the Tool

You can get help at any time with the --help switch:

geekbench4 --help

If you don't specify any command-line switches, Geekbench 4 runs the 64-bit benchmarks. You can also run the 64-bit benchmarks by using the following switch:

geekbench4 --arch 64bit

You can run 32-bit benchmarks with the following command line switch (note that you will have to unlock Geekbench 4 with a valid license key first!):

geekbench4 --arch 32bit

Geekbench 4 displays its progress while it's running the workloads, and displays the section scores and overall scores once all the workloads have run. Geekbench 4 will prompt you as to whether you want to upload the results to the Geekbench Result Browser.

If you don't want to be prompted (for example, you're running Geekbench 4 as part of a script) you can answer this question on the command line with one of the following switches:

  • --upload will automatically upload the result to the Geekbench Result Browser.
  • --no-upload will not upload the result to the Geekbench Result Browser

You can save Geekbench 4 results with the following command line (note that .gb4 is the recommended file extension for Geekbench 4 results):

geekbench4 --save result.gb4

You can also export Geekbench 4 results to different formats. This is a great way to share your results with people who don't have Geekbench 4 installed. Exporting is done with one of the following switches:

  • --export-csv exports the result as a CSV file.
  • --export-html exports the result as an HTML file.
  • --export-json exports the result as a JSON file.
  • --export-text exports the result as a plain-text file.

You can load and display a saved Geekbench 4 result with the following command line:

geekbench4 --load result.gb4

When loading a result, you can manipulate it like any other result. You can upload the saved Geekbench 4 result to the Geekbench Result Browser by using the following switches:

geekbench4 --load result.gb4 --upload

You can also export the saved Geekbench 4 result in a different format. For example, the following command line with export the saved result as an HTML file:

geekbench4 --load result.gb4 --export-html

Troubleshooting

Mac OS X

If you receive a -bash: geekbench4: command not found error message when trying to run Geekbench 4, either the Geekbench 4 command line tool wasn't installed correctly, or the Geekbench 4 application bundle was moved. Please re-install the command-line tool.

If the problem persists, it's possible the geekbench4 link exists but points to the wrong location and Geekbench 4 is unable to remove the incorrect link. Open the Terminal and run ls -al /usr/local/bin/geekbench4 to determine if the link was installed correctly. If the link exists remove the link with sudo rm -rf /usr/local/bin/geekbench4.

If the problem still persists, please contact support.

Windows

If you receive a 'geekbench4.exe' is not recognized as an internal or external command, operable program, or batch file. error message when trying to run Geekbench 4, the Geekbench 4 command line tool wasn't installed correctly, or the command prompt window was opened before the command line tools were installed. Please close all open command prompt windows and open a new command prompt window. If this does not resolve the issue, please re-install the command-line tool and open a new command prompt window.

If the problem still persists, please contact support.