{"id":13715736,"url":"https://github.com/msikma/pokesprite","last_synced_at":"2026-10-19T14:12:55.241Z","repository":{"id":19642991,"uuid":"22895312","full_name":"msikma/pokesprite","owner":"msikma","description":"Database project of box and inventory sprites from the Pokémon core series games","archived":false,"fork":false,"pushed_at":"2024-05-07T13:18:49.000Z","size":25493,"stargazers_count":1278,"open_issues_count":22,"forks_count":198,"subscribers_count":63,"default_branch":"master","last_synced_at":"2026-09-21T18:13:36.765Z","etag":null,"topics":["icons","pokedex","pokemon","sprites"],"latest_commit_sha":null,"homepage":"https://msikma.github.io/pokesprite/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msikma.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":"2014-08-12T23:02:41.000Z","updated_at":"2026-09-14T15:06:29.000Z","dependencies_parsed_at":"2024-06-18T20:23:24.655Z","dependency_job_id":null,"html_url":"https://github.com/msikma/pokesprite","commit_stats":{"total_commits":528,"total_committers":13,"mean_commits":40.61538461538461,"dds":"0.17613636363636365","last_synced_commit":"c5aaa610ff2acdf7fd8e2dccd181bca8be9fcb3e"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/msikma/pokesprite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msikma%2Fpokesprite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msikma%2Fpokesprite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msikma%2Fpokesprite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msikma%2Fpokesprite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msikma","download_url":"https://codeload.github.com/msikma/pokesprite/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msikma%2Fpokesprite/sbom","scorecard":{"id":665752,"data":{"date":"2025-08-11","repo":{"name":"github.com/msikma/pokesprite","commit":"c5aaa610ff2acdf7fd8e2dccd181bca8be9fcb3e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.4,"checks":[{"name":"Code-Review","score":3,"reason":"Found 2/6 approved changesets -- score normalized to 3","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: license.md:0","Info: FSF or OSI recognized license: MIT License: license.md:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 27 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-21T17:58:46.641Z","repository_id":19642991,"created_at":"2025-08-21T17:58:46.641Z","updated_at":"2025-08-21T17:58:46.641Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38357901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-19T02:00:06.414Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["icons","pokedex","pokemon","sprites"],"created_at":"2024-08-03T00:01:02.918Z","updated_at":"2026-10-19T14:12:54.377Z","avatar_url":"https://github.com/msikma.png","language":"Python","funding_links":[],"categories":["Development Projects"],"sub_categories":[],"readme":"[![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT) [![npm version](https://badge.fury.io/js/pokesprite-images.svg)](https://badge.fury.io/js/pokesprite-images) ![Updated for](https://img.shields.io/badge/Updated%20for-Pok%C3%A9mon%20Sword%2FShield%20(Crown%20Tundra%20DLC)-blue)\n\n# PokéSprite\n\nThis is a collection of the box sprites of every Pokémon from the main game series, and the sprites for every collectable and bag item. Also included are custom shiny versions of the box sprites that are not available in-game.\n\n**Some examples of the sprites:**\n\n\u003cp align=\"center\"\u003e\u003cimg align=\"center\" src=\"resources/images/banner_gen8_2x.png\" alt=\"Pokésprite Gen 8 examples banner\" width=\"726\"\u003e\u003c/p\u003e\n\nThese sprites can be used as individual files, or accessed programmatically using the included sprite database files.\n\n## Sprites and metadata\n\nThis project contains both Pokémon box sprites and item sprites. For Pokémon, both the old style sprites from *Pokémon Sun/Moon* (Gen 7) and the new style sprites from *Pokémon Sword/Shield* (Gen 8), including the DLC, are included, as well as a number of unofficial sprites for *Pokémon Legends: Arceus*. Item sprites are available with Gen 8 style white outlines and without.\n\n| Directory | Example | Size | Type | Description |\n|:----------|:-------:|:----------|:-----|:------------|\n| `/pokemon‑gen7x` | ![/pokemon-gen7x/ example](pokemon-gen7x/shiny/venusaur.png) | 68×56 | Pokémon | [Gen 7 sprites](https://msikma.github.io/pokesprite/overview/dex-gen7.html), updated to Gen 8 size and contrast |\n| `/pokemon‑gen8` | ![/pokemon-gen8/ example](pokemon-gen8/shiny/venusaur.png) | 68×56 | Pokémon | [Gen 8 sprites](https://msikma.github.io/pokesprite/overview/dex-gen8.html) (plus older Gen 7 sprites where needed) |\n| `/items` | ![/items/ example](items/evo-item/thunder-stone.png) | 32×32 | Items | [Gen 3–8 inventory items](https://msikma.github.io/pokesprite/overview/inventory.html) |\n| `/items‑outline` | ![/items-outline/ example](items-outline/evo-item/thunder-stone.png) | 32×32 | Items | [Gen 3–8 inventory items](https://msikma.github.io/pokesprite/overview/inventory.html) with *Sword/Shield* style outline |\n| `/misc` | ![/misc/ example](misc/body-style/wings-multiple-gen6.png) | Varies | Misc. | [Miscellaneous sprites](https://msikma.github.io/pokesprite/overview/misc.html) from multiple gens |\n\nThe item and miscellaneous sprites are separated by type in subdirectories (e.g. *\"berry\", \"evo-item\", \"valuable-item\", \"ribbon\",* etc).\n\nPrevious generations of games (Gen 1–2 and Gen 3–4) had their own collections of sprites, but these are not included in this project. The original 40×30 Pokémon sprites from Gen 6–7 are kept for legacy purposes in the [`/icons`](icons/) directory.\n\nSee the [Pokémon sprite overview page](https://msikma.github.io/pokesprite/overview/dex-gen8.html) for a full list of sprites.\n\n## Data files\n\nDevelopers who want to use these sprites programmatically might want to look at the `/data/pokemon.json` and `/data/item-map.json` files; the former contains a list of all Pokémon and their associated sprites, and the latter links all sprites in the repo to their internal IDs used in-game.\n\n### Pokémon sprite list\n\nEach entry in the `dex.json` file contains the following data (example):\n\n```js\n// ...\n{\n  \"idx\": \"006\",\n  \"name\": {\n    \"eng\": \"Charizard\",\n    \"jpn\": \"リザードン\",\n    \"jpn_ro\": \"Lizardon\"\n  },\n  \"slug\": {\n    \"eng\": \"charizard\",\n    \"jpn\": \"riza-don\",\n    \"jpn_ro\": \"lizardon\"\n  },\n  \"gen-7\": {\n    \"forms\": {\n      \"$\": {\n        \"has_female\": false,\n        \"has_right\": false\n      },\n      \"mega-x\": {\n        \"has_female\": false,\n        \"has_right\": false\n      },\n      \"mega-y\": {\n        \"has_female\": false,\n        \"has_right\": false\n      }\n    }\n  },\n  \"gen-8\": {\n    \"forms\": {\n      \"$\": {\n        \"is_prev_gen_icon\": false\n      },\n      \"gmax\": {\n        \"is_prev_gen_icon\": false\n      },\n      \"mega-x\": {\n        \"is_prev_gen_icon\": true\n      },\n      \"mega-y\": {\n        \"is_prev_gen_icon\": true\n      }\n    }\n  }\n},\n// ...\n```\n\nThe `name` and `slug` objects contain the Pokémon's name in various languages, including a romanized version of the Japanese name. The **`jpn_ro`** item contains GAME FREAK's official rōmaji names that are mainly used in merchandise. For example, for カメール (Wartortle), the `jpn` slug is *\"kame-ru\"*, while the `jpn_ro` slug is *\"kameil\"*.\n\nThe **`forms`** object contains a list of all sprites pertaining to a Pokémon. It always contains at least a `\"$\"` (dollar sign) value, which means the regular form or default sprite. Each form object can contain the following details:\n\n| Key | Meaning |\n|:----|:--------|\n| `is_alias_of` | This form uses the sprite of another form and does not have its own image |\n| `is_unofficial_icon` | This sprite is not a verbatim original and has been edited in some way (e.g. *Pumpkaboo* and *Gourgeist*)† |\n| `is_unofficial_legacy_icon` | As above, but only for the smaller legacy 40×30 sprites (only used for *Melmetal*) |\n| `is_prev_gen_icon` | This sprite is actually [from an earlier generation](docs/notes/unupdated-sprites.md) |\n| `has_right` | A unique right-facing sprite is available (e.g. *Roselia*—only for Gen 7 Pokémon) |\n| `has_female` | This Pokémon has visible gender differences (e.g. *Unfezant*) |\n| `has_unofficial_female_icon` | The female version of this Pokémon's sprite was custom made (e.g. *Pikachu*) |\n\n\u003csub\u003e†: only applies to non-shiny sprites, as shiny sprites are always unofficial.\u003c/sub\u003e\n\nThere are a few cases where a Pokémon's shiny design changed in an update. For example, Minior's shiny form was originally [gray](pokemon-gen8/shiny/minior-blue-gen7.png) but became [colorized](pokemon-gen8/shiny/minior-blue.png) with the release of Pokémon HOME. This project always uses the latest designs, with the old ones renamed to their gen of origin.\n\n### Inventory items list\n\nSeveral files are available for processing the sprites for inventory items:\n\n* [`/data/item-map.json`](data/item-map.json) – a 1:1 map of item IDs and sprite files, e.g. `\"item_0017\": \"medicine/potion\"`\n* [`/data/item-unlinked.json`](data/item-unlinked.json) – all inventory sprites not linked to an item ID—these are mostly duplicates (e.g. the *Metal Coat* sprite is in both *\"hold-item\"* and *\"evo-item\"*, and so one goes unused) and legacy files\n* [`/data/item-legacy.json`](data/item-legacy.json) – a list of old item sprites from previous gen games\n\nSee the [inventory overview page](https://msikma.github.io/pokesprite/overview/inventory.html) for a list of items.\n\n### Miscellaneous sprites\n\nFor all other sprites that are neither Pokémon nor inventory items, see [`/data/misc.json`](data/misc.json). Notably, the [ribbons](misc/ribbon) can be found there. Each group of miscellaneous sprites has its own unique data format. See the [miscellaneous overview page](https://msikma.github.io/pokesprite/overview/misc.html) for all included images.\n\n## Sprite dimensions\n\nSince Gen 8, the Pokémon box sprites have become 68×56 (up from 40×30 in Gen 7) to accommodate larger sprite designs. \n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"resources/images/readme_gen8_size_1.png\" width=\"166\"\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\n\u003cimg src=\"resources/images/readme_gen8_size_2.png\" width=\"166\"\u003e\n\u003cp\u003e\n\nMost Pokémon did not get a new sprite as of Gen 8, meaning their old sprite was padded to the new size. Sprites were padded from below, with one extra pixel of space on the bottom (see left).\n\nSince most Pokémon take up a very small amount of pixels of the allotted space, they'll look far more spaced apart than in Gen 7 if they're displayed adjacent to each other. This effect is especially noticeable for not-fully-evolved Pokémon.\n\nTo somewhat mitigate this, the sprites can be made to overlap each other. In nearly all cases, only the empty space around the sprite will overlap—if there are multiple large sprites next to each other (like several Gigantamax forms) the sprites themselves will overlap, but only a little.\n\nThe recommended overlap is **-24px left** and **-16px top**, which is a compromise between bringing the smaller sprites closer together and not letting the larger sprites overlap. **Here's an example of what that looks like:**\n\n\u003cp align=\"center\"\u003e\u003cimg align=\"center\" src=\"resources/images/offset_example_2x.png\" width=\"552\" alt=\"Sprite offset example\"\u003e\u003c/p\u003e\n\nWith this setup, the larger sprites are quite close together but not uncomfortably so, and the smaller sprites are not too far away from each other. There is some small overlap for the largest sprites (the special Gigantamax forms), but not excessively so, and in most cases it should be rare to see multiple Gigantamax forms next to one another since it's not a permanent form.\n\nFor a better example of what many adjacent sprites look like with this setup, see the banner image at the top of the readme, which also uses the same amount of spacing.\n\n## Related projects\n\n**Projects using PokéSprite:**\n\n* **[PKHeX](https://github.com/kwsch/PKHeX)** – Pokémon save file editor\n* **[PokéSprite spritesheet](https://github.com/msikma/pokesprite-spritesheet/)** – spritesheet of all Pokémon box sprites and inventory items for use in websites\n* **[PikaSprite](https://github.com/arcanis/pikasprite)** – a different interface for PokéSprite sprites\n* **[DexTool](https://github.com/PoshoDev/DexTool)** – management tools for a Pokémon living Dex, shiny hunting and streaming\n* [Spinda Painter](https://msikma.github.io/spinda-spots/) – proof of concept for displaying accurate Spinda spots on its box sprite\n* [pokemonsay](https://github.com/HRKings/pokemonsay-newgenerations) – version of [cowsay](https://en.wikipedia.org/wiki/Cowsay) with Pokémon sprites\n* [pokemonshow](https://github.com/eramdam/pokemonshow) – another project that shows Pokémon in the terminal\n* [Random Pokémon Generator](https://ptgigi.com/apps/pokemon/randomizer/) – generates Pokémon teams by a given list of filters\n* [Pokémon Type Swap Generator](https://ptgigi.com/apps/pokemon/typeswap/) – a Pokémon type swapping app\n* Many Google Sheets used by Pokémon traders\n\nIf your project uses PokéSprite and you'd like to be added to this list, feel free to [open an issue](https://github.com/msikma/pokesprite/issues) to request it.\n\n**Other Pokémon artwork related links:**\n\n* [Project Pokémon - Animated 3D sprites index](https://projectpokemon.org/docs/spriteindex_148/)\n* [Bulbapedia - List of game sprites](https://archives.bulbagarden.net/wiki/Category:Game_sprites) – contains many other graphics and icons not included in this project\n* [PokéDings](https://github.com/msikma/PokeDings) – webfont and SVG icons of special characters used in Pokémon nicknames\n* [PokéResources](https://github.com/msikma/pokeresources) – Various Pokémon image resources\n\n## License\n\nThe sprite images are © Nintendo/Creatures Inc./GAME FREAK Inc.\n\nEverything else, and the programming code, is governed by the [MIT license](http://opensource.org/licenses/MIT).\n\nThis project couldn't have been made without the help of numerous contributions from the community. See [the contributors file](contributors.md) for further information and full credits.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsikma%2Fpokesprite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsikma%2Fpokesprite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsikma%2Fpokesprite/lists"}