pgn-extract: manual básico del extractor de partidas PGN

pgn-extract: manual básico del extractor de partidas PGN
Publicado: Noviembre 16, 2026.

pgn-extract: manual básico del extractor de partidas PGN

pgn-extract es un programa gratuito para buscar, revisar y ordenar partidas de ajedrez guardadas en archivos PGN. Lo creó David J. Barnes, de la Universidad de Kent, en Inglaterra, y lleva más de 30 años en desarrollo. La versión actual es la 26-04, de junio de 2026.
No tiene ventanas ni botones: funciona por la línea de comandos, es decir, escribiendo órdenes en la consola. A cambio, es rapidísimo y trabaja sin problema con archivos de millones de partidas. Su página oficial es esta: pgn-extract, página oficial.

Qué hace el programa

  • Buscar partidas por los datos de la cabecera: por jugador, torneo, fecha, resultado o código ECO.
  • Buscar partidas por las jugadas o por una posición: por ejemplo, todas las partidas de una base que llegan a una posición dada.
  • Revisar las planillas y avisar de los errores: si una jugada es imposible o falta el resultado, el programa dice en qué línea del archivo está el problema.
  • Detectar partidas duplicadas y sacarlas del archivo, o guardarlas aparte.
  • Limpiar partidas: quitar comentarios, variantes y signos de anotación, para quedarse solo con las jugadas.
  • Clasificar las partidas por su código ECO, usando el archivo de aperturas eco.pgn que acompaña al programa.
  • Cambiar el formato de salida: notación algebraica corta o larga, formato UCI, EPD, con o sin números de jugada, y más.
  • También reconoce partidas de Ajedrez960 (Chess960).

Requisitos del sistema

El programa es muy ligero: no pide un procesador especial ni mucha memoria, porque está pensado para procesar partidas una a una sin cargarlas todas en la memoria. Lo que necesita depende del sistema:
En Windows:
  • Un PC con Windows de 64 bits. La página oficial no exige una versión mínima concreta de Windows.
  • No hay instalador: el programa es un solo archivo ejecutable de 2.4 MB. Se descarga, se guarda en una carpeta y ya está listo.
  • Se usa desde la consola de Windows: el Símbolo del sistema o PowerShell.
En Mac:
  • Funciona en macOS, pero no existe un ejecutable listo para descargar: hay que fabricarlo desde el código fuente (compilarlo, como se explica más abajo).
  • Para compilar se necesitan las herramientas de compilación de Apple, las Xcode Command Line Tools, que son gratuitas y se instalan desde la propia Terminal.
  • La página oficial no exige una versión mínima concreta de macOS.
En Linux:
  • Igual que en Mac: se compila desde el código fuente, con el compilador gcc y la herramienta make, que son lo habitual en cualquier Linux.
En los tres sistemas hace falta lo mismo: tener a mano los archivos PGN con los que se quiere trabajar y moverse un mínimo por la consola o la Terminal.

Instalación en Windows

1. Descarga el ejecutable desde la página oficial: pgn-extract.exe.
2. Crea una carpeta para el programa, por ejemplo C:\pgn-extract, y guarda ahí el archivo descargado.
3. Abre la consola (Símbolo del sistema o PowerShell) y entra en esa carpeta escribiendo: cd C:\pgn-extract
4. Comprueba que el programa responde: pgn-extract --help. Si aparece la lista de opciones, todo está bien. Un detalle: en PowerShell hay que escribir .\pgn-extract.exe en lugar de solo el nombre.
5. Si quieres, copia en la misma carpeta los archivos PGN con los que vayas a trabajar; así las órdenes quedan cortas.
El autor ofrece además un video corto de introducción pensado para usuarios de Windows: video de introducción.

Instalación en Mac y en Linux

1. Descarga el código fuente: pgn-extract-26-04.zip.
2. Descomprime el archivo: se crea una carpeta llamada pgn-extract.
3. Abre la Terminal, entra en esa carpeta y ejecuta la orden: make
4. El programa queda fabricado dentro de la subcarpeta build/bin, con el nombre pgn-extract. Desde esa carpeta ya se puede usar con las mismas órdenes de esta entrada.
En Mac, si la Terminal avisa de que faltan las herramientas de compilación, se instalan con la orden: xcode-select --install.

Uso básico

La forma general de la orden es esta: primero el nombre del programa, después las opciones, y al final el archivo PGN que se quiere procesar. Por defecto, las partidas que cumplen lo pedido salen por la pantalla; con la opción -o se guardan en un archivo nuevo.
Ejemplo 1. Sacar las partidas de un jugador. Primero se crea un archivo de texto sencillo, por ejemplo criterios.txt, con una sola línea que dice: Black "Erigaisi". Después se ejecuta:
pgn-extract -tcriterios.txt -o erigaisi.pgn base.pgn
El programa lee el archivo base.pgn y guarda en erigaisi.pgn solo las partidas en las que las negras las lleva Erigaisi. En una prueba real con un archivo de 16 partidas, encontró las 12 de ese jugador. En el archivo de criterios se puede pedir por cualquier dato de la cabecera: White, Black, Event, Date, ECO, Result, y más.
Ejemplo 2. Revisar si un archivo tiene errores. Con la opción -r el programa no extrae nada: solo revisa y avisa.
pgn-extract -r archivo.pgn
Si una jugada no es válida o falta un dato, el aviso indica el número de línea y el carácter donde está el problema, para poder corregirlo a mano.
Ejemplo 3. Limpiar un archivo. Para quedarte solo con las jugadas, sin comentarios ni variantes:
pgn-extract -C -V -o limpio.pgn archivo.pgn
La opción -C quita los comentarios y la -V quita las variantes. Si además se agrega la opción -D, el programa no repite las partidas duplicadas en la salida.

Para saber más

  • La lista completa de opciones aparece ejecutando: pgn-extract --help
  • La documentación completa y oficial está en esta página: documentación de pgn-extract.
  • El código fuente también está en GitHub: pgn-extract en GitHub.
  • El programa es software libre, con licencia GNU GPL versión 3: se puede usar, copiar y compartir sin pagar.

Comentarios

Entradas más populares de este blog

Reglamento Torneo Dama y Rey - Plataforma Lichess

Los estudios en Lichess

Lichess en Español con NVDA