kicker-cli

A Foosball data aggregator, analyzers, and manager based on Kickertool.

Kickertool is a powerful tournament software that enables everyone to run foosball event. kicker-cli allows you to maintain data from Kickertool with the support of organization and event management, by which organizers could manage, analyze and rank inside an organization across multiple events.

Features

• Organization, Events, and Players database
• Multiple files data aggregation
• Ranks for players and teams with performance (win rate) and ranking systems (points, & ELO score)

Analyzers

• Double Player Ranks
• Double Team Ranks
• Single Player Ranks
• Double Team Rivals
• Single Player Rivals

Supported Game Modes

Round Games

• MonsterDYP
• Rounds
• Round Robin
• Swiss System

Knockoff Games

• Double Elimination
• Elimination

Installation

go install github.com/crispgm/kicker-cli/cmd/kicker-cli@latest

Usage

Init a workspace:

# init with current folder
kicker-cli init --name "MyAwesomeFoos"

# init with existing folder
kicker-cli init --name "MyAwesomeFoos" --path /path/to/workspace

# show organization
kicker-cli org

Import .ktool files:

# download from Kickertool and then
kicker-cli import /path/to/ktool
#  => 1 event(s) imported

Event management:

# list events
kicker-cli event ls
kicker-cli event ls --before 2023-08-23
kicker-cli event ls --name-type dyp

# show info
kicker-cli event info 351e00bf-025c-4243-b381-2f5a135c3070

# get rank
kicker-cli event rank -m double_player_rank -t byp
kicker-cli event rank 351e00bf-025c-4243-b381-2f5a135c3070 -m double_player_rank

# open event
kicker-cli event open 351e00bf-025c-4243-b381-2f5a135c3070
#  => xdg-open event-url

# delete event
kicker-cli event delete 351e00bf-025c-4243-b381-2f5a135c3070

Event analysis:

# analyze with "double_player_rank" operator for "byp" event order by ELO
kicker-cli events analyze -m double_player_rank -t byp -o ELO

# analyze with "single_player_rank" operator for "single" event order by win rate
kicker-cli events analyze -m single_player_rank -t single --sort-by elo

Player management:

# list players
kicker-cli player ls

# create player
# You may present multiple names. The very first name will be set as primary, others will be aliases.
kicker-cli player create David
#  => 1 player created

# delete player
kicker-cli player delete 13d4ea60-f6ff-48da-be1e-413d38328cb0

Evaluation:

# elo scores
kicker-cli eval elo 1100 1200
kicker-cli eval elo 1103 1203 1289 1013
kicker-cli eval elo -k 20 1103 1203 1289 1013

# points gained
kicker-cli eval rank -s ATSA50 -s KLocal 1

Known Issues & Limitations

• Game duration is inaccurate because we actually don't input the result as soon as the game is finished. So we abandoned all time factors.

License

MIT