Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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
- Host: GitHub
- URL: https://github.com/yannjor/krabby
- Owner: yannjor
- License: gpl-3.0
- Created: 2022-04-10T09:56:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-11-12T14:01:49.000Z (about 1 year ago)
- Last Synced: 2024-04-14T05:09:54.094Z (7 months ago)
- Topics: cli, pokemon, rust, terminal
- Language: Rust
- Homepage:
- Size: 4.25 MB
- Stars: 70
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-linux-ricing - krabby - Print pokemon sprites in your terminal. (Terminal / Fancies)
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:
krabbyOPTIONS:
-h, --help Print help information
-V, --version Print version informationSUBCOMMANDS:
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)