Skip to content

Macintosh Installation and requirements

Nicholas Bonini edited this page Aug 1, 2016 · 12 revisions

In order to run the project, you will need Python, pip and the project dependencies. Version 2.7 is what we usually test against. You can use 3.x but no support will be given.

PokemonGo-Map: Macintosh Installation


Prerequisites for this guide

  • Mac OSX 10.9+

Step 1: Install Homebrew

Nope

Step 2: Install Requirements

There is no step 2.

Step 3: Clone PokemonGo-Map

For this guide we'll be using the Documents folder.

While still in the Terminal

  1. Navigate to the user home folder. cd ~/Documents

  2. Clone the repository. git clone https://github.com/AHAAAAAAA/PokemonGo-Map.git

Now we have all PokemonGo-Map files inside our Documents folder. Git clone automatically creates a folder called PokemonGo-Map

Step 4: Get your own Google Maps API Key

Go to this page to get your own Google Maps API Key. Additionally, you do not need to just get the key but you need to ensure the Google Maps JavaScript API is enabled for your account. This is done from the homepage of the Google developer tools. Just getting the key alone does not automatically enable the JavaScript API that is necessary for the application.

If you got your own API Key, open the config.ini (clone config.ini.example file and remove .example extension) file inside the PokemonGo-Map/config folder. You can edit that file with Mac's built in text editor. Now put the API key in the gmaps-key: line and remove the #.

Step 6: Setup PokemonGo-Map

While still in the Terminal:

  1. Navigate into PokemonGo-Map folder. cd ~/Documents/PokemonGo-Map

  2. Install specific python requirements curl https://bootstrap.pypa.io/get-pip.py > get-pip.py && sudo python ./get-pip.py && sudo -H easy_install --upgrade six && sudo -H easy_install --upgrade setuptools && sudo -H pip install -r requirements.txt

Step 7: Start PokemonGo-Map

Now we are ready to start the map.

A full list of parameters you can use with the map and what they mean can be found here. This guide will only cover the important ones:

-a: Use either ptc or google for the login
-u: Your Username
-p: Your Password
-l: The location you want to scan for Pokémon. You can try something like La tour Eiffel, Paris, your street or exact coordinates in this format: 47.6062100 -122.3320700
-st: The amount of steps to take (5 steps is approximately a 1.2km radius (this information is outdated))

Note: It's recommended that you create a dummy account to use this Map with in order to prevent your real account from getting (soft)banned.

Note: If you use a Google account that has 2FA (two factor authentication) enabled, see "Can I sign in with Google?" in the FAQ.

The final command should look like this (for master branch): python runserver.py -a ptc -u johndoe -p ilovemama -l "400 Broad St, Seattle, WA 98109, USA" -st 5

Hit enter and view your map in all it's glory at http://127.0.0.1:5000/. Done!

Map


Bonus: How to update PokemonGo-Map

Since PokemonGo-Map is under active development and gets a lot of updates, you probably want to get all the latest features and bug fixes. You can see the latest updates (called commits) here. To update your copy, Git Bash here from the PokemonGo-Map folder, paste this command and hit enter:

git pull

Now repeat Step 7 to restart your map.