chessfessor/README.md

The best app to extract your chess data from Lichess and Chess.com

# 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! 🎉