Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nelsyeung/PoGoTools
Pokemon Go CLI Tools for getting IVs, transferring Pokemon, evolving Pokemon and trashing items
https://github.com/nelsyeung/PoGoTools
Last synced: 3 months ago
JSON representation
Pokemon Go CLI Tools for getting IVs, transferring Pokemon, evolving Pokemon and trashing items
- Host: GitHub
- URL: https://github.com/nelsyeung/PoGoTools
- Owner: nelsyeung
- License: mit
- Created: 2016-07-31T19:12:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-12-26T15:20:15.000Z (almost 8 years ago)
- Last Synced: 2024-06-22T05:03:58.044Z (5 months ago)
- Language: Python
- Homepage:
- Size: 27.3 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-pokemon - PoGoTools - A set of CLI tools for getting IVs, transferring Pokémon, evolving Pokémon, and trashing items. (Development Projects)
README
# PoGoTools
Some useful Pokemon Go CLI tools. This is going to be strictly a set of *single run* tools only,
i.e., it won't keep the user logged in.
## Features
- Separate account settings for all the features
- List all Pokemon with their CP and IV
- Sort the listed Pokemon by their real name, CP or IV
- Filter the list of Pokemon by name
- Filter the list of Pokemon to a certain CP and IV
- Transfer Pokemon base on your own criteria
- List all your items
- Recycle or trash items base on your own criteria
- Evolve Pokemon base on your own criteria
## Installation
You need to have `Python` and `pip` installed on your computer. Please refer to other online
documentations on how to install them on your computer. It is recommended that you use `virtualenv`
with this, so that it won't cluster up your computer with Python packages.
1. Download this project either with `git` or simply download the zip file then unzip it:
```sh
git clone https://github.com/nelsyeung/PoGoTools.git
```
2. Open up terminal and change to the downloaded folder:
```sh
cd PoGoTools
```
3. Install the necessary Python packages by typing into the terminal:
```sh
pip install -r requirements.txt
```
4. Configure your account. Copy the `config.json.example` file to `config.json` then add your
login details to the `accounts` section. If you are worried about getting banned from the
temporary *teleportation*, you may want to find out your current location and change the config
file accordingly. You can use either `latitude, longitude` format or just supply a name.
5. Use the tool! Type in the terminal: `python pogotools.py -h` for all the available options.
## Usage
**Get a list of all your Pokemon sorted by their real name:**
```sh
python pogotools.py -p
# or
python pogotools.py --get-pokemon
```
**Get a list of all your Pokemon sorted by their cp or IV:**
```sh
# For sort by CP:
python pogotools.py -p -s cp
# For sort by IV:
python pogotools.py -p -s iv
```
**Applying a filter to your list of Pokemon:**
```sh
# Hide Pidgey, Weedle and Rattata from the list
python pogotools.py -p --hide-pokemon pidgey,weedle,rattata
# Show only Pidgey, Weedle and Rattata from the list
python pogotools.py -p --show-pokemon pidgey,weedle,rattata
# Show only Pokemon below or equal to CP 1000
python pogotools.py -p --hide-cp-below 1000
# Show only Pokemon above or equal to CP 1000
python pogotools.py -p --hide-cp-below 1000
# Show only Pokemon below or equal to IV 70
python pogotools.py -p --show-iv-below 70
# Show only Pokemon above or equal to IV 70
python pogotools.py -p --hide-iv-below 70
```
These filters can be chained:
```sh
# Show only Pokemon above CP 1000 and above IV 70
python pogotools.py -p --hide-cp-below 1000 --hide-iv-below 70
```
**Transfer Pokemon:**
Make sure you have set the config file correctly for transfer to work.
This can be dangerous so make sure your criteria is actually what you want or your favourite Pikachu
may run away from you!
```sh
python pogotools.py --transfer
```
**Get a list of all your items:**
```sh
python pogotools.py -i
# or
python pogotools.py --get-items
```
**Recycle or trash items:**
Make sure you have set the config file correctly for the recycle to work.
This can be dangerous so make sure your criteria is actually what you want or your Masterball might
be put in the trash!
```sh
python pogotools.py --recycle
```
**Evolve Pokemon:**
```sh
python pogotools.py --evolve
```
Currently this feature might not work with `"allow": "all"`, so it's best for you to have multiple
Pokemon set (i.e., `"allow": "pidgey, weedle, zubat, rattata"`) rather than using the `all`
function.
## TODO
- Make evolve work with "all" setting
- Add tests
- Write proper documentation
- Refactor
## Contributions
Feel free to add any extra tools or bug fixes to this! But please make sure it won't keep the user
logged in for a long time.
## Credits
- Many thanks to [tejado](https://github.com/tejado) for the API, this won't work without it.