kahoot-to-anki 1.2.0

CLI tool to convert Kahoot quiz reports into Anki flashcards

kahoot-to-anki

kahoot-to-anki is a command‑line tool that converts exported Kahoot quiz reports (Excel Files) into Anki flashcard decks (.apkg format).
Designed for educators, students, and any self-learners to easily turn quiz results into effective spaced‑repetition decks.

Installation & Usage

Option 1: Install via pip

pip install kahoot-to-anki

Then run:

kahoot-to-anki --help

Example: Process all Kahoot Exports in the ./exports/ folder and write the flashcard deck and CSV file to ./data/:

kahoot-to-anki --inp "./exports" --out "./data" --csv

Option 2: Run with Docker

# Clone Repository
git clone https://github.com/SimonHRD/kahoot-to-anki.git

# Move into Repository
cd kahoot-to-anki

# Build docker image with the kahoot-to-anki tag
docker build -t kahoot-to-anki .

# Check help command
docker run --rm kahoot-to-anki --help

# Run with local data
docker run --rm -v "$(pwd)/data:/app/data" kahoot-to-anki --out "./data" --csv

On PowerShell:

docker run --rm -v ${PWD}\data:/app/data kahoot-to-anki --out "./data" --csv

CLI Arguments

You can provide either a single Kahoot Excel file or a directory containing multiple .xlsx files as input.
All valid Excel files in the directory will be processed.

Argument	Description
-i, --inp	Path to the input Excel file or directory (default: ./data)
-o, --out	Path to the output directory for the Anki deck (default: ./)
--sheet	The Excel Sheet with the raw Kahoot quiz data (default: RawReportData Data)
--csv, --no-csv	Enable or disable CSV export of the questions (default: disabled)
-t, --title	Title of the generated Anki deck (default: "Kahoot")
--version	Show the version of the installed kahoot-to-anki package

Example

An example Kahoot export file is available in data/. The generated deck will be saved as anki.apkg in the specified --out directory (default: ./).

License

MIT — see LICENSE