Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐉 pokefetch

A wild terminal appeared!

License Shell

pokefetch is a lightweight CLI tool that displays a random, colored ASCII Pokémon every time you open a new terminal tab.

It is designed to be fast, simple, and zero-dependency. It works perfectly with iTerm2, Zsh, Bash, and standard macOS/Linux terminals.

Demo Animation

✨ Features

  • ⚡️ Zero Dependencies: Pure Shell script. No python, node, or lolcat required.
  • 🎨 Native Colors: Renders pre-colored ASCII art using original ANSI codes.
  • 📂 Extensible: Easily add your own .txt art files.
  • 🚀 Auto-Start: Automatically runs when you open a new tab (optional).

🚀 Installation

Copy and paste this command into your terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/cofy-x/pokefetch/main/install.sh)"

This script will clone the repo to ~/.pokefetch and add the startup command to your .zshrc or .bashrc.

🛠 Usage

Automatic

Once installed, a random Pokémon will appear automatically whenever you open a new terminal window or tab.

Manual

You can summon a wild Pokémon manually at any time by typing:

pokefetch

🎨 Adding Custom Pokémon

Want to add a missing Pokémon or your own custom art?

  1. Find or create an ASCII art file (must save as .txt).

  2. Move the file into the assets folder:

    cp my-art.txt ~/.pokefetch/assets/
  3. That's it! It will now appear in the random rotation.

🧰 How the bundled art was made

The bundled ANSI assets were generated with cofy-x/pixel-to-ascii from the Pokémon icon sprites in PokeAPI's sprites/pokemon/versions/generation-viii/icons directory.

pokefetch is an unofficial fan project and is not affiliated with, endorsed by, or sponsored by Nintendo, Game Freak, Creatures, or The Pokémon Company. Pokémon names, characters, artwork, and related trademarks belong to their respective owners. See Third-Party Notices for the source and licensing boundary of the bundled assets.

🗑 Uninstall

To completely remove pokefetch and clean up your shell configuration automatically:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/cofy-x/pokefetch/main/uninstall.sh)"

📄 License

The pokefetch scripts and original project documentation are licensed under the MIT License. The bundled Pokémon-derived ANSI assets are third-party material and are not relicensed under MIT; see Third-Party Notices.


Made with ❤️ for the Terminal

About

🐉 A wild terminal appeared! Display random, colored ASCII Pokémon in your terminal. Support Zsh, Bash & iTerm2.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages