Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ckaznable/poketex
Simple Pokedex based on TUI(Terminal User Interface)
https://github.com/ckaznable/poketex
cli pokedex pokemon ratatui rust rust-lang terminal tui tui-rs
Last synced: 2 days ago
JSON representation
Simple Pokedex based on TUI(Terminal User Interface)
- Host: GitHub
- URL: https://github.com/ckaznable/poketex
- Owner: ckaznable
- License: mit
- Created: 2022-12-23T03:18:16.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-12-11T06:49:51.000Z (2 months ago)
- Last Synced: 2025-02-02T07:06:57.423Z (9 days ago)
- Topics: cli, pokedex, pokemon, ratatui, rust, rust-lang, terminal, tui, tui-rs
- Language: Rust
- Homepage: https://crates.io/crates/poketex
- Size: 16.2 MB
- Stars: 156
- Watchers: 2
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-tools - poketex
- awesome-linux-ricing - Poketex - Simple Pokedex based on TUI. (Terminal / Fancies)
- awesome-ratatui - poketex - Simple Pokedex based on TUI. (💻 Apps / 🌌 Other)
README
📖 Poketex
Simple Pokedex based on TUI(Terminal User Interface)
## Table of Contents
- [Feature](#feature)
- [Installation](#installation)
- [Install from Github Release](#install-from-github-release)
- [Install from crates.io](#install-from-cratesio)
- [Install from the AUR](#install-from-the-aur)
- [Install from Source Code](#install-from_source-code)
- [Usage](#usage)
- [Keyboard Navigation Instructions](#keyboard-navigation-instructions)
- [Roadmap](#roadmap)
- [Troubleshoot](#troubleshoot)
- [Pokemon data source](#pokemon-data-source)
- [License](#license)
## Feature
1. All Pokemon (until Pokemon SV)
2. All Region Form (until Pokemon SV)
3. Searchable
4. include English, Chinese, Japanese locales data
## Installation
[](https://repology.org/project/poketex/versions)
### Install from Github Release
Download the last version binary depending on your configuration here: [Release Page](https://github.com/ckaznable/poketex/releases/latest)
Then you just need to enter this command in your terminal:
```shell
tar -xf poketext
sudo mv poketex /usr/local/bin
sudo mkdir -p /usr/local/share/poketex/colorscripts
sudo cp -rf colorscripts /usr/local/share/poketex
```
### Install from crates.io
If you're a Rust programmer, poketex can be installed with cargo.
```shell
cargo install poketex --locked
```
### Install from the AUR
If you're using Arch Linux, you can install poketex from the [extra repository](https://archlinux.org/packages/extra/x86_64/poketex/) using [pacman](https://wiki.archlinux.org/title/Pacman):
```shell
pacman -S poketex
```
### Install from Source Code
poketex is written in Rust, so you'll need to grab a [Rust installation](https://www.rust-lang.org/) in order to compile it.
```shell
git clone https://github.com/ckaznable/poketex
cd poketex
make build
sudo make install
```
If you want to uninstall
```shell
sudo make uninsall
```
## Usage
```shell
Usage: poketex [OPTIONS]
Options:
-l, --locale locales [zh, ja, en] [default: en]
-h, --help Print help
-V, --version Print version
```
## Keyboard Navigation Instructions
Use arrow keys or `hjkl` to move around.
Press `Page Up` or `Page Down` to move 4 steps at a time.
Press `f` to switch ascii forms.
Press `E` to toggle list showing.
Press `A` to toggle ability showing.
Press `V` to toggle IV showing.
Press `q` to exit.
Press `H` to display help information.
Press `gg` to go to the top and `G` to go to the bottom.
Press `alt+j` or `alt+k` to scroll up or down ability description.
Press `/` to enter search mode.
## RoadMap
- [x] show pokemon iv and type
- [x] pokemon list searchable
- [x] add pokemon ability rows
- [x] add region form
- [x] Alola
- [x] Galar
- [x] Hisuian
- [x] Paldea
- [ ] add cli flags
- [x] --locale [en, ja, zh]
- [ ] for controlling layout
- [x] help key
- [x] gen 9 DLC - The Teal Mask
- [x] gen 9 DLC - The Indigo Disk
- [x] Image support
- Gen 8 and below(powered by [pokemon-colorscripts](https://gitlab.com/phoneybadger/pokemon-colorscripts))
- Gen 9([#58](https://github.com/ckaznable/poketex/pull/58), Creator [Caruban](https://www.pokecommunity.com/threads/generation-9-resource-pack-v21-1.527398/))
## Troubleshoot
### Image are not displaying
If the ansi images are not displaying, please copy the `colorscripts` folder from this repository to `/usr/local/share/poketex`.
```shell
git clone https://github.com/ckaznable/poketex
cd poketex
mkdir -p /usr/local/share/poketex/colorscripts
cp -rf colorscripts /usr/local/share/poketex
```
## Pokemon data source
data generated from [ckaznable/poke-data-crawler](https://github.com/ckaznable/poke-data-cralwer)
## License
[MIT](./LICENSE)