Android Runtime Permissions made easy
Alternatives To Mayi
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
a year ago8October 27, 202122Java
Easy check permission library for Android Marshmallow
3 years ago5apache-2.0Java
Simpliest way to ask runtime permissions on Android, no need to extend class or override permissionResult method, choose your way : Kotlin / Coroutines / RxJava / Java7 / Java8
4 years ago1mitC#
Unity Android Runtime Permissions for Android Marshmallow
7 years ago1Java
2 years agoapache-2.0Kotlin
PermissionHelper for Android M, Kotlin best way
6 years agoapache-2.0Java
A simple library to make taking screenshots of your apps a breeze.
3 years agon,ullJava
Custom Permissions Dialogue is the only permissions library that supports ALL permission request scenarios. This library handles multiple edge cases such as not enabling all permissions or permanently rejecting a permission request.
Android Permissions Manager51
4 years ago2Kotlin
Easily manage Android Marshmallow and up runtime permissions.
Android Permissions Gradle Plugin39
5 years agoapache-2.0Kotlin
Plugin generating a helper class to deal with the new Permissions System in Marshmallow
a year ago
Request permissions from anywhere as long as you have context.
Alternatives To Mayi
Select To Compare

Alternative Project Comparisons


View Releases and Changelogs

Maven Central

MayI is yet another library that simplifies the process of requesting permissions at runtime for devices that run Android Marshmallow and above.

As of Androids Marshmallow and above a new functionality has been added that lets users grant or deny permissions while an app is running instead of granting them all together when installing it. This approach gives the user more control over applications but requires developers to add lots of code to support it.

This library aims to reduce boilerplate code needed to request permissions at runtime by featuring a simple chainable API designed the way I want it.


Demo screenshot


Add the following to your app module build.gradle file

dependencies {
    implementation 'io.github.thanosfisherman.mayi:mayi:<latest-version-number-here>'


Single Permission

To request a single permission using this library, you just need to call MayI with a valid Activity and use withPermission method:

class MainActivity : AppCompatActivity() {
	override fun onCreate(savedInstanceState: Bundle?) {
	     super.onCreate(savedInstanceState: Bundle?)



permissionResultSingle and permissionRationaleSingle could be custom-defined methods of your own that would deal accordingly in each situation. For Example:

private fun permissionResultSingle(permission: PermissionBean) {
    Toast.makeText(this, "PERMISSION RESULT $permission", Toast.LENGTH_LONG).show()
    Log.i("MainActivity", "PERMISSION RESULT $permission")
private fun permissionRationaleSingle(bean: PermissionBean, token: PermissionToken) {
    Toast.makeText(this, "Should show rationale for " + bean.simpleName + " permission", Toast.LENGTH_LONG).show()
    Log.i("MainActivity", "Should show rationale for ${bean.simpleName}")

Multiple Permissions

Similarly to request multiple permissions at once, you just need to call Mayi with a valid Activity but this time use withPermissions method to specify more than one permissions. Furthermore the lambda expressions from the example above could be replaced with method references like so:

class MainActivity : AppCompatActivity() {

	override fun onCreate(savedInstanceState: Bundle?) {
	   	 super.onCreate(savedInstanceState: Bundle?)

            .withPermissions(Manifest.permission.READ_CONTACTS, Manifest.permission.ACCESS_FINE_LOCATION)

Again possible custom-defined methods for the above example could be something like:

private fun permissionResultMulti(permissions: List<PermissionBean>) {
    Toast.makeText(this, "MULTI PERMISSION RESULT $permissions", Toast.LENGTH_LONG).show()
    Log.i("MainActivity", "MULTI PERMISSION RESULT $permissions")


private fun permissionRationaleMulti(permissions: List<PermissionBean>, token: PermissionToken) {
    Toast.makeText(this, "Rationales for Multiple Permissions $permissions", Toast.LENGTH_LONG).show()
    Log.i("MainActivity", "Rationales for Multiple Permissions $permissions")


Error handling

If you think there is going to be an error in your Mayi integration, just call a onErrorListener:

       .withPermissions(Manifest.permission.READ_CONTACTS, Manifest.permission.ACCESS_FINE_LOCATION)
private fun inCaseOfError(e: Exception) {
       Toast.makeText(this, "ERROR $e", Toast.LENGTH_SHORT).show()
       Log.e("MainActivity", "ERROR $e")

The library will then notify you when something unexpected happens.

Library Flow

  • The first time this library runs, system permission promt will appear asking for the user to either deny or allow the permission. Next onResult() method will be called that includes the result of the user's choice.
  • If user denied the permission the first time (but didn't check "don't ask again" option) then onRationale will be the first method to be called next time this library runs. Inside onRationale method you now have 3 options.
    • Call token.continuePermissionRequest() method which shows again system dialog prompt and then calls onResult() that includes the user's choice.
    • Call token.skipPermissionRequest() method which will skip showing system dialog prompt and immediately call onResult() that includes the user's choice.
    • Call none of the 2 above thus terminating the flow after onRationale finishes its execution.
  • If user denied the permission by checking "don't ask again" then onResult() will be called that includes the result of the user's choice. You may check whether the permission has been permanently denied via the PermissionBean#isPermanentlyDenied() method which is included in the onResult().

below is a flow chart that visualizes the library's flow described above.

mayi flow


Feel free to add/correct/fix something to this library, I will be glad to improve it with your help.



Copyright 2018 Thanos Psaridis

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
Popular Permission Projects
Popular Marshmallow Projects
Popular Security Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Kotlin Android
Kotlin Library