Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/yannjor/krabby

Print pokemon sprites in your terminal
https://github.com/yannjor/krabby

cli pokemon rust terminal

Last synced: about 7 hours ago
JSON representation

Print pokemon sprites in your terminal

Awesome Lists containing this project

README 

        
# krabby



![Crates.io version](https://img.shields.io/crates/v/krabby)

![AUR version](https://img.shields.io/aur/version/krabby-bin)



Krabby is mostly a Rust rewrite of phoney badger's [pokemon-colorscripts](https://gitlab.com/phoneybadger/pokemon-colorscripts)

with some extra features.



![](https://i.imgur.com/MVzaS3k.png)



## Table of contents

* [Features](#features)

* [Installation](#installation)

  * [Arch Linux x86_64 (and derivatives)](#arch-linux-x86_64-and-derivatives)

  * [Ubuntu/Debian x86_64 (and derivatives)](#ubuntudebian-x86_64-and-derivatives)

  * [Installing from source (other distros and MacOS/Windows)](#installing-from-source-other-distros-and-macoswindows)

* [Usage](#usage)

  * [Examples](#examples)

* [Configuration](#configuration)

* [Credits](#credits)

* [Similar projects](#similar-projects)



## Features

- Pokemon from every generation, including shinies, megas, gigantamax, and regional variants

- Print random pokemon (with filters for generations and different forms)

- Print pokemon by name

- Print pokedex entry together with the sprite

- Configuration file, right now only for language and shiny rate



## Installation



### Arch Linux x86_64 (and derivatives)



From the AUR using your favorite AUR helper



```

yay -S krabby-bin

```



Or alternatively you can manually download the PKGBUILD file from the repository, then run

```

makepkg -si

```



There is also the development package [krabby-git](https://aur.archlinux.org/packages/krabby-git) that tracks the main branch.



### Ubuntu/Debian x86_64 (and derivatives)



Download the latest `.deb` release. Then run (replacing v.v.v with the version number)

```

dpkg -i krabby_v.v.v_amd64.deb

```



### Homebrew



Add the tap:

```

brew tap yannjor/krabby

```



Install:

```

brew install krabby

```



### Installing from source (other distros and MacOS/Windows)



To install krabby from source, you will need Rust. Installation instructions can be found [here](https://www.rust-lang.org/learn/get-started).



Now using cargo, run

```

cargo install krabby

```

Make sure you have `.cargo/bin` added to your shell `PATH`. This can be done by adding the following to your `.profile`, `.bash_profile` or `.zprofile`

```sh

export PATH="$PATH:$HOME/.cargo/bin"

```



## Usage

Run the help command `krabby help` to see the following help message.



```

USAGE:

    krabby 



OPTIONS:

    -h, --help       Print help information

    -V, --version    Print version information



SUBCOMMANDS:

    help      Print this message or the help of the given subcommand(s)

    list      Print list of all pokemon

    name      Select pokemon by name. Generally spelled like in the games. A few exceptions are

                  nidoran-f, nidoran-m, mr-mime, farfetchd, flabebe type-null etc. Perhaps grep the

                  output of list if in doubt

    random    Show a random pokemon. This command can optionally be followed by a generation

                  number or range (1-9) to show random pokemon from a specific generation or range

                  of generations. The generations can be provided as a continuous range (eg. 1-3) or

                  as a list of generations (1,3,6)

```

To get more detailed information about a subcommand you can also view its help, for example

```

krabby help random

```

To get the help of the random subcommand.



### Examples

Print a specific pokemon

```

krabby name charizard

```

Print a specific shiny pokemon

```

krabby name spheal -s

```

Print a specific pokemon together with its pokedex entry

```

krabby name mudkip -i

```

Print an alternative form of a pokemon

```

krabby name blastoise -f mega

```

Print a random pokemon (gens 1-9)

```

krabby random

```

Print random pokemon from generations 1-3

```

krabby random 1-3

```

Print a random pokemon from generations 1,3 and 6

```

krabby random 1,3,6

```

Print a random pokemon excluding megas, gigantamax and regional variants

```

krabby random --no-mega --no-gmax --no-regional

```



## Configuration

When the program is run, a TOML config file will automatically be created in the user's config

directory (usually `~/.config`) under `krabby/config.toml` if it doesn't exist already. 



On MacOS the config will be in: `/Users//Library/Application Support/krabby`

On Windows this will be: `C:\Users\\AppData\Roaming\krabby`



```toml

# The language to use when printing the pokemon's name and/or description.

# Possible options include en (English), fr (French), de (German), ja (Japanese),

# zh_hans (Chinese with simplified characters), zh_hant (Chinese with traditional characters)

language = 'en'



# The probability to show a shiny pokemon when using the random command

shiny_rate = 0.0078125

```



## Credits

The pokemon sprites for krabby were generated using sprites from [PokéSprite](https://msikma.github.io/pokesprite/)

and converted to unicode using Phoney Badger's [pokemon-generator-scripts](https://gitlab.com/phoneybadger/pokemon-generator-scripts).

The pokemon data was obtained from [PokéAPI](https://github.com/PokeAPI/pokeapi).



## Similar projects

- [pokemon-colorscripts](https://gitlab.com/phoneybadger/pokemon-colorscripts)

- [pokeget](https://github.com/talwat/pokeget)

- [pokeshell](https://github.com/acxz/pokeshell)