mayanklad/pokecrt

An offline Pokémon terminal app built in Go, featuring colorful sprites, trainer profiles, collectible discoveries, achievements, and an interactive Pokédex.

Go

12

80 commits

updated Oct 7, 2026

See the code

See what people are saying

SourceMessageScoreDate

[OC] PokéCRT - A little Pokémon adventure in my terminal (r/unixporn)

Been working on this little project called PokéCRT for a while and finally got it to a point where I wanted to share it here. It started out pretty simple - I just wanted Pokémon sprites in my terminal and somehow turned into a whole little terminal Pokémon experience with a Pokédex, random…

4

Oct 9, 2026

README

PokéCRT

Your terminal. Your Pokémon journey. Entirely offline.

Natural-size Pokémon artwork, a searchable catalog, and a local trainer adventure-one executable.

Website   /   Download v1.0   /   Install   /   Full guide   /   Release notes

Release v1.0 Linux amd64 Go 1.27+ Source license MIT

Linux amd64 · Keyboard & mouse · No network at runtime

PokéCRT Home screen with the Town Map, trainer card and adventure menu

A little adventure, wherever you open a terminal

Print a favorite Pokémon, add a sprite to your shell, or open the Adventure Menu and build a collection through encounters. Artwork and metadata are embedded; saved progress stays on your machine.

Artwork & catalogYour trainer journey
Print named, random or filtered Pokémon. Choose exact forms, shiny palettes and supported visual genders.Create local trainers, record encounters, gain XP and unlock 50 achievement goals.
Browse all 1,025 species across nine generations. Public catalog access is independent of saved progress.Explore your private Pokédex, collected appearances, evolution families and encounter history.
Natural-size truecolor artwork, transparent backgrounds and NO_COLOR support.Responsive pages, keyboard and mouse controls, and four live appearance choices.

See it in action

A private Pokédex that grows with your discoveries. Browse collected appearances, explore evolution families and keep track of each encounter.

Pokédex showing Scyther artwork, the National Index and discovery details

Exact artwork, straight from the command line. Forms, shiny palettes and supported visual genders are first-class choices.

Shiny Mega X CharizardShiny female Meowstic
Terminal command printing shiny Mega X CharizardTerminal command printing shiny female Meowstic
pokecrt print --name charizard --form mega-x --shinypokecrt print --name meowstic --gender female --shiny

Every encounter adds to your journey. Track trainer progress and work toward 50 achievement goals.

See encounters, trainer progress and achievements

Encounter result with artwork and progression details

Trainer card and generation collection progress

Earned badges and next collection goals

A quick tour

Animated tour through Home, Pokédex, Encounters, Trainer, Achievements and Appearance

Watch or download the short video. Screenshots and the tour use a separate sample trainer; the interface and artwork are captured from the running app.

Install in a minute

Download the Linux amd64 archive and SHA256SUMS from v1.0, then run from their directory:

sha256sum --ignore-missing -c SHA256SUMS
tar -xzf pokecrt_v1.0_linux_amd64.tar.gz
mkdir -p "$HOME/.local/bin"
install -m 0755 pokecrt "$HOME/.local/bin/pokecrt"
"$HOME/.local/bin/pokecrt" --version

If ~/.local/bin is not on your PATH, add export PATH="$HOME/.local/bin:$PATH" to your shell configuration and open a new shell.

Download a Linux package

Download a .deb for Ubuntu/Kubuntu or Debian, .rpm for Fedora, or .pkg.tar.zst for Arch Linux from the v1.0 release. Package installation, updates and removal.

Install from source

Use Go 1.27.0 or newer. Asset preparation downloads verified inputs once; the built app runs offline.

git clone https://github.com/mayanklad/pokecrt.git
cd pokecrt
git checkout v1.0
go run ./tools/dataset \
  --sources tools/dataset/sources.json \
  --cache .cache/dataset \
  --mappings tools/dataset/mappings.json \
  --out . --fetch --prepare-assets --check
go build -o bin/pokecrt ./cmd/pokecrt
sh scripts/install.sh ./bin/pokecrt

Build checks and packaging · Uninstall or reset

Start exploring

# Open the interactive adventure; first launch offers trainer creation.
pokecrt tui

# Print a favorite, or let the app pick one.
pokecrt print --name charizard
pokecrt print

