pokesay

Performant-Pokémon!

pokesay is like cowsay but for pokémon only. Internally, pokesay still uses cowsay, but supplies and organises its own Pokemon cowsay files for cowsay to use.

Mission Statement

This must be run via Bash/shell scripts, and piggyback cowsay. Nobody wants to install weird dependencies to run this.
This must be as fast as possible.
There must be some nice options to control which pokemon you select

Installation

The only dependency is BSD cowsay: https://www.freebsd.org/cgi/man.cgi?query=cowsay

This is available on most (all?) systems, and can be installed by commands like:

OS	command
debian	`apt install cowsay`
osx	`brew install cowsay`
termux	`pkg install cowsay`

Installation via script

Running ./install.sh will install pokesay in your home folder. It will be necessary to have something like export PATH=$HOME/bin:$PATH in your dotfiles so that you can just call pokesay to use it.

The cowfiles under ~/.pokesay/
The executable script at ~/bin/pokesay

It may be necessary to logout and login back again to have pokesay in your $PATH.

Usage

Now that you've installed pokesay, you can make it work like so:
```
$ pokesay Hello World
```
To have a random Pokémon say a random message, try using with fortune:
```
$ fortune | pokesay
```
If you really like it, you can add the command above to the end of your ~/.bashrc file (or equivalent). So you will have a random pokémon speaking to you whenever you open a new terminal window! :D
Pick a pokemon this is in the 'shiny' category AND contains the substring 'chu'
```
pokesay -c shiny -p chu 'yo'
```

Development

If you want to rebuild (and install) everything in the repository, you will need to run the Makefile command

make build install

This will produce a cows/ directory which will contain all of the sprites from pokesprite, transformed from PNG to cowfile, ready for use.

NOTICE

Please notice I don't own Pokémon or anything related to it. Pokémon is property of The Pokémon Company.

tmck-code / pokesay-bash