pgn-extract - a Portable Game Notation (PGN) extractor

pgn-extract [flags] file.pgn [file.pgn ...]

This manual page briefly documents pgn-extract. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. It does have documentation in a README file, which is available as /usr/share/doc/pgn-extract/README.gz.

-7

Output the seven tag roster for each game. Other tags are lost.

-aoutputfile

The file to which extracted games are to be appended. See -o flag for overwriting an existing file.

-Aargsfile

Read the program's arguments from argsfile.

-b[elu]num

Restricted bounds on the number of moves in a game; lnum set a lower bound of `num' moves, unum set an upper bound of `num' moves, otherwise num (or enum) means equal-to `num' moves.

-cfile[.pgn]

Use file as a list of check files for duplicates.

-C

Don't include comments in the output. Ordinarily these are retained.

-dduplicatefile

The file to which duplicate extracted games are to be written.

-D

Don't output duplicate extracted game scores.

-eECO_file

Perform ECO classification of games. The optional ECO_file should contain a PGN format list of ECO lines. Default is to use /usr/share/pgn-extract/eco.pgn as ECO_file.

-E[123]

Split output into separate files according to ECO. E1: Produce files from ECO letter, A.pgn, B.pgn, etc. E2: Produce files from ECO letter and first digit, A0.pgn, etc. E3: Produce files from full ECO code, A00.pgn, A01.pgn, etc. All files are opened in append mode.

-ffile_list

The file file_list contains the list of PGN files to be searched - one per line.

-F

Output a FEN string comment of the final game position.

-h

Print an abbreviated list of help.

-h1

Print further help.

-?

Print an abbreviated list of help.

-llogfile

Create a new logfile for the diagnostics rather than using stderr.

-Llogfile

Append all diagnostics to logfile.

-noutputfile

Write all valid games not otherwise output to outputfile.

-N

Don't include NAGs in the output. Ordinarily these are retained.

-ooutputfile

The file to which extracted games are to be written. Any existing contents of the file are lost (see -a flag).

-P

Don't match permutations of the textual variations (-v).

-r

Report any errors but don't extract.

-Rtagorder

Use the tag ordering specified in the file tagorder.

-s

Silent mode don't report each game as it is extracted.

-S

Use a simple soundex algorithm for tag matches. If used, this option must precede the -t or -T options.

-ttagfile

File of player, date, or result, extraction criteria.

-Tcriterion

Player, date, or result, extraction criteria.

-U

Don't output games that only occur once. (Use with -d to identify duplicates in multiple files.)

-vvariations

The file variations contains the textual lines of interest.

-V

Don't include variations in the output. Ordinarily these are retained.

-wwidth

Set width as an approximate line width for output.

-W

Don't rewrite the moves into Standard Algebraic Notation.

-W[cm|epd|san|lalg|halg]

Specify the output format to use. Default is SAN. cm is ChessMaster format. epd is EPD format. lalg is long algebraic. halg is hyphenated long algebraic. Use -Wsan[PNBRQK] for language specific output, e.g., use -WsanBSLTDK for German.

-xvariations

The file variations contains the lines resulting in positions of interest.

-zendings

The file endings contains the end positions of interest.

-Z

Use the file virtual.tmp as an external hash table for duplicates. Use when MallocOrDie messages occur with big datasets.

-#num

Output num games per file, to files named 1.pgn, 2.pgn, etc.

Pgn-extract was written by David Barnes <D.J.Barnes@ukc.ac.uk>. This manual page was written by Peter van Rossum <petervr@debian.org>, for the Debian GNU/Linux system.