maoni - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #golang #go #android #deep-learning #linux #docker #windows #awesome #security #mcp #open-source

maoni

(★ 151)

Lightweight library for collecting and handling user feedback from within Android applications.

File Explorer

Download Latest Version (.zip)

- - build.yml
  - stale.yml
  - translations.yml
  - website.yml
- dependabot.yml
- - .gitignore
  - build.gradle
  - gradle.properties
  - README.md
- - .gitignore
  - build.gradle
  - gradle.properties
  - LICENSE
  - README.md
- - .gitignore
  - build.gradle
  - gradle.properties
  - LICENSE
  - README.md
- - .gitignore
  - build.gradle
  - gradle.properties
  - LICENSE
  - README.md
- - .gitignore
  - build.gradle
  - gradle.properties
  - LICENSE
  - README.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- .gitignore
- build.gradle
- gradle.properties
- proguard-rules.pro
- .gitignore
- build.gradle
- gradle.properties
- .gitignore
- build.gradle
- proguard-rules-r8.pro
- proguard-rules.pro
- import-translations-github.sh
- update-github-pages.sh
.all-contributorsrc
.codeclimate.yml
.gitignore
.pre-commit-config.yaml
.watchmanconfig
.zappr.yaml
build.gradle
CODE_OF_CONDUCT.md
crowdin.yaml
debug.keystore
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle

# Installation Guide

1. Get the code

git clone https://github.com/rm3l/maoni

Downloads the entire project code from GitHub to your computer.

cd maoni

Moves into the project folder you just downloaded.

2. Gradle (Java/Kotlin)

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java/Kotlin projects.
Gradle If the repo includes gradlew (Gradle Wrapper), you don't need to install Gradle separately.

./gradlew lintDebug testDebug assembleDebug

Builds the project using Gradle.

./gradlew javadoc publishToSonatype closeAndReleaseStagingRepository

Builds the project using Gradle.

