MITM data analysis utility for Pokemon GO
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Pokemon GO Optimizer

This project is no longer being developed because as of July 30th Niantic has implemented SSL pinning, rendering this method useless. Happy hunting, everyone.

In Pokemon GO, each Pokemon has hidden values that determine its maximum attainable HP and CP known as individual values — or IVs for short. The goal of this project is to display these hidden values to the user as painlessly as possible, while giving insight into each Pokemon's combat abilities.


Host Setup

A Note About Windows

Currently, it is very difficult to get this program working on Windows. Until a fully javascript implementation of protobuf can be utilized, Windows support will not be provided. For the time being, the recommended solution is Docker. If anyone would like to contribution documentation on how to get this project running flawlessly on Windows with Docker, please contact me.


Run these commands:

brew install node
brew install git
brew install pkg-config
brew install --devel protobuf
git clone
cd pogo-optimizer
npm install
npm start


Run the commands below for your flavor of choice to get the necessary dependencies, then see "Common" below for usage.

RPM-based (Fedora, CentOS, RHEL)

sudo dnf install nodejs protobuf protobuf-devel npm

If your distribution is newer (e.g. F24+), npm is included with nodejs and you won't need both.

Arch Linux

sudo pacman -S nodejs protobuf npm

Deb based (Debian, Ubuntu, Raspbian, et al)

For Debian stable, you'll need the latest node from sources:

sudo apt-get install -y curl build-essential libprotobuf-dev git pkg-config
curl -sL | sudo -E bash -
sudo apt-get install nodejs

For Debian testing, you can just get nodejs from the repository:

sudo apt-get install -y build-essential libprotobuf-dev git pkg-config nodejs


After you install the necessary packages, all Linux flavors follow this routine:

git clone
cd pogo-optimizer
npm install
npm run install-libs
npm start

This should launch the webserver on localhost:3000.

Setup using Docker

A prebuilt Docker image has been created for this repo. You can pull and start it by running:

$ docker run -d -p 3000:3000 -p 8081:8081 -it justinleewells/pogo-optimizer

If there have been updates to the repo, run docker pull justinleewells/pogo-optimizer before you do docker run -d -p 3000:3000 -p 8081:8081 -it justinleewells/pogo-optimizer

All ports are not accessible and usable as described above.

Docker setup for Windows (Docker)

Docker is VM software that will make running Pokemon Go Optimizer easier on Windows. This will require Hyper-V to be enabled on your CPU, this may need enabling in the BIOS if your CPU supports it. Some CPU's are not supported but if you have (Intel) VT-x or (AMD) AMD-V on the CPU this should work.

First install Docker If you do not have the Hyper-V installed from Microsoft, after running Docker for the first time, it will give you a warning. Accept this warning to install and restart your PC, if this does not work, there are manual instructions on how to complete this installation.

docker run -d -p 3000:3000 -p 8081:8081 -it justinleewells/pogo-optimizer

This should now run the latest version of Pokemon Go Optimizer! check using http://localhost:3000/

If this website is not accessible on other devices in your network, then you have some problems with your firewall setup and should disable it for ease of use. You could also setup firewall policies that allow inbound and outbound traffic on port 3000 and 8081.

If these Docker instructions didn't work for you, check out this Reddit post by mgxts for further instruction.

Phone Setup

Before proceeding to phone setup, you should have a webserver running on your host computer, and your phone and host computer should be connected to the same network.

Check your host computer's network settings for your IP address. If your host computer's IP is, you'll visit on your phone to view the pogo-optimizer application. Verify you can connect before continuing.

Next, visit and install the certificate. If your phone doesn’t understand .pem certificates (as is the case on Android devices), use instead.

There is currently a problem with some Android phones not accepting ca.pem or ca.crt certificates — Sony Z5 series on 6.0.1 has this problem.

The only way I have found to solve this problem is to install OpenSSL on your PC/Mac. Download the ca.crt to the phone and then install it at Root acccess level. For this task I used Root Certificate Manager. This is quite easy: just launch the tool, it will ask for Super User privileges, accept them, and then use the browser to find your new ca.crt file.

Then, add port 8081 as a proxy for your WiFi connection on your phone.

Lastly, after accepting the certificate and enabling the proxy, open Pokémon GO on your phone. After you can see your character walking around, go to http://localhost:3000 on your host machine. Enjoy!


To set up a WiFi proxy on your iOS 9.0.0+ phone, follow these steps:

  • Go to Settings > Wi-Fi
  • Click the information icon beside the network you are connected to
  • Select 'Manual' in the HTTP Proxy settings at the bottom
  • Enter e.g. as the server
  • Enter 8081 as the port


To set up a WiFi proxy on your Android 6.0.1+ phone, follow these steps:

  • Go to Settings > WiFi.
  • Choose your WiFi network from the list.
  • Select 'edit'
  • Select 'Show advanced options'
  • Under "Proxy," change the setting from None to Manual.
  • Enter e.g. as the proxy name.
  • Enter 8081 as the port


  • Implement dashboard
  • Implement lucky egg calculator
  • Utilize fully javascript protobuf implementation
  • Create Electron app

Feature Requests/Suggestions

I'd love to hear what feature requests and suggestions you all have, so feel free to shoot me an email or open an issue.