{"id":13608588,"url":"https://github.com/acxz/pokeshell","last_synced_at":"2025-10-12T22:32:11.573Z","repository":{"id":40614785,"uuid":"464005355","full_name":"acxz/pokeshell","owner":"acxz","description":"A featureful shell program to show pokemon sprites in the terminal.","archived":false,"fork":false,"pushed_at":"2024-10-22T12:24:13.000Z","size":73,"stargazers_count":132,"open_issues_count":13,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-23T02:02:46.860Z","etag":null,"topics":["bash","colorscripts","krabby","pokeget","pokemon","pokemon-colorscripts","pokemon-coloscripts","pokemon-icat","pokemonshow","pokescript","pokeshell","poketerm","shell","shell-script","terminal"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/acxz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-27T01:04:47.000Z","updated_at":"2024-10-22T12:24:17.000Z","dependencies_parsed_at":"2024-04-13T20:24:28.499Z","dependency_job_id":"070b1ac5-92f5-4dbc-9b05-28676073388a","html_url":"https://github.com/acxz/pokeshell","commit_stats":{"total_commits":115,"total_committers":1,"mean_commits":115.0,"dds":0.0,"last_synced_commit":"8dd4d604fb8c689a743cb17508dd48800b2ce813"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acxz%2Fpokeshell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acxz%2Fpokeshell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acxz%2Fpokeshell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acxz%2Fpokeshell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/acxz","download_url":"https://codeload.github.com/acxz/pokeshell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247393569,"owners_count":20931812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","colorscripts","krabby","pokeget","pokemon","pokemon-colorscripts","pokemon-coloscripts","pokemon-icat","pokemonshow","pokescript","pokeshell","poketerm","shell","shell-script","terminal"],"created_at":"2024-08-01T19:01:28.483Z","updated_at":"2025-10-12T22:32:11.521Z","avatar_url":"https://github.com/acxz.png","language":"Shell","funding_links":[],"categories":["Shell","Terminal"],"sub_categories":["Fancies"],"readme":"# pokeshell\nA shell program to show pokemon sprites in the terminal.\n\n![pokeshell4](https://user-images.githubusercontent.com/17132214/157562228-6ee73b46-9287-45de-823b-e7c43001b00e.gif)\n\nKey features include:\n\n| ✔️ animated sprites | ✔️ multiple pokemon | ✔️ multilingual | ✔️ terminal fit | ✔️ tab completions |\n|:-:|:-:|:-:|:-:|:-:|\n\n## Dependencies\n\n| - [bash](https://www.gnu.org/software/bash/) | - [curl](https://curl.se/) | - [jq](https://stedolan.github.io/jq/) | - [imagemagick](https://imagemagick.org/) | - [timg](https://github.com/hzeller/timg)/[chafa](https://github.com/hpjansson/chafa/) |\n|:-:|:-:|:-:|:-:|:-:|\n\n## Installation\n\nYou can install/uninstall pokeshell using [`just`](https://github.com/casey/just).\n\nBy default the install directory is `/usr/local/`, which will allow you to run `pokeshell`\nanywhere on your system as well as add shell completions.\n\nYou can also specify the install directory, but you'll have to make sure that directory is on your `$PATH`\nif you want to run `pokeshell` from anywhere.\n\n```bash\n# install\njust install [\u003cinstall_dir\u003e]\n\n# uninstall\njust uninstall [\u003cinstall_dir\u003e]\n```\n\nIf you don't have `just` or don't want to use it, you can directly use the `install.sh` and `uninstall.sh` scripts.\n\n```bash\n# install\n./install.sh [install_dir]\n\n# uninstall\n./uninstall.sh [install_dir]\n```\n\nRemember to prepend the install/uninstall command with `sudo` if you need to.\n\nIf you do not want to install then you can still run pokeshell anywhere\nby adding the following lines to your `~/.bashrc`.\n\n```bash\nexport PATH=/path/to/pokeshell:$PATH\n```\n\n## Usage\n\n```bash\npokeshell --help\n```\n\nor if running from this directory:\n```bash\n./bin/pokeshell --help\n```\n\n## Examples\n![pokeshell1](https://user-images.githubusercontent.com/17132214/157558398-580213fa-3f46-4332-a24e-71bab1c4d033.png)\n![pokeshell2](https://user-images.githubusercontent.com/17132214/157558403-8b83eb3d-4e54-44af-b05e-e3cb9a0d1ab3.png)\n![pokeshell3](https://user-images.githubusercontent.com/17132214/157558404-ca22357f-7d21-41b4-9cad-282c863205f5.png)\n\n## Integration\n\n### hyfetch\n[hyfetch](https://github.com/hykilpikonna/hyfetch) is an active fork of\n[neofetch](https://github.com/dylanaraps/neofetch). Most importantly, it\nhas fixes for properly displaying ascii. The updated `neofetch` can be run\nwith the [`neowofetch`](https://github.com/hykilpikonna/hyfetch#running-updated-original-neofetch)\ncommand and uses your existing `neofetch` config.\n\nTo use `pokeshell` with `hyfetch` add the following to your `neofetch`\nconfig file: `~/.config/neofetch/config`:\n```\nimage_backend=\"ascii\"\nimage_source=$(POKESHELL_COMMAND)\n```\nwhere `POKESHELL_COMMAND` is what you would run in the terminal.\n\nFor example, including the below in your `neofetch` config file\n```\nimage_backend=\"ascii\"\nimage_source=$(pokeshell politoed)\n```\nand running `neowofetch` gives the following:\n\n![hyfetch-integration](https://user-images.githubusercontent.com/17132214/188514218-60248920-8361-4bc6-93cd-75accfafa04f.png)\n\n## Sources\nA great amount of gratitude goes to the following projects, without which\n`pokeshell` would not be possible. Please star/support these sources!\n\nSmall sprites: [msikma/pokesprite](https://github.com/msikma/pokesprite)\n\nBig sprites and localization: [PokeAPI](https://pokeapi.co/)\n- Specifically: [PokeAPI/pokeapi](https://github.com/PokeAPI/pokeapi) and [PokeAPI/sprites](https://github.com/PokeAPI/sprites)\n\nAnimated sprites: [ProjectPokemon](https://projectpokemon.org/home/docs/spriteindex_148)\n\n## Similar Projects\npokeshell is not the first player in the pokemon shell art niche and nor will it\nbe the last. (I just hope that the next project can take these ideas and only\nexpand on them.) Below is a feature list of some projects (\n[acxz/pokescript](https://github.com/acxz/pokescript),\n[phoneybadger/pokemon-colorscripts](https://gitlab.com/phoneybadger/pokemon-colorscripts),\n[talwat/pokeget-rs](https://github.com/talwat/pokeget-rs))\nthat also fill this role and what makes `pokeshell` unique among them.\n\n| **Feature**      | **pokeshell** | **pokescript** | **colorscripts** | **pokeget-rs** |\n|:----------------:|:-------------:|:--------------:|:----------------:|:--------------:|\n| random           | ✔️             | ✔️              | ✔️                | ✔️              |\n| small            | ✔️             | ✔️              | ✔️                | ✔️              |\n| big              | ✔️             | ❌             | ❌               | ❌             |\n| animated         | ✔️             | ❌             | ❌               | ❌             |\n| terminal fit     | ✔️             | ❌             | ❌               | ❌             |\n| multilingual     | ✔️             | ✔️              | ❌               | ❌             |\n| genders          | ✔️             | ✔️              | ❌               | ❌             |\n| tab completion   | ✔️             | ✔️              | ❌               | ❌             |\n| multiple pokemon | ✔️             | ✔️              | ❌               | ✔️              |\n| no internet      | ❌            | ✔️              | ✔️                | ✔️              |\n| block size \u003csup\u003e#\u003c/sup\u003e      | ANSI          | half         | half         | half          |\n| # dependencies \u003csup\u003e-\u003c/sup\u003e  | 5             | 1            | 1            | 0             |\n| cached speed \u003csup\u003e+\u003c/sup\u003e    | 1x (76.9 ms)  | 11x (7.1 ms) | 2x (37.5 ms) | 37x  (2.1 ms) |\n| first run speed \u003csup\u003e+\u003c/sup\u003e | 1x (241.2 ms) | 34x (7.1 ms) | 6x (37.5 ms) | 115x (2.1 ms) |\n\n\u003csup\u003e#\u003c/sup\u003e: in order of resolution: ANSI \u003e half\n\n\u003csup\u003e-\u003c/sup\u003e: pokeshell/pokescript uses bash, colorscripts uses python, pokeget-rs uses rust\n\n\u003csup\u003e+\u003c/sup\u003e: Normalized to pokeshell, tested with [hyperfine](https://github.com/sharkdp/hyperfine), larger\nis faster\n\n### Other Similar Projects\n- [aflaaq/pokemon-icat](https://github.com/aflaaq/pokemon-icat)\n    Show Pokemon sprites in Kitty\n- [eramdam/pokemonshow](https://github.com/eramdam/pokemonshow)\n    Show Pokemon sprites using JavaScript\n\n## Other Pokémon Sprite Terminal Projects\n- [rmccorm4/Pokefetch](https://github.com/rmccorm4/pokefetch)\n    Fetch Pokedex entries in your terminal\n- [HRKings/pokemonsay-newgenerations](https://github.com/HRKings/pokemonsay-newgenerations)\n    Cowsay for Pokemon\n- [31marcobarbosa/pokeTerm](https://github.com/31marcobarbosa/pokeTerm)\n    Display random Pokemon sprite upon opening a terminal\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facxz%2Fpokeshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facxz%2Fpokeshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facxz%2Fpokeshell/lists"}