Publish or Perish Command Line Tools

https://harzing.com/resources/publish-or-perish/command-line
Admin
Publish or Perish Command Line Tools is an edition of the Publish or Perish software designed for...
Tokens:2,226
Snippets:24
Trust Score:9.7
Update:2 months ago
Show doc for...
Tokens:
Raw
### Example Command Line Query Syntax

Source: https://harzing.com/resources/publish-or-perish/command-line

Demonstrates the syntax for defining search parameters including authors, keywords, and year ranges.

```text
# This is a comment  
--author="a harzing" AND "d adams"  
--keywords=publish perish  
--years=2000-2018
```

--------------------------------

### Verify Linux Installation

Source: https://harzing.com/resources/publish-or-perish/command-line

Extract the tarball and run the info command to verify the installation.

```text
$ tar xzf pop8tools_linux__subtype_.tar.gz  
$ ./pop8query --info  
Publish or Perish publication search utility 8.2.3876.8069 (2022.02.02.0903) Linux (x86_64)  
(c) 1990-2022 Tarma Software Research Ltd  
  
Built for Linux (x86_64) using GNU C/C++ (11.2.0)  
Running on Linux 5.13.0-28-generic (x86_64) #31-Ubuntu SMP Thu Jan 13 17:41:06 UTC 2022  
  
App data key:       .publish_or_perish  
App data dir:       /home/dave/.publish_or_perish  
Roaming settings:   /home/dave/.publish_or_perish/settings.json  
Local settings:     Dummy settings; not persistent  
Root path:          /home/dave/.publish_or_perish  
Results path:       /home/dave/.publish_or_perish/Results6  
Temp path:          /home/dave/.publish_or_perish/Temp  
Trash path:         /home/dave/.publish_or_perish/Trash  
Log path:           /home/dave/.logs/pop8query.log
```

--------------------------------

### Verify macOS Installation

Source: https://harzing.com/resources/publish-or-perish/command-line

Install the package using the macOS installer and verify the installation with the info command.

```text
% open pop8mactools.pkg  
...follow the installer's instructions...  
% pop8query --info  
Publish or Perish publication search utility 8.2.3877.8069 (2022.02.02.1035) MacOS (arm64)  
(c) 1990-2022 Tarma Software Research Ltd  
  
Built for MacOS (arm64) using clang C/C++ (Apple LLVM 13.0.0 (clang-1300.0.29.30))  
Running on Darwin 21.3.0 (arm64) Darwin Kernel Version 21.3.0: Wed Jan  5 21:37:58 PST 2022; root:xnu-8019.80.24~20/RELEASE_ARM64_T8101  
  
App data key:       Publish or Perish  
App data dir:       /Users/dave/Library/Application Support/Publish or Perish  
Roaming settings:   /Users/dave/Library/Application Support/Publish or Perish/settings.json  
Local settings:     /Users/dave/Library/Preferences/Publish or Perish.json  
Root path:          /Users/dave/Library/Application Support/Publish or Perish  
Results path:       /Users/dave/Library/Application Support/Publish or Perish/Results6  
Temp path:          /Users/dave/Library/Application Support/Publish or Perish/Temp  
Trash path:         /Users/dave/Library/Application Support/Publish or Perish/Trash  
Log path:           /Users/dave/Library/Logs/pop8query.log
```

--------------------------------

### Verify Windows Installation

Source: https://harzing.com/resources/publish-or-perish/command-line

Extract the distribution archive and run the info command to verify the installation and view system paths.

```text
C:\>unzip pop8tools.zip  
Archive:  pop8tools.zip  
  inflating: pop8error.exe  
  inflating: pop8metrics.exe  
  inflating: pop8query.exe  
  
C:\>pop8query --info  
Publish or Perish publication search utility 8.19.5300.9483 (2025.12.17.1527) Windows 32-bit (Intel x86)  
(c) 1990-2025 Tarma Software Research Ltd  
  
Built for Windows 32-bit (Intel x86) using Microsoft C/C++ (194435222)  
Running on Windows 10.0.26200 (x64)  
  
App data key:       Publish or Perish  
App data dir:       C:\Users\David\AppData\Roaming\Publish or Perish  
Roaming settings:   C:\Users\David\AppData\Roaming\Publish or Perish\settings.json (persistent)  
Local settings:     HKCU\Software\Tarma Software Research\Publish or Perish (persistent)  
Root path:          C:\Users\David\AppData\Roaming\Publish or Perish  
Results path:       C:\Users\David\AppData\Roaming\Publish or Perish\Results6  
Temp path:          C:\Users\David\AppData\Roaming\Publish or Perish\Temp  
Trash path:         C:\Users\David\AppData\Roaming\Publish or Perish\Trash  
Log path:           C:\Users\David\AppData\Local\Temp\pop8query.log
```

--------------------------------

### pop8query --help

Source: https://harzing.com/resources/publish-or-perish/command-line

Prints a syntax summary of the command line tool and exits.

```APIDOC
## pop8query --help

### Description
Prints a syntax summary, then exit with exit code 0; no search is performed.
```

--------------------------------

### pop8query --version

Source: https://harzing.com/resources/publish-or-perish/command-line

Prints the program's version and exits.

```APIDOC
## pop8query --version

### Description
Print the program's version, then exit with exit code 0; no search is performed.
```

--------------------------------

### pop8query --info

Source: https://harzing.com/resources/publish-or-perish/command-line

Retrieves configuration information for the tool and data sources.

```APIDOC
## pop8query --info

### Description
Prints configuration information, then exit with exit code 0; no search is performed. By default only version and path information are included; to see data source settings, use --all for all data sources or specify a data source to see information about that data source only.
```

--------------------------------

### pop8query [datasource] [queryfields]

Source: https://harzing.com/resources/publish-or-perish/command-line

Performs a publication search using a specified data source and query fields.

```APIDOC
## pop8query [datasource] [queryfields]

### Description
Performs a publication search. By default Google Scholar is used as the data source, but other sources can be specified using flags like --crossref, --gscholar, --scopus, etc.
```
Tokens:
Raw