Geekbench 5 Pro Command Line Tool

The Geekbench 5 command-line tool called geekbench5 provides the same functionality as the graphical user interface. This tool allows you to use Geekbench 5 from a command prompt and automate it with shell scripts or batch files. This is the primary interface for the Linux version of Geekbench 5, and is available as a feature of Geekbench 5 Pro for Windows and Mac.

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:

geekbench5

Technical Details: The geekbench5 command line tool is found inside the Geekbench 5 application bundle. Installing the tool creates a symlink to the tool in /usr/local/bin. If you move Geekbench 5 to another location you will need to re-install the tool as the symlink will point to an incorrect 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:

geekbench5

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

Using the Tool

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

geekbench5 --help

If you don't specify any command-line switches, Geekbench 5 runs the CPU benchmark.

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

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

  • --upload will automatically upload the result to the Geekbench Browser once the benchmark is complete.
  • --no-upload will not upload the result to the Geekbench Browser once the benchmark is complete.

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

geekbench5 --save result.gb5

You can also export Geekbench 5 results to different formats. This is a great way to share your results with people who don't have Geekbench 5 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 5 result with the following command line:

geekbench5 --load result.gb5

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

geekbench5 --load result.gb5 --upload

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

geekbench5 --load result.gb5 --export-html

You can view the Compute API available on your system with the following command:

geekbench5 --compute-list

You can then select one Compute API to run a benchmark with. For example, we can run an OpenCL Compute benchmark on a system that supports OpenCL with the following command:

geekbench5 --compute OpenCL

If you have multiple GPUs which support the same Compute API, you can differentiate between them with the platform and device ID numbers that appear before the GPU's name after running geekbench5 --compute-list. For example, if the output of geekbench5 --compute-list contains two devices under OpenCL, including 0 1 AMD Radeon VII, you can run the OpenCL benchmark on the Radeon VII with the following command:

geekbench5 --compute OpenCL --compute-platform-id 0 --compute-device-id 1

Troubleshooting

Mac OS X

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

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

If the problem still persists, please contact support.

Windows

If you receive a 'geekbench5.exe' is not recognized as an internal or external command, operable program, or batch file. error message when trying to run Geekbench 5, the Geekbench 5 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.