https://github.com/frequentlymisseddeadlines/chessfessor

Command line tool to extract game data from Lichess.org and Chess.com
https://github.com/frequentlymisseddeadlines/chessfessor

chess data extract lichess pgn

Last synced: about 1 month ago
JSON representation

Command line tool to extract game data from Lichess.org and Chess.com

• Host: GitHub
• URL: https://github.com/frequentlymisseddeadlines/chessfessor
• Owner: FrequentlyMissedDeadlines
• License: mit
• Created: 2021-07-15T16:16:42.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2021-07-20T16:47:46.000Z (almost 5 years ago)
• Last Synced: 2025-10-17T08:06:03.700Z (8 months ago)
• Topics: chess, data, extract, lichess, pgn
• Language: JavaScript
• Homepage: https://chessfessor.com/
• Size: 831 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# Chessfessor

[![Version](https://img.shields.io/npm/v/chessfessor)](https://www.npmjs.com/package/chessfessor)

![build](https://github.com/FrequentlyMissedDeadlines/chessfessor/workflows/build/badge.svg)

![release](https://github.com/FrequentlyMissedDeadlines/chessfessor/workflows/release/badge.svg)

[![codecov](https://codecov.io/gh/FrequentlyMissedDeadlines/chessfessor/branch/main/graph/badge.svg)](https://codecov.io/github/FrequentlyMissedDeadlines/chessfessor?branch=master)

[![Downloads (total)](https://img.shields.io/npm/dt/chessfessor)](https://www.npmjs.com/package/chessfessor)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![](https://nodei.co/npm/chessfessor.png?downloads=true&stars=true)](https://www.npmjs.com/package/chessfessor)

Chessfessor is the short for "Chess Professor". This command line tool will allow you to download all your chess game data from [Lichess](https://lichess.org/) and [Chess.com](https://www.chess.com/). You can then put this data in any BI tool you like to analyse your games or generate dashboards like winrates per opening.

## Install

```

npm install -g chessfessor

```

## Usage

```

chessfessor Kasparov

```

## Advanced usage

```bash

# Display help page

chessfessor --help

chessfessor -h

# Get Lichess.org games for player Kasparov

chessfessor Kasparov --website lichess

chessfessor Kasparov -w lichess

# Get Chess.com games for player Kasparov

chessfessor Kasparov --website chessdotcom

chessfessor Kasparov -w chessdotcom

#Get Lichess.org games for player Kasparov, including casual games

chessfessor Kasparov -w lichess --casual

```

## Disclaimer

I have no rights on [Lichess](https://lichess.org/) or [Chess.com](https://www.chess.com/). All rights belong to their respective owners.

But this tool comes from free, enjoy it! 🎉