# Explore exact appearances and the public catalog.
pokecrt print --name charizard --form mega-x --shiny
pokecrt list --name eevee --details

Record an encounter

# Create and activate a local trainer, then record an encounter.
pokecrt trainer create Ash
pokecrt trainer use Ash
pokecrt encounter

# Review progress without recording another encounter.
pokecrt trainer
pokecrt dex

encounter records the encounter and awards progression. Printing, catalog listing and private browsing do not record encounters. Profiles and encounter options explain how to switch trainers and choose output modes.

The Adventure Menu brings together Pokédex, Encounter, Trainer and Achievements. Use arrows or Tab to move, Enter to select, and Esc to return. Mouse controls are available throughout. Switch among Dark, Light, Follow Terminal and Terminal Native appearances; saving a default is explicit.

For shell integration, filters, trainer commands and detailed controls, open the full guide.

Good to know

  • Terminal: UTF-8 required; truecolor gives the intended artwork. TUI requires terminal input/output and at least 40×12. Wide views provide more space for artwork and simultaneous panels.
  • Coverage: 1,025 catalog species and 2,669 accepted exact assets. Some appearances are unavailable; PokéCRT never substitutes another sprite. See coverage.
  • Local data: printing and the public catalog need no trainer. Encounters are explicit; browsing does not change progression. Updating the binary preserves profiles and settings.
  • Artwork: sprites retain their natural dimensions; narrow terminals may wrap public output. Follow Terminal depends on your terminal’s background replies and falls back to native colors.

Read more

Guide · v1.0 notes · Progress · Benchmarks

PokéCRT is an unofficial fan project, inspired by pokemon-colorscripts, pokego and poketerm. Artwork provenance is recorded in the source audit.

Original source is MIT licensed. Third-party code, metadata and Pokémon artwork retain their respective terms. See licensing, notices and release policy. No endorsement or rights-holder permission is claimed.

cli
cli-app
golang
linux
linux-app
offline
pixel-art
pixelart
pokedex
pokedex-application
pokemon
terminal
terminal-app
terminal-based
terminal-colors
terminal-graphics
terminal-ui
tui
tui-app
tui-go

mayanklad/pokecrt

An offline Pokémon terminal app built in Go, featuring colorful sprites, trainer profiles, collectible discoveries, achievements, and an interactive Pokédex.

Go

12

80 commits

updated Oct 7, 2026

See the code

See what people are saying

SourceMessageScoreDate

[OC] PokéCRT - A little Pokémon adventure in my terminal (r/unixporn)

Been working on this little project called PokéCRT for a while and finally got it to a point where I wanted to share it here. It started out pretty simple - I just wanted Pokémon sprites in my terminal and somehow turned into a whole little terminal Pokémon experience with a Pokédex, random…

4

Oct 9, 2026

README

PokéCRT

Your terminal. Your Pokémon journey. Entirely offline.

Natural-size Pokémon artwork, a searchable catalog, and a local trainer adventure-one executable.

Website   /   Download v1.0   /   Install   /   Full guide   /   Release notes

Release v1.0 Linux amd64 Go 1.27+ Source license MIT

Linux amd64 · Keyboard & mouse · No network at runtime

PokéCRT Home screen with the Town Map, trainer card and adventure menu

A little adventure, wherever you open a terminal

Print a favorite Pokémon, add a sprite to your shell, or open the Adventure Menu and build a collection through encounters. Artwork and metadata are embedded; saved progress stays on your machine.

Artwork & catalogYour trainer journey
Print named, random or filtered Pokémon. Choose exact forms, shiny palettes and supported visual genders.Create local trainers, record encounters, gain XP and unlock 50 achievement goals.
Browse all 1,025 species across nine generations. Public catalog access is independent of saved progress.Explore your private Pokédex, collected appearances, evolution families and encounter history.
Natural-size truecolor artwork, transparent backgrounds and NO_COLOR support.Responsive pages, keyboard and mouse controls, and four live appearance choices.

See it in action

A private Pokédex that grows with your discoveries. Browse collected appearances, explore evolution families and keep track of each encounter.

Pokédex showing Scyther artwork, the National Index and discovery details

Exact artwork, straight from the command line. Forms, shiny palettes and supported visual genders are first-class choices.

Shiny Mega X CharizardShiny female Meowstic
Terminal command printing shiny Mega X CharizardTerminal command printing shiny female Meowstic
pokecrt print --name charizard --form mega-x --shinypokecrt print --name meowstic --gender female --shiny

Every encounter adds to your journey. Track trainer progress and work toward 50 achievement goals.

See encounters, trainer progress and achievements

Encounter result with artwork and progression details

Trainer card and generation collection progress

Earned badges and next collection goals

A quick tour

Animated tour through Home, Pokédex, Encounters, Trainer, Achievements and Appearance

Watch or download the short video. Screenshots and the tour use a separate sample trainer; the interface and artwork are captured from the running app.

Install in a minute

Download the Linux amd64 archive and SHA256SUMS from v1.0, then run from their directory:

sha256sum --ignore-missing -c SHA256SUMS
tar -xzf pokecrt_v1.0_linux_amd64.tar.gz
mkdir -p "$HOME/.local/bin"
install -m 0755 pokecrt "$HOME/.local/bin/pokecrt"
"$HOME/.local/bin/pokecrt" --version

If ~/.local/bin is not on your PATH, add export PATH="$HOME/.local/bin:$PATH" to your shell configuration and open a new shell.

Download a Linux package

Download a .deb for Ubuntu/Kubuntu or Debian, .rpm for Fedora, or .pkg.tar.zst for Arch Linux from the v1.0 release. Package installation, updates and removal.

Install from source

Use Go 1.27.0 or newer. Asset preparation downloads verified inputs once; the built app runs offline.

git clone https://github.com/mayanklad/pokecrt.git
cd pokecrt
git checkout v1.0
go run ./tools/dataset \
  --sources tools/dataset/sources.json \
  --cache .cache/dataset \
  --mappings tools/dataset/mappings.json \
  --out . --fetch --prepare-assets --check
go build -o bin/pokecrt ./cmd/pokecrt
sh scripts/install.sh ./bin/pokecrt

Build checks and packaging · Uninstall or reset

Start exploring

# Open the interactive adventure; first launch offers trainer creation.
pokecrt tui

# Print a favorite, or let the app pick one.
pokecrt print --name charizard
pokecrt print

# Explore exact appearances and the public catalog.
pokecrt print --name charizard --form mega-x --shiny
pokecrt list --name eevee --details

Record an encounter

# Create and activate a local trainer, then record an encounter.
pokecrt trainer create Ash
pokecrt trainer use Ash
pokecrt encounter

# Review progress without recording another encounter.
pokecrt trainer
pokecrt dex

encounter records the encounter and awards progression. Printing, catalog listing and private browsing do not record encounters. Profiles and encounter options explain how to switch trainers and choose output modes.

The Adventure Menu brings together Pokédex, Encounter, Trainer and Achievements. Use arrows or Tab to move, Enter to select, and Esc to return. Mouse controls are available throughout. Switch among Dark, Light, Follow Terminal and Terminal Native appearances; saving a default is explicit.

For shell integration, filters, trainer commands and detailed controls, open the full guide.

Good to know

  • Terminal: UTF-8 required; truecolor gives the intended artwork. TUI requires terminal input/output and at least 40×12. Wide views provide more space for artwork and simultaneous panels.
  • Coverage: 1,025 catalog species and 2,669 accepted exact assets. Some appearances are unavailable; PokéCRT never substitutes another sprite. See coverage.
  • Local data: printing and the public catalog need no trainer. Encounters are explicit; browsing does not change progression. Updating the binary preserves profiles and settings.
  • Artwork: sprites retain their natural dimensions; narrow terminals may wrap public output. Follow Terminal depends on your terminal’s background replies and falls back to native colors.

Read more

Guide · v1.0 notes · Progress · Benchmarks

PokéCRT is an unofficial fan project, inspired by pokemon-colorscripts, pokego and poketerm. Artwork provenance is recorded in the source audit.

Original source is MIT licensed. Third-party code, metadata and Pokémon artwork retain their respective terms. See licensing, notices and release policy. No endorsement or rights-holder permission is claimed.

cli
cli-app
golang
linux
linux-app
offline
pixel-art
pixelart
pokedex
pokedex-application
pokemon
terminal
terminal-app
terminal-based
terminal-colors
terminal-graphics
terminal-ui
tui
tui-app
tui-go