search

aflaag / pokemon-icat

Shows any Pokémon sprite in your terminal!
GNU General Public License v3.0
95 stars 6 forks source link
kitty linux linux-rice pokemon pokemon-coloscripts pokemon-sprites rice terminal

readme

pokemon-icat

This script is inspired by this project, but since the output heavily depends on the font of your terminal, i decided to make a script that shows a true PNG image of the Pokémon (of course, this script requires a terminal that supports images).

Screenshot

Requirements

Important: this program relies on viuer, so check if your terminal is supported first.

To use the script, you must first have all the these installed:

Compilation

Note that the binary is already present inside bin/pokemon-icat, but if you need to compile the program, simply run:

sh compile.sh

(note that this script requires cargo).

Installation

After making sure that you have all of the requirements, run the following command:

git clone https://github.com/aflaag/pokemon-icat && cd pokemon-icat && sh install.sh

which should start the installation process of the script, by downloading every picture of every Pokémon.

By default, this will download every Pokémon with an upscaling factor of the original image of 3, but if you want to change this behaviour run the last command with the option --upscale <FACTOR>, for example:

sh install.sh -u 15

Usage

To show a random pokemon, simply run:

pokemon-icat

If you want to specify one or more generations in particular, simply add --generations <GENERATIONS> at the end, for example (note: the generations must be comma-separated, and trailing commas are not supported):

pokemon-icat -g 3,4,Hisui,5

If you want to show a pokemon in particular, just use the --pokemon <POKEMON> flag, for example:

pokemon-icat -p charizard

and if you want to suppress the Pokémon info, use the --quiet flag:

pokemon-icat -p charizard -q

To check all the available options, use the --help option.

Known issues

would-like-to-do list