Skip to content

Display Pokemon images directly in the terminal using their image graphics protocol. Supports listing all Pokemon, fetching a random one, or displaying a specific one.

Notifications You must be signed in to change notification settings

amateur-hacker/pokefetch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧒 Pokefetch

A terminal-based Pokedex that shows actual Pokemon images right in your terminal using Kitty, WezTerm, or Ghostty graphics support. Catch 'em all... right from your shell!

✨ Features

  • πŸ–ΌοΈ Display Pokemon with rich inline graphics
  • 🎲 Show a random Pokemon
  • πŸ” Show a specific Pokemon by name
  • πŸ“œ List all available Pokemon names
  • πŸ“ Set custom image size (WxH)
  • πŸ™Š Option to hide Pokemon name if you want a clean look
  • 🧠 Smart support for:
    • Kitty
    • WezTerm
    • Ghostty

πŸ“¦ Installation

bash -c "$(curl -sSL https://raw.githubusercontent.com/amateur-hacker/pokefetch/main/install.sh)"

The installer will:

  • Prompt for confirmation
  • Detect your package manager and install: kitty, imagemagick
  • Copy pokemon images to ~/.local/share/pokefetch/pokemons/
  • Copy pokemon list file to ~/.local/share/pokefetch/pokemon-list.txt
  • Install script to ~/.local/bin/pokefetch

πŸš€ Usage

pokefetch [options]

Options

Flag Description
-l, --list List all available Pokemon names
-r, --random Display a random Pokemon
-n, --name <name> Display a specific Pokemon by name
-s, --size <WxH> Resize image (default: 300x300)
-N, --no-name Hide Pokemon name
-h, --help Show help message

πŸ§ͺ Examples

pokefetch --random
pokefetch --name pikachu
pokefetch --name charizard --size 400x400
pokefetch --name bulbasaur --no-name

About

Display Pokemon images directly in the terminal using their image graphics protocol. Supports listing all Pokemon, fetching a random one, or displaying a specific one.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages