With 3DMark for Enterprise (formerly: Professional Edition), you can run 3DMark benchmarks from the command line. With 3DMark for macOS this is very similar to the 3DMark for Windows command-line options:
- In the macOS top menu bar go to the Spotlight Search (magnifying glass icon)
- Type Terminal
- Click on the Terminal app icon and run it
The installed executable for the standalone version of 3DMark for macOS can be found in:
/Users/<USERNAME>/Applications/3DMark/3DMark.app/Contents/MacOS
Move to the folder and run 3DMark help command by copying the following commands into the terminal and clicking enter:
cd ~/Applications/3DMark/3DMark.app/Contents/Macos
./3DMark --help
Before running benchmarks, you need to license the application with an enterprise license by entering your key starting with 3DM-... You can do this via the command line with:
./3DMark --register=3DM-...
To generate settings files for each benchmark, use the command
./3DMark --makedefs
This will generate the settings files in the current folder. Use
ls
within the folder to show the settings files, which end in .xml. To run the default tests, use the files with "Performance" like Steel_Nomad_Light-Performance.xml. Make sure you allow terminal to write into the current folder, this will be prompted on the first time. If you call this from within the 3DMark application folder, you may have to allow terminal to modify applications.
You can then run tests with the command:
./3DMark --definition=<benchmark.xml> [--out<path-to-result.3dmark-result>]
Here <benchmark.xml> is the path to the setting file. If the result file path is omitted, the result will be autosaved to the user's documents folder. Make sure you allow terminal to write in the target folder if prompted.
Options
When on or off is omitted with an option, on is assumed.
| Command | Description |
|---|---|
--help or -h | Show help page. |
--register=<license key> | Register 3DMark with the given license key. Requires a valid Enterprise Edition (formerly: Professional Edition) license. |
--unregister | Unregister ALL the 3DMark licenses. |
--licenses | List all the registered 3DMark licenses. |
--workloads or -w | List the installed benchmark workloads |
--definition=<benchmark.xml> or -d=<benchmark.xml> | Name of benchmark definition XML file. |
--loop[=<count>] | Set the number of times to loop benchmark. Default is 1. Use 0 to loop indefinitely, until the run is manually ended. |
--out=<file.3dmark-result> or -o=<file.3dmark-result> | Save the result in the given file. |
--in=<file.3dmark-result> | input file used in export operation with --export option. |
--export=<file.xml> | Export results to the given XML file. When using export please specify benchmark run with --definition option or use --in to specify input file. |
--log=<log-file> | Save the benchmark progress log to the given file. Logging does not affect the benchmark score. |
--trace | Verbose logging. |
--audio | Enable audio (default off). |
--makedefs | Generate benchmark definitions for available tests. |
Examples
To register the application and create the settings files, you only have to run these once:
cd ~/Applications/3DMark/3DMark.app/Contents/Macos
./3DMark --register=3DM-...
./3DMark --makedefs
Run Steel Nomad benchmark and save the result inside a custom folder.
./3DMark --definition=Steel_Nomad-Performance.xml --out="~/Documents/My-Results/"