Metadata-Version: 2.1
Name: pymates
Version: 1.0.1
Author: Matt Harris
Author-email: WorkMatthewJHarris94@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: humanize
Requires-Dist: numpy
Requires-Dist: pillow
Requires-Dist: pytesseract

# Matt's Automatic Tracking Encounter Software

Videos:

<https://youtu.be/IkLZOhnaS2c>

<https://youtu.be/GtdwyRFSZAA>

Simple encounter tracker I slapped together in 3 days.
Entirely programmed for android phones on an android phone.

No I'm not joking.
![programming](https://i.imgur.com/BLCC92W.png)


## Important:
The reason this needs root is because like all the other encounter trackers it works by taking captures of the screen. This is not usually possible on android because to capture the screen you must use the screenshot API which will only show content the app that requested the screenshot has rendered which is useless for this.

I solved this issue by using a command that's tucked away in the binaries of android "screencap" this returns an unadulterated screenshot but is only accessible via root.

The nature of this is somewhat of a security concern but these captures are immediately deleted after scanning for PokÃ©mon.

These captures never leave your device but as a precaution I still wouldn't leave it capturing if anything other than pokemmo is on screen.

You can toggle capture by pressing enter with no command typed in.

### I am not liable nor responsible if you brick your phone trying to root it! If you don't understand phone rooting then it's probably not a great idea to root your phone just for this. There are pros and cons to rooted android.

## Requirements:


| rooted phone                                                     |
| ---------------------------------------------------------------- |
| termux float - <https://github.com/termux/termux-float/releases> |
| termux - <https://github.com/termux/termux-app/releases>         |
| tsu - (in termux: pkg install tsu)                               |
| python (in termux: pkg install python)                           |
| tesseract (in termux: pkg install tesseract)                     |
| pytesseract (in termux: pip install pytesseract)                 |
| opencv2 (in termux: pkg install opencv-python)                   |


don't get your hopes up too high. this is janky and sometimes doesnt work. if you have an issue please leave a report on the github issues page
<https://github.com/Th3M4ttman/MATES/issues>

## Installation:

Download the release zip and extract it to /storage/emulated/0/Documents

In termux enter:

python /storage/emulated/0/Documents/MATES/install.py

Installation is complete.

## Usage:

To run the software run "sudo mates" in termux float or "mates" if you added the alias

![interface](https://i.imgur.com/d97zLJc.jpeg)


| Number | Component                    |
| ------ | ---------------------------- |
| 1      | Capture indicator            |
| 2      | Shiny bonus chance           |
| 3      | Donator/Charm/Link indicator |
| 4      | Combat indicator             |
| 5      | Reported PokÃ©mon indicator   |
| 6      | Singles tracking indicator   |
| 7      | Command input/output         |


press enter to toggle capture on and off

Or type in commands


| Command                | Use                                            | Notes                                                                                      |
| ---------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Reset (PokÃ©mon)        | Resets encounters for selected PokÃ©mon.        | If given no PokÃ©mon resets all                                                             |
| add (number) (PokÃ©mon) | Adds number \* PokÃ©mon encounters              | You can also use "+"                                                                       |
| sub (number) (PokÃ©mon) | Subtracts number \* PokÃ©mon encounters         | You can also use "-"                                                                       |
| track (PokÃ©mon)        | Sets the PokÃ©mon as a tracked pokemon          | If given no PokÃ©mon it tracks all PokÃ©mon with registered encounters. You can also use "t" |
| untrack (PokÃ©mon)      | Sets the PokÃ©mon as an untracked pokemon       | If given no PokÃ©mon it untracks all. You can also use "u"                                  |
| total                  | Toggles the visibility of the total encounters |                                                                                            |
| charm                  | Toggles shiny charm                            |                                                                                            |
| donator                | Toggles donator                                |                                                                                            |
| link                   | Toggles shiny charm link                       |                                                                                            |
| singles                | Toggles single tracking                        |                                                                                            |
