

# 📦 DexTool
DexTool is a Box-based management tool for maintaining and keeping track of a Pokémon Living Dex.



## Downloads

- ### [Download v0.4.0-alpha](https://github.com/PoshoDev/DexTool/releases/download/v0.4.0-alpha/DexTool_0.4.0.zip)

- [Change Log](https://github.com/PoshoDev/DexTool/blob/master/ChangeLog.md)
- [All Releases](https://github.com/PoshoDev/DexTool/releases)

<br>

![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Previews/Preview_2.gif?raw=true)



It also lets you take screenshots of your current progress for you to flaunt at your mom!

|                        Regular Export                        |                         Shiny Export                         |
| :----------------------------------------------------------: | :----------------------------------------------------------: |
| <img src="https://github.com/PoshoDev/DexTool/blob/master/Promo/Previews/Screenshot_2.png?raw=true" width="650" /> | ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Previews/Screenshot_Shiny_1.png?raw=true) |

<br><br>



### How to Use:

|                             Key                              | Action                                                       |
| :----------------------------------------------------------: | ------------------------------------------------------------ |
| Right click on<br>![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_0.png?raw=true)**→**![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_1.png?raw=true) | Change Pokémon status.                                       |
| *Hold* right click on<br/>![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_0.png?raw=true)**→**![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_1.png?raw=true) | Multi-select.                                                |
| Left click on<br/>![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_0.png?raw=true) | Select Pokémon, displaying Info, Area and Counting buttons.  |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_%E2%86%91.png?raw=true)<br>or Mouse<br>Wheel Up | Jump to previous box.                                        |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_%E2%86%93.png?raw=true)<br>or Mouse<br>Wheel Down | Jump to next box.                                            |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_ESC.png?raw=true) | Deselect Pokémon.                                            |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_+.png?raw=true) | Count up (for selected Pokémon).                             |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_-.png?raw=true) | Count down (for selected Pokémon).                           |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_1.png?raw=true) to ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_8.png?raw=true) | Jump to box containing first Pokémon of a generation.        |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_0.png?raw=true) and ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_9.png?raw=true) | Jump to last box.                                            |
|                              D                               | Switch between National, Galar Dex and Armor Dex.            |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_G.png?raw=true) | Toggle Gigantamax forms.                                     |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_I.png?raw=true) | Export progress image.<br/>Saved as *C:\Users\USER\AppData\Local\DexTool\dex.png* |
| ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_button_S.png?raw=true) | Switch between Shiny and Regular dex.                        |



<br>

### Tips & Additional Info:
- When you right click a Pokémon slot it will change its color. You can decide the meaning of each color, but I _(thy tool creator)_ use them as follows:
  
  |                            Color                             | Meaning                   |
  | :----------------------------------------------------------: | ------------------------- |
  | ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_0.png?raw=true) | Not obtained.             |
  | ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_1.png?raw=true) | Obtained and in HOME.     |
  | ![](https://github.com/PoshoDev/DexTool/blob/master/Promo/Buttons/icon_slot_2.png?raw=true) | Obtained but not in HOME. |
* Your **SAVE DATA** is stored as:
  * _C:\Users\USER\AppData\Local\DexTool\save.ini_
* Your **IMAGE EXPORTS** are stored as:
	* _C:\Users\USER\AppData\Local\DexTool\dex.png_
* The **OUTPUT FILES** (for streaming, etc.) for the currently selected Pokémon is stored at:
  * _C:\Users\USER\AppData\Local\DexTool\Output_
* Your **BACKUPS** are stored at:
  * _C:\Users\USER\AppData\Local\DexTool\Backups_
  * They are made every 5 minutes after the first change since the last backup and when the application is closed.
* *"I downloaded the repo and compiled it, but it doesn't work. What gives?"*
  * Because a few functions are from third-party developers, I excluded *their* code from *my* project. So if you ever want to compile this poop of a project, then it's your responsibility to get their extensions/functions from themselves. Please understand!

<br>

### Credits:
 - Code by [Posho](https://github.com/PoshoDev). 
 - Ripped sprites from [PokéSprite](http://msikma.github.io/pokesprite/) by [msikma](https://github.com/msikma).
 - [CSV Manager](https://marketplace.yoyogames.com/assets/522/csv-manager) by [derme](https://github.com/derme302).

 <br>

 ### Additional Links:
 - [DexTool Project](https://github.com/users/PoshoDev/projects/2): Keep track of the ongoing GitHub project.
 - [DexTool-HOME](https://github.com/PoshoDev/DexTool-HOME): BlueStacks Macros for Pokémon HOME.
 - [DexTool-UltraTrim](https://github.com/PoshoDev/DexTool-UltraTrim): Tool used to trim sprites for this project.
 - [DexTool-Legacy](https://github.com/PoshoDev/DexTool-Legacy): Old DexTool project for managing Pokémon Living Dexes.