✅ A BUILD SUCCESSFUL message means it worked. The output is created under build/.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Maven Central](https://img.shields.io/maven-central/v/org.rm3l/maoni)](https://search.maven.org/artifact/org.rm3l/maoni)
[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/rm3l/maoni/blob/master/LICENSE)

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Maoni-blue.svg?style=flat)](http://android-arsenal.com/details/1/3925)
[![Website](https://img.shields.io/website-up-down-green-red/http/maoni.rm3l.org.svg)](http://maoni.rm3l.org)

[![CI](https://github.com/rm3l/maoni/actions/workflows/build.yml/badge.svg)](https://github.com/rm3l/maoni/actions/workflows/build.yml)
[![Translations](https://github.com/rm3l/maoni/actions/workflows/translations.yml/badge.svg)](https://github.com/rm3l/maoni/actions/workflows/translations.yml)
[![Website](https://github.com/rm3l/maoni/actions/workflows/website.yml/badge.svg)](https://github.com/rm3l/maoni/actions/workflows/website.yml)

[![Maintainability](https://api.codeclimate.com/v1/badges/6deec1732c359d492b3e/maintainability)](https://codeclimate.com/github/rm3l/maoni/maintainability)
[![Issue Count](https://codeclimate.com/github/rm3l/maoni/badges/issue_count.svg)](https://codeclimate.com/github/rm3l/maoni)

[![All Contributors](https://img.shields.io/badge/all_contributors-12-orange.svg?style=flat-square)](https://raw.githubusercontent.com/rm3l/maoni/master/)

[![GitHub watchers](https://img.shields.io/github/watchers/rm3l/maoni.svg?style=social&label=Watch)](https://github.com/rm3l/maoni)
[![GitHub stars](https://img.shields.io/github/stars/rm3l/maoni.svg?style=social&label=Star)](https://github.com/rm3l/maoni)
[![GitHub forks](https://img.shields.io/github/forks/rm3l/maoni.svg?style=social&label=Fork)](https://github.com/rm3l/maoni)

**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*

- [Motivations](#motivations)
- [Sample App](#sample-app)
- [Preview](#preview)
- [Getting started](#getting-started)
  - [Putting it together](#putting-it-together)
    - [Available callbacks](#available-callbacks)
      - [maoni-email](#maoni-email)
      - [maoni-slack](#maoni-slack)
      - [maoni-github](#maoni-github)
      - [maoni-jira](#maoni-jira)
      - [maoni-doorbell](#maoni-doorbell)
    - [Sharing the files captured with other apps](#sharing-the-files-captured-with-other-apps)
- [Contribute and Improve Maoni!](#contribute-and-improve-maoni)
  - [Building from source](#building-from-source)
  - [Translations](#translations)
  - [Contributing callbacks for Maoni](#contributing-callbacks-for-maoni)
  - [Publishing a new release](#publishing-a-new-release)
- [In use in the following apps](#in-use-in-the-following-apps)
- [Credits](#credits)
- [Developed by](#developed-by)
- [Contributors](#contributors)
- [Sponsors](#sponsors)
- [License](#license)

**Maoni** is a lightweight open-source library for integrating 
a way to collect user feedback from within Android applications.

Built from the ground up with the [Material Design](https://www.google.com/design/spec/material-design) 
principles in mind, it allows to capture a screenshot of the activity the user is currently viewing 
and attach it to the feedback.

Just provide callbacks implementations and you're good to go. 
Maoni will take care of collecting feedback and call those implementations.

Below is a quick overview of the features included:
- **Contextual information**. Device and application information, if available.
    - Device screen resolution, mobile data and GPS states, ...
- **Screenshot and logs capture**. 
    - Because receiving a feedback with contextual information is much much 
    better for analysis, Maoni allows to take a screen capture of the calling activity, along with the application logs.
    Note that the inclusion of such screenshot and logs in the feedback object is opt-out, at the user's discretion.
    - Touch to preview screenshot
    - Ability for users of your app to highlight or blackout items in the screen capture. They may choose to 
    highlight relevant items or blackout any sensitive information.
- **Customization**.
    - Besides the default form fields, you are free to include an extra layout 
    with additional views. And you always have access to the underlying view elements.
    - Theme elements and styles can be adjusted.
- **Callbacks**.
    - Form validation. You can provide your own if needed for example for your extra fields.
    - Listeners. Upon validation, Maoni calls the callbacks implementations you provided earlier.
    So you just have limitless possibilities for an integration with any remote feedback services. For reference, the following implementations are provided as external dependencies:
        - [maoni-email](callbacks/maoni-email/), so your users can send their feedback via email
        - [maoni-slack](callbacks/maoni-slack/), so your users can send their feedback to Slack
        - [maoni-jira](callbacks/maoni-jira/), to send user feedback as JIRA issues (to the JIRA host of your choice)
        - [maoni-github](callbacks/maoni-github/), to send user feedback as Github issues (to the Github repository of your choice)
        - [maoni-doorbell](callbacks/maoni-doorbell), to send user feedback to [Doorbell.io](https://doorbell.io/home)

Take a look at the [sample application](https://play.google.com/store/apps/details?id=org.rm3l.maoni.sample) 
for a quick overview.

## Motivations

While working on a new version of [DD-WRT Companion](https://ddwrt-companion.app/), 
one of my Android apps, I needed a simple yet pleasant way to collect user feedback, 
along with some contextual information.
I experimented with a simple dialog, then tried a bunch of other libraries, 
but could not find one with screenshot capturing capabilities, not vendor lock-in, 
and which is almost a no-brainer as to integrating with any remote services.
I was also looking for screen capture highlight / blackout capabilities, as in use for issue reporting in 
several apps from Google.

So as a way to give back to the Open Source community, 
I decided to create Maoni as a separate library project.

By the way, as a side note, Maoni is a Swahili word for comments or opinions.

## Sample App

<a href="https://play.google.com/store/apps/details?id=org.rm3l.maoni.sample">
  <img alt="Get it on Google Play"
       src="https://developer.android.com/images/brand/en_generic_rgb_wo_45.png" />
</a>

## Preview

<img width="40%" src="https://raw.githubusercontent.com/rm3l/maoni/master/doc/screenshots/raw/maoni_2.3.1.gif"/>

## Getting started

This library is published on [Maven Central](https://search.maven.org/artifact/org.rm3l/maoni). So importing it should be straightforward.
Declare the [Maven Central repository](https://repo.maven.apache.org/maven2/) (if not done yet) and import this project:

```gradle
  repositories {
      //...
      mavenCentral()
  }

dependencies {
    // ...
    implementation('org.rm3l:maoni:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
  }
```

### Putting it together

Integrating with Maoni is intended to be seamless and straightforward for most existing 
Android applications.

Just leverage the fluent Maoni Builder to construct and start an Maoni instance at the right place 
within your application workflow (for example a button click listener, or a touch of a menu item).

For example, to start with just the defaults:
```java
    //The optional file provider authority allows you to 
    //share the screenshot capture file to other apps (depending on your callback implementation)
    new Maoni.Builder(<myContextObject>, MY_FILE_PROVIDER_AUTHORITY)
        .withDefaultToEmailAddress("feedback@my.company.com")
        .build()
        .start(MaoniSampleMainActivity.this); //The screenshot captured is relative to this calling activity 
```

To customize every aspect of your Maoni activity, call the fluent methods of `Maoni.Builder`, e.g.:
```java
    // MyHandlerForMaoni is a custom implementation of Maoni.Handler, 
    // which is a shortcut interface for defining both a validator and listeners for Maoni
    final MyHandlerForMaoni myHandlerForMaoni = new MyHandlerForMaoni(MaoniSampleMainActivity.this);
    
    //The optional file provider authority allows you to 
    //share the screenshot capture file to other apps (depending on your callback implementation)
    new Maoni.Builder(MY_FILE_PROVIDER_AUTHORITY)
        .withWindowTitle("Send Feedback") //Set to an empty string to clear it
        .withMessage("Hey! Love this app? We would love to hear from you.")
        .withExtraLayout(R.layout.my_feedback_activity_extra_content)
        .withHandler(myHandlerForMaoni) //Custom Callback for Maoni
        .withFeedbackContentHint("[Custom hint] Write your feedback here")
        .withIncludeScreenshotText("[Custom text] Include screenshot")
        .withTouchToPreviewScreenshotText("Touch To Preview and Edit")
        .withContentErrorMessage("Custom error message")
        .withScreenshotHint("Custom test: Lorem Ipsum Dolor Sit Amet...")
        //... there are other aspects you can customize
        .build()
        .start(MaoniSampleMainActivity.this); //The screenshot captured is relative to this calling activity 
```

**You're good to go!** Maoni will take care of validating / collecting user feedback 
and call your callbacks implementations.

#### Available callbacks
Some common callbacks for Maoni are available as external dependencies to include in your application.

##### [maoni-email](callbacks/maoni-email/README.md)

This callback opens up an Intent for sending an email with the feedback collected.
This is the default fallback listener used in case no other listener has been set explicitly.
In other words, you need not import `maoni-email` as an extra dependency.
Just import `maoni` as depicted above, and you're good to go.

Add this additional line to your `build.gradle`:

```gradle
  dependencies {
    // ...
    implementation('org.rm3l:maoni:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
  }
```

And set it as the listener for your Maoni instance:
```java
    final org.rm3l.maoni.email.MaoniEmailListener emailListenerForMaoni = 
            new org.rm3l.maoni.email.MaoniEmailListener(...);
    
    new Maoni.Builder(MY_FILE_PROVIDER_AUTHORITY)
        .withListener(emailListenerForMaoni) //Callback from maoni-email
        //...
        .build()
        .start(MaoniSampleMainActivity.this); //The screenshot captured is relative to this calling activity 
```

Visit the dedicated [README](callbacks/maoni-email/README.md) for further details.

##### [maoni-slack](callbacks/maoni-slack/README.md)

This callback sends feedback collected to Slack via an [an incoming WebHook integration](https://my.slack.com/services/new/incoming-webhook).
 
 To use it, you must first [set up an incoming WebHook integration](https://my.slack.com/services/new/incoming-webhook), and grab the Webhook URL.

Add this additional line to your `build.gradle`:

```gradle
  dependencies {
    // ...
    implementation('org.rm3l:maoni:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
    implementation('org.rm3l:maoni-slack:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
  }
```

And set it as the listener for your Maoni instance
```java
    final org.rm3l.maoni.slack.MaoniSlackListener slackListenerForMaoni = 
            new org.rm3l.maoni.slack.MaoniSlackListener(...); //Pass the Slack WebHook URL, channel, ...
    
    new Maoni.Builder(MY_FILE_PROVIDER_AUTHORITY)
        .withListener(slackListenerForMaoni) //Callback from maoni-slack
        //...
        .build()
        .start(MaoniSampleMainActivity.this); //The screenshot captured is relative to this calling activity 
```

Visit the dedicated [README](callbacks/maoni-slack/README.md) for further details.

##### [maoni-github](callbacks/maoni-github/README.md)

This callback sends feedback collected as a Github issue to a specified Github repository.

To use it, you will need to have an account there, and grab your Personal Access Token.
You may want to create a dedicated `reporter` user for that purpose.

Add this additional line to your `build.gradle`:

```gradle
  dependencies {
    implementation('org.rm3l:maoni:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
    implementation('org.rm3l:maoni-github:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
  }
```

And set it as the listener for your Maoni instance:
```java
    //Customize the maoni-github listener, with things like your user personal Access Token on Github
    final org.rm3l.maoni.github.MaoniGithubListener listenerForMaoni = 
            new org.rm3l.maoni.github.MaoniGithubListener(...);
    
    new Maoni.Builder(MY_FILE_PROVIDER_AUTHORITY)
        .withListener(listenerForMaoni) //Callback from maoni-github
        //...
        .build()
        .start(MaoniSampleMainActivity.this); //The screenshot captured is relative to this calling context 
```

Visit the dedicated [README](callbacks/maoni-github/README.md) for further details.

##### [maoni-jira](callbacks/maoni-jira/README.md)

This callback sends feedback collected as a JIRA issue to a specified JIRA project.

You may want to create a dedicated `reporter` user on your JIRA Host for that purpose.

Add this additional line to your `build.gradle`:

```gradle
  dependencies {
    implementation('org.rm3l:maoni:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
    implementation('org.rm3l:maoni-jira:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
  }
```

And set it as the listener for your Maoni instance:
```java
    //Customize the maoni-jira listener, with things like your REST URL, username, password
    final org.rm3l.maoni.jira.MaoniJiraListener listenerForMaoni = 
            new org.rm3l.maoni.jira.MaoniJiraListener(...);
    
    new Maoni.Builder(MY_FILE_PROVIDER_AUTHORITY)
        .withListener(listenerForMaoni) //Callback from maoni-jira
        //...
        .build()
        .start(MaoniSampleMainActivity.this); //The screenshot captured is relative to this calling context 
```

Visit the dedicated [README](callbacks/maoni-jira/README.md) for further details.

##### [maoni-doorbell](callbacks/maoni-doorbell/README.md)

This callback sends feedback collected to [Doorbell](https://www.doorbell.io).

To use it, you will need to have an account there, and grab your application ID and secret key.

Add this additional line to your `build.gradle`:

```gradle
  dependencies {
    // ...
    implementation('org.rm3l:maoni:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
    implementation('org.rm3l:maoni-doorbell:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
  }
```

And set it as the listener for your Maoni instance:
```java
    final org.rm3l.maoni.doorbell.MaoniDoorbellListener doorbellListenerForMaoni = 
            new org.rm3l.maoni.doorbell.MaoniDoorbellListener(...);
    
    new Maoni.Builder(MY_FILE_PROVIDER_AUTHORITY)
        .withListener(doorbellListenerForMaoni) //Callback from maoni-doorbell
        //...
        .build()
        .start(MaoniSampleMainActivity.this); //The screenshot captured is relative to this calling activity 
```

Visit the dedicated [README](callbacks/maoni-doorbell/README.md) for further details.

#### Sharing the files captured with other apps

The file provider authority specified in the `Maoni.Builder` constructor allows you to 
share the screenshot capture and logs files to other apps (depending on your callback implementation).
By default, Maoni stores the files captured in your application cache directory, 
but this is (again) entirely customizable.

You must declare a file content provider in your `AndroidManifest.xml` file with an explicit list 
of sharable directories for other apps to be able to read the screenshot file. 
For example:

- If you use AndroidX:

```xml
<application>
    
    
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="com.mydomain.fileprovider"
        android:grantUriPermissions="true"
        android:exported="false">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/filepaths" />
    </provider>
</application>
```

- Otherwise:

```xml
<application>
    
    
    <provider
        android:name="android.support.v4.content.FileProvider"
        android:authorities="com.mydomain.fileprovider"
        android:grantUriPermissions="true"
        android:exported="false">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/filepaths" />
    </provider>
</application>
```

Along with the XML file that specifies the sharable directories (under `res/xml/filepaths.xml` as specified above):
```xml
<paths>
    
    <cache-path name="maoni-shares" path="." />
    
</paths>
```

See [https://goo.gl/31nStZ](https://goo.gl/31nStZ) for further instructions on how to setup file sharing.

## Contribute and Improve Maoni!

Contributions and issue reporting are more than welcome. 
So to help out, do feel free to fork this repo and open up a pull request. 
I'll review and merge your changes as quickly as possible.

You can use [GitHub issues](https://github.com/rm3l/maoni/issues) to report bugs. 
However, please make sure your description is clear enough and has sufficient instructions 
to be able to reproduce the issue.

You can also use the [sample app](https://play.google.com/store/apps/details?id=org.rm3l.maoni.sample) 
to send your feedback with Maoni. ;-)

### Building from source

Make sure you have the Android SDK installed.

Also make sure you have the appropriate Build Tools installed. You can install them via the Android's `sdkmanager`:
```bash
sdkmanager "build-tools;28.0.3"
```

Now you can build the project with the `Gradle Wrapper`:
```bash
./gradlew lintDebug testDebug assembleDebug
```

You will then find the artifacts under the following folders:
- `maoni/build/outputs/aar/`
- `maoni-common/build/libs/`
- `maoni-sample/build/outputs/apk/`

### Translations
 
I use Crowdin as the translation system. All related resources for localization are automatically generated from files got with Crowdin.

To help out with any translation, please head to [Crowdin](http://crowdin.net/project/maoni) 
and request to join the translation team. 
If your language is not listed there, just drop me an e-mail at &lt;apps+maoni@rm3l.org&gt;.

Please do **not** submit GitHub pull requests with translation fixes as any changes will be overwritten 
with the next update from Crowdin.

### Contributing callbacks for Maoni

You can create separate Android Library Projects that implement any of the Maoni callbacks interfaces 
(`Validator`, `Listener`, `UiListener`, `Handler` or any combination), 
so users can use them in their projects.

You just have to include `maoni-common` as a dependency in your project, e.g., with Gradle:

```gradle
  dependencies {
    // ...
    api('org.rm3l:maoni-common:10.0.0@aar') {
        transitive = true
        //Needed because of https://github.com/rm3l/maoni/issues/294
        exclude module: 'unspecified'
    }
  }
```
You can write your project in any JVM language of your choice (e.g., [Kotlin](https://kotlinlang.org/), as with [maoni-slack](https://github.com/rm3l/maoni-slack) and [maoni-github](https://github.com/rm3l/maoni-github)), as long as the callback implementation can be called from Maoni.

### Publishing a new release

All releases (Git tags) are published to [Maven Central](https://search.maven.org/search?q=g:org.rm3l) via [Sonatype](https://oss.sonatype.org/#welcome).

The `.github/workflows/build.yml` Workflow file contains a Job responsible for publishing libraries to Sonatype whenever a new tag is pushed.

Alternatively, this operation may be performed manually.
To do so, you can update or create a `local.properties` file (local only, **not** under version control) file at the root of this project.
This file should contain at least the following properties:

- `signing.keyId` : the GPG Signing Key ID
- `signing.secretKeyRingFile` : the path to the GPG signing key file, to use for signing files uploaded to Maven Central
- `signing.password` : the GPG signing key password
- `ossrhUsername` : the Sonatype Nexus Repository username
- `ossrhPassword` : the Sonatype Nexus Repository user password
- `sonatypeStagingProfileId`: the Staging Repo Profile ID (ask one maintainer to provide such information)

The following command can then be run to publish a new version:

```bash
./gradlew javadoc publishToSonatype closeAndReleaseStagingRepository
```

## In use in the following apps

(If you use Maoni, please drop me a line at &lt;apps+maoni@rm3l.org&gt; 
(or again, fork, modify this file and submit a pull request), so I can list your app(s) here)

* [DD-WRT Companion](https://ddwrt-companion.app)
* [DD-WRT Companion Tasker Plugin](https://play.google.com/store/apps/details?id=org.rm3l.ddwrt.tasker)
* [Androcker](https://play.google.com/store/apps/details?id=org.rm3l.container_companion)

## Credits

* [DrawableView](https://github.com/PaNaVTEC/DrawableView), by [Christian Panadero Martinez](https://github.com/PaNaVTEC)

## Developed by

* Armel Soro
  * [keybase.io/rm3l](https://keybase.io/rm3l)
  * [rm3l.org](https://rm3l.org) - &lt;apps+maoni@rm3l.org&gt; - [@rm3l](https://twitter.com/rm3l)
  * [paypal.me/rm3l](https://paypal.me/rm3l)
  * [coinbase.com/rm3l](https://www.coinbase.com/rm3l)

## Contributors

Thanks to the following people who help(ed) improve Maoni, 
either by suggesting translations or by reporting an issue and/or submitting pull requests.

In no particular order:

<table>
  <tr>
    <td align="center"><a href="https://github.com/MariusVolkhart"><img src="https://avatars.githubusercontent.com/u/1709517?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Marius Volkhart</b></sub></a><br /><a href="https://github.com/rm3l/maoni/commits?author=MariusVolkhart" title="Code">💻</a> <a href="https://github.com/rm3l/maoni/issues?q=author%3AMariusVolkhart" title="Bug reports">🐛</a></td>
    <td align="center"><a href="https://kalabasa.github.io/"><img src="https://avatars.githubusercontent.com/u/3705081?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Lean Rada</b></sub></a><br /><a href="https://github.com/rm3l/maoni/commits?author=Kalabasa" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/isacastillor"><img src="https://avatars.githubusercontent.com/u/36340751?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Isamar Castillo</b></sub></a><br /><a href="#translation-isacastillor" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/omersurer"><img src="https://avatars.githubusercontent.com/u/35373108?v=4?s=100" width="100px;" alt=""/><br /><sub><b>omersurer</b></sub></a><br /><a href="#translation-omersurer" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/ihtiht"><img src="https://avatars.githubusercontent.com/u/36369736?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ihtiht</b></sub></a><br /><a href="#translation-ihtiht" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/naofum"><img src="https://avatars.githubusercontent.com/u/8462938?v=4?s=100" width="100px;" alt=""/><br /><sub><b>naofum</b></sub></a><br /><a href="#translation-naofum" title="Translation">🌍</a></td>
    <td align="center"><a href="https://github.com/Fuzeh"><img src="https://avatars.githubusercontent.com/u/34560993?v=4?s=100" width="100px;" alt=""/><br /><sub><b>fuzeh</b></sub></a><br /><a href="#translation-Fuzeh" title="Translation">🌍</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://crowdin.com/profile/Apsimati"><img src="https://avatars.githubusercontent.com/u/8462938?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Apsimati</b></sub></a><br /><a href="#translation-Apsimati" title="Translation">🌍</a></td>
    <td align="center"><a href="http://www.carspending.com/"><img src="https://avatars.githubusercontent.com/u/1397692?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dimitar Dinchev</b></sub></a><br /><a href="https://github.com/rm3l/maoni/commits?author=ddinchev" title="Code">💻</a> <a href="https://github.com/rm3l/maoni/issues?q=author%3Addinchev" title="Bug reports">🐛</a></td>
    <td align="center"><a href="https://github.com/vlad-roid"><img src="https://avatars.githubusercontent.com/u/26101312?v=4?s=100" width="100px;" alt=""/><br /><sub><b>vlad-roid</b></sub></a><br /><a href="https://github.com/rm3l/maoni/commits?author=vlad-roid" title="Code">💻</a> <a href="https://github.com/rm3l/maoni/issues?q=author%3Avlad-roid" title="Bug reports">🐛</a></td>
    <td align="center"><a href="https://github.com/gmiklos-inst"><img src="https://avatars.githubusercontent.com/u/47978769?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Gabriel Miklós</b></sub></a><br /><a href="https://github.com/rm3l/maoni/commits?author=gmiklos-inst" title="Code">💻</a></td>
    <td align="center"><a href="https://sanplot.com"><img src="https://avatars.githubusercontent.com/u/14003063?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dennis Deng</b></sub></a><br /><a href="https://github.com/rm3l/maoni/commits?author=dennisdeng2002" title="Code">💻</a></td>
  </tr>
</table>

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind are welcome!

## Sponsors

Special thanks to [JetBrains](https://www.jetbrains.com/) for supporting this project by providing us with a free license of [IntelliJ IDEA](https://www.jetbrains.com/idea/).

![JetBrains Logo (Main) logo](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)

## License

The MIT License (MIT)
    
    Copyright (c) 2016-2022 Armel Soro
    
    Permission is hereby granted, free of charge, to any person obtaining a copy
    of this software and associated documentation files (the "Software"), to deal
    in the Software without restriction, including without limitation the rights
    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    copies of the Software, and to permit persons to whom the Software is
    furnished to do so, subject to the following conditions:
    
    The above copyright notice and this permission notice shall be included in all
    copies or substantial portions of the Software.
    
    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    SOFTWARE.