gitwtfhub

wtf is pgn-mule?

kraktus/pgn-mule — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2024-02-26

TypeScriptAudience · developerComplexity · 3/5DormantSetup · moderate

TL;DR

A background service that collects chess games from Lichess, Chess.com, and other sources, filters them, and serves them through a simple web URL.

Mindmap

mindmap
  root((pgnmule))
    What it does
      Aggregates chess games
      Filters and combines PGN
      Serves via web URL
    Tech stack
      TypeScript
      Redis
      Zulip
    Use cases
      Aggregate tournament games
      Filter games by round
      Standardize game notation
    Audience
      Chess coaches
      Tournament organizers
    Workflow
      Poll sources on interval
      Manage via Zulip commands
      Cache in Redis

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Aggregate chess games from Lichess, Chess.com, and other sources into one feed.

REASON 2

Filter a large set of games down to a specific round or game range for students.

REASON 3

Standardize chess notation across games pulled from different sources.

REASON 4

Run a continuously updated game feed for a chess study group or tournament.

What's in the stack?

TypeScriptRedis

How it stacks up

kraktus/pgn-mule0xradioac7iv/tempfs7vignesh/pgpulse
Stars—00
LanguageTypeScriptTypeScriptTypeScript
Last pushed2024-02-26——
MaintenanceDormant——
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires Redis for caching and Zulip for managing sources, not a standalone drop-in tool.

Yoink these prompts

Prompt 1
Help me set up PGN Mule to pull games from a Lichess tournament and a Chess.com event together.
Prompt 2
Show me how to filter the combined PGN feed to only games from a specific round.
Prompt 3
Explain how PGN Mule uses Zulip commands to manage chess game sources.
Prompt 4
Walk me through configuring Redis as the cache layer for PGN Mule.

Frequently asked questions

wtf is pgn-mule?

A background service that collects chess games from Lichess, Chess.com, and other sources, filters them, and serves them through a simple web URL.

What language is pgn-mule written in?

Mainly TypeScript. The stack also includes TypeScript, Redis.

Is pgn-mule actively maintained?

Dormant — no commits in 2+ years (last push 2024-02-26).

How hard is pgn-mule to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is pgn-mule for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane