Map'A'Droid is a Raid & Pokémon scanner for Pokémon GO, based on Android devices.
- Discord - For general support
- Github Issues - For reporting bugs (not for support!)
- Python 3.6
- MySQL database, with RocketMap or Monocle structure
- Rooted Android device
- PogoDroid token (only necessary for MITM Mode), obtainable via Patreon
MAD is compatible with this Monocle schema and this RocketMap fork. Please use them or change your database accordingly.
Install python 3.6
& pip3
according to docs for your platform. Make sure you carefully check the command, since even if python3.6 is installed, the python3
command could still point to python3.5
or below!
Once Python is installed, ensure that pip
and python
is installed correctly by running:
python3 --version
- should return3.6.x
pip3 --version
- If it returns a version, it is working.
Clone this repository:
git clone https://github.com/Map-A-Droid/MAD.git
Make sure you're in the directory of MAD and run:
pip3 install -r requirements.txt
If you want to use OCR to scan raids, run with requirements_ocr.txt
and install additional packages: apt-get install tesseract-ocr python-opencv
RGC (Remote GPS Controller) is responsible for receiving the GPS commands from your server, taking screenshots (if OCR is enabled) and managing Pokémon Go on the phone (restarting, detecting if POGO is opened, etc)
PogoDroid is the MITM (Man in the middle) App for reading the data from Pokémon Go and send it to your server. If you use the OCR method, you don’t need this app.
Inside the config
folder, duplicate the config.ini.example
and rename it to config.ini
. Then populate it with at least the database and websocket configurations.
In order to map devices to areas, do the same with mappings_example.json
and rename it to mappings.json
Refer to mappings_example.json for examples or run python3 start.py -wm
and open the MADMIN mappings editor (http://localhost:5000).
Each area requires geofence_included
. A geofence can easily be created with geo.jesparke.net
A geofence requires a name:
[geofence name]
withlat, lng
per line, no empty lines at the end of file
- Ensure your phone has an unlocked bootloader and is able to support root. Lineage OS is a good place to start for a custom ROM and they have good installation instruction for each device.
- Install Magisk to root the phone via recovery. Repackage the MagiskManager App and add Pokémon Go to Magisk Hide. Make sure to delete the folder
/sdcard/MagiskManager
after repackaging.
It's necessary to pass the Safetynet check to run Pokémon Go on rooted phones. Check the Safetynet status in the MagiskManager App.
Install RGC (Remote GPS Controller) and PogoDroid (only necessary for MITM mode) on the phone. RGC must be installed as a system app. Best practice is to convert it to a system app with link2sd.
Both apps requires an Origin header field that's configured in mappings.json. These Origins need to be unique per running python instance.
The websocket URI for RGC is ws://<ip>:<port>
and the POST destination for PogoDroid is http://<ip>:<port>
.
The port for RGC is 8080 by default and can changed with
ws_port
. The port for PogoDroid is 8000 by default and can changed withmitmreceiver_port
. The IP address is the IP of your server, not your phone!
To login into PogoDroid, you need a token. You can obtain a token by clicking on Get Token
in PogoDroid and sending the command !settoken <your_token>
to the MAD Discord Bot. This will only work, if you're a Patreon supporter and linked your account to Discord.
Make sure you're in the directory of MAD and run:
python3 start.py
Usually you want to append -wm
and -os
as arguments to start madmin (browser based monitoring) and the scanner (-os
) responsible
for controlling devices and receiving data from Pogodroid (if OCR enabled, also take screenshots).
If you want to run OCR on screenshots, run -oo
to analyse screenshots
MADMIN is a web frontend to configure MAD to your needs, see the current position of your devices, fix OCR failures. You can enable it with with_madmin
in the config file or -wm
as a command line argument. The default port is 5000. See the config.ini.example for more options.
RGC and PogoDroid both support wss/HTTPS respectively. Thus you may setup reverse proxies for MAD. The Auth headers in RGC and Pogodroid both use Basic auth. Meaning the password/username is not encrypted per default, that's to be done by SSL/TLS (wss, HTTPS).