KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

futbin

★ 46 Open GitHub ↗

An unofficial command-line tool for Futbin

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# futbin
[![Go Reference](https://pkg.go.dev/badge/github.com/matheusfm/futbin.svg)](https://pkg.go.dev/github.com/matheusfm/futbin)
[![goreleaser](https://github.com/matheusfm/futbin/actions/workflows/release.yml/badge.svg)](https://github.com/matheusfm/futbin/actions/workflows/release.yml)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/matheusfm/futbin)
![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/matheusfm/futbin)
[![Go Report Card](https://goreportcard.com/badge/github.com/matheusfm/futbin)](https://goreportcard.com/report/github.com/matheusfm/futbin)
![GitHub](https://img.shields.io/github/license/matheusfm/futbin)
![GitHub all releases](https://img.shields.io/github/downloads/matheusfm/futbin/total)

An unofficial command-line tool for [futbin](https://www.futbin.com/). Also, it can be used as a library.

# Install

## Pre-compiled binaries

1. Download the file for your system/architecture from the [GitHub releases assets](https://github.com/matheusfm/futbin/releases)
2. Unpack the downloaded archive (e.g `tar -xzf futbin_Linux_x86_64.tar.gz`)
3. Ensure that the binary has execution permissions (`chmod +x ./futbin`)
4. Move the binary somewhere in your `$PATH` (e.g `mv ./futbin $HOME/.local/bin`)

## Install script

The installation process can be automated using the following script:

```shell
curl -sSfL https://raw.githubusercontent.com/matheusfm/futbin/main/install.sh | sh -s -- -b $HOME/.local/bin
```

## From source

```shell
go install github.com/matheusfm/futbin@latest
```

# Usage

[![asciicast](https://asciinema.org/a/456565.svg)](https://asciinema.org/a/456565)

```
Usage:
  futbin [command]

Available Commands:
  cardversions card versions
  clubs        clubs
  completion   generate the autocompletion script for the specified shell
  help         Help about any command
  latest       latest added players
  leagues      leagues
  nations      nations
  players      players
  popular      popular players
  totw         current TOTW players

Flags:
      --config string     Config file (default is $HOME/.futbin.yaml)
  -h, --help              help for futbin
      --platform string   Platform (PS, XB or PC) (default "PS")

Use "futbin [command] --help" for more information about a command.
```

### `players` command examples:

```
Usage:
  futbin players [flags]

Examples:
1.  # Brazilian players in LaLiga:
    futbin players --nation 54 --league 53
2.  # OTW players (see options in 'futbin cardversions' command):
    futbin players --version otw
3.  # Brazilian players with more than 90 of passing:
    futbin players --nation 54 --passing 90-
4.  # Icons with a maximum price of 300K:
    futbin players --league 2118 --price -300000
5.  # Players with 5 weak foot and 5 skills:
    futbin players --wf 5 --skills 5
6.  # Players with Lengthy AcceleRATE:
    futbin players --accelerate=lengthy

Flags:
      --accelerate string           Accelerate
      --acceleration string         Acceleration
      --aggression string           Aggression
      --agility string              Agility
      --balance string              Balance
      --ball-control string         Ball Control
      --club int                    Club ID
      --composure string            Composure
      --crossing string             Crossing
      --curve string                Curve
      --defending string            Defending
      --dribbling string            Dribbling
      --finishing string            Finishing
      --free-kick-accuracy string   Free Kick Accuracy
      --heading-accuracy string     Heading Accuracy
  -h, --help                        help for players
      --interceptions string        Interceptions
      --jumping string              Jumping
      --league int                  League ID
      --long-passing string         Long Passing
      --long-shots string           Long Shots
      --marking string              Marking
      --nation int                  Nation ID
      --ovr string                  Rating
      --pace string                 Pace
      --page int                    Page (default 1)
      --passing string              Passing
      --penalties string            Penalties
      --physicality string          Physicality
      --position strings            Position
      --position-type string        Position type (default "all")
      --positioning string          Positioning
      --price string                Price
      --reactions string            Reactions
      --shooting string             Shooting
      --short-passing string        Short Passing
      --shot-power string           Shot Power
      --skills string               Skills
      --sliding-tackle string       Sliding Tackle
      --sprint-speed string         Sprint Speed
      --stamina string              Stamina
      --standing-tackle string      Standing Tackle
      --strength string             Strength
      --version string              Card version
      --vision string               Vision
      --volleys string              Volleys
      --wf string                   Weak Foot

Global Flags:
      --config string     Config file (default is $HOME/.futbin.yaml)
      --platform string   Platform (PS, XB or PC) (default "PS")
```

## Docker

You can also run futbin using Docker:

```shell
docker run --rm --name futbin ghcr.io/matheusfm/futbin players
```

## Library Usage

If you want to use Futbin as a library in your Go program, you can use the following code snippet as an example:

```go
package main

import (
	"fmt"
	"os"

"github.com/matheusfm/futbin/players"
)

func main() {
	playersClient := players.DefaultClient()
	p, err := playersClient.Get(&players.Options{
		Platform: "PS",
		NationID: 54, // Brazil
		LeagueID: 53, // LaLiga
	})
	if err != nil {
		fmt.Fprintln(os.Stderr, "Error:", err)
		os.Exit(1)
	}
	for _, player := range p {
		fmt.Println(player.CommonName)
	}
}
```

# License

See [LICENSE](https://github.com/matheusfm/futbin/blob/main/LICENSE).

futbin

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README