Badminton CLI

A beautiful console application for exploring German U19 badminton rankings from the German Badminton Association (DBV).

Features

• Search players by name with fuzzy matching
• View player details including rankings across all disciplines
• Compare players side-by-side
• Calculate team points for doubles partnerships
• View top rankings filtered by discipline
• Track ranking history with terminal graphs
• JSON output for all commands for programmatic access

Installation

# Using uv (recommended)
uv tool install badminton-cli

# Or using pipx
pipx install badminton-cli

# Or using pip
pip install badminton-cli

Quick Start

# Download ranking data
badminton-cli update

# Search for a player
badminton-cli search "Max Mustermann"

# View player details
badminton-cli player 01-150083

# Show top rankings in Men's Singles
badminton-cli top --discipline HE

# Compare two players
badminton-cli compare 01-150083 01-150084

# View ranking history graph
badminton-cli graph 01-150083 --since 6m

Commands

All commands support --json for structured output.

Disciplines

Interactive Mode

Run without arguments for an interactive TUI:

badminton-cli

Claude Code Plugin

A Claude Code plugin is available for AI-assisted ranking exploration. See the claude-plugin directory.

Requirements

• Python 3.12+

License

MIT License - see LICENSE for details.

Links

• PyPI
• GitHub
• Issues