There's a new pokeget in town which you should use instead!

Old README:

pokeget is a bash script you can use to display cool sprites of pokemon in your terminal.

Table of contents

• pokeget
  • Table of contents
  • Info
  • Examples
  • Installation
  • Uninstallation
  • Sources
  • Usage
  • Dependencies
  • pokeget-lite
  • Contributors
  • Developing
  • Other projects
  • Compatibility with other shells
  • FAQ
    • Hey, isn't this similar to pokemon-colorscripts?
  • Todo
  • Known issues
  • Versioning scheme
  • Branches

Info

pokeget has support for all pokemon up to gen 8 including gen 8 and is written in bash.

pokeget has only needs basic dependencies usually preinstalled in GNU/Linux systems.

You can also use pokeget-lite if you think normal pokeget is bloated and you want something a lot simpler.

Examples

Installation

You can go to INSTALLING.md for instructions.

Uninstallation

If pokeget is still functioning normally you can do pokeget uninstall

If pokeget isn't working you can use the uninstall script by doing:

bash <(curl -s https://raw.githubusercontent.com/talwat/pokeget/main/scripts/uninstall.sh)

in your shell to remove a local installation, and to remove a system wide installation do:

sudo bash <(curl -s https://raw.githubusercontent.com/talwat/pokeget/main/scripts/uninstall.sh)

Keep in mind if you did a system wide installation all users who used pokeget will have to delete their pokeget config files manually

The pokeget configuration files are located in ~/.config/pokeget so keep that in mind.

Sources

Sprites are taken from Pokemon Reborn (A pokemon fan game), and vanilla sprites are taken from PokeAPI.

However, the original sprites and character designs are made by Game Freak.

The sprites have been converted into .txt files by me, so feel free to use them in other projects.

Usage

The help command is pokeget help, if you need to get a quick reminder.

You can do pokeget <pokemon national dex id> to display the sprite.

If you want a list of flags, you can look at USAGE.md.

Dependencies

To run pokeget you will need is bash, cURL, and the GNU coreutils.

To install pokeget, you will need cURL if you don't clone the repository and instead use the install instructions.

All dependencies are usually installed by default on most Linux distros, as this script is designed to run on GNU/Linux.

If you run it on macOS/darwin certain features will be disabled, but most things will work fine.

If you test it on other non GNU/Linux systems you can open an issue with your results and they will be added in this section of the README.

pokeget-lite

pokeget-lite is a much simpler script in comparison to normal pokeget. pokeget-lite is just under 40 sloc!

It has no flags or a config file, and is limited to small sprites only. It supports sprites up to gen 8 including gen 8.

It still requires bash and cURL, however if you plan to use it on a non-GNU system such as Alpine you might have more success due to it not relying on any of the GNU coreutils.

Contributors

• Talwat Lead maintainer and creator of pokeget.
• LoganWalls Made a script to scrape a list of pokemon. This helped a lot to be able to get pokemon with sprites instead of national dex id's.
• acxz Fixing a small spacing issue, and making feature requests.
• crstian19 Submitted pokeget to the AUR Arch User Repository.
• Vagahbond Made pokeget automatically know wether the user wanted to get a pokemon by ID or by name.
• res0nance Fixed a critical issue in pokeget-lite and made random pokemon work on macOS.

Developing

You can go to DEVELOPING.md for developer documentation.

Other projects

If theres an other project you want to see a comparison to, you can go to OTHER_PROJECTS.md.

If a project you think should be compared/mentioned, open an issue or a pull request and I can add a chapter about it.

Compatibility with other shells

pokeget has only been tested on bash and is meant to be used with bash.

It can actually run on zsh, but it's still not recommended.

FAQ

Hey, isn't this similar to pokemon-colorscripts?

See OTHER_PROJECTS.md for some info about this.

Todo

• Add manual pages to the .RPM release of pokeget
• Add support for displaying pokemon with names instead of national dex id's.
• Add uninstall script.
• Add support for selecting random pokemon and random pokemon from specific generations.
• Make an official macOS port
• Move sprites to an external repository

Known issues

During testing, some of the unicode symbols have displayed incorrectly, this is still being worked on. This basically boils down to external factors such as your terminal emulator. This is not an issue with pokeget.

Versioning scheme

pokeget uses a modified version of semantic versioning.

It goes MAJOR.SEMI-MAJOR.MINOR.BUILD.

It does not require empty 0's to be added to the end of the version number.

So you would do 1.8 not 1.8.0.0.