An open API service indexing awesome lists of open source software.

https://github.com/williamfzc/pyminitouch

python wrapper of minitouch, for better experience
https://github.com/williamfzc/pyminitouch

android minitouch python

Last synced: 4 months ago
JSON representation

python wrapper of minitouch, for better experience

Awesome Lists containing this project

README

          

# pyminitouch

[![PyPI version](https://badge.fury.io/py/pyminitouch.svg)](https://badge.fury.io/py/pyminitouch)

python wrapper of [minitouch](https://github.com/openstf/minitouch), for better experience.

[中文文档](README_zh.md)

## TL;DR

An easy way to use [minitouch](https://github.com/openstf/minitouch) with python.

### Before

- Check device abi
- Download a specified version minitouch
- Install and run it
- Build a socket
- Send message with socket, and your message seems like:
- `d 0 150 150 50\nc\nu 0\nc\n`
- hard to read

An unfriendly process.

### After

```python
from pyminitouch import MNTDevice

_DEVICE_ID = '123456F'
device = MNTDevice(_DEVICE_ID)

# single-tap
device.tap([(400, 600)])
# multi-tap
device.tap([(400, 400), (600, 600)])
# set the pressure, default == 100
device.tap([(400, 600)], pressure=50)

# ... and something else you want, just like minitouch itself!

# and, after usage, you MUST call function `stop` to stop service
device.stop()
```

You don't need to care about installation/device version/dependencies anymore. All you need is running the script.

Read [demo.py](demo.py) for detail.

## Installation

Please use python3.

```
pip install pyminitouch
```

## How it work?

- Do the same things as [Before](#Before) in TLDR
- Wrap it and offer pythonic API for users

## Bug & Suggestion

Please let me know via issue :)

## License

[MIT](LICENSE)