Plyer
Plyer is a platform-independent api to use features commonly found on various platforms, notably mobile ones, in Python.
How plyer works?
Plyer tries not to reinvent the wheel, and will call for external libraries to implement the api in the easiest way, depending on the current platform.
- On Android(python-for-android), pyjnius is used
- On iOS(kivy-ios), pyobjus is used
- On windows/mac/linux, commonly found libraries and programs will be used
Supported APIs
| Platform | Android | iOS | Windows | OS X | Linux |
|---|---|---|---|---|---|
| Accelerometer | ✔ | ||||
| Audio recording | ✔ | ||||
| Barometer | ✔ | ||||
| Battery | |||||
| Bluetooth | |||||
| Brightness | ✔ | ✔ | |||
| Call | ✔ | ||||
| Camera (taking picture) | ✔ | ||||
| Compass | |||||
| CPU count | |||||
| Devicename | ✔ | ||||
| Email (open mail client) | |||||
| Flash | |||||
| GPS | |||||
| Gravity | |||||
| Gyroscope | |||||
| Humidity | |||||
| IR Blaster | ✔ | ||||
| Keystore | |||||
| Light | |||||
| Maps | ✔ | ✔ | |||
| Native file chooser | |||||
| Notifications | ✔ | ✔ | |||
| Orientation | ✔ | ||||
| Proximity | |||||
| Screenshot | |||||
| SMS (send messages) | ✔ | ||||
| Spatial Orientation | ✔ | ||||
| Speech to text | |||||
| Storage Path | |||||
| Temperature | |||||
| Text to speech | |||||
| Unique ID | |||||
| Vibrator | |||||
| Wifi |
Installation
To use on desktop: pip install plyer
To use in python-for-android/kivy-ios: add plyer to your requirements if needed.
Support
If you need assistance, you can ask for help on our mailing list:
- User Group : https://groups.google.com/group/kivy-users
- Email : [email protected]
Discord channel:
- Server : https://chat.kivy.org
- Channel : #dev
Contributing
We love pull requests and discussing novel ideas. Check out our contribution guide and feel free to improve Plyer.
The following mailing list and IRC channel are used exclusively for discussions about developing the Kivy framework and its sister projects:
- Dev Group : https://groups.google.com/group/kivy-dev
- Email : [email protected]
IRC channel:
- Server : irc.freenode.net
- Port : 6667, 6697 (SSL only)
- Channel : #kivy-dev
License
Plyer is released under the terms of the MIT License. Please refer to the LICENSE file.
Contributors
This project exists thanks to all the people who contribute. [Contribute].
Backers
Thank you to all our backers!
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]
