# MAA Meow π±
**Run [MAA](https://github.com/MaaAssistantArknights/MaaAssistantArknights) natively on Android**
One-click automation for all daily tasks, powered by image recognition
[](https://github.com/Aliothmoon/MAA-Meow/releases/latest)
[](LICENSE)
[](https://github.com/Aliothmoon/MAA-Meow/stargazers)
[](https://github.com/Aliothmoon/MAA-Meow/releases)
[Download](https://github.com/Aliothmoon/MAA-Meow/releases/latest) Β· [Issues](https://github.com/Aliothmoon/MAA-Meow/issues) Β· [QQ Group](https://qm.qq.com/q/j4CFbeDQXu)
**English** | **[δΈζ](README.md)**
---
> No root required. Run Arknights in the background! Still in development β expect instability. Feedback is welcome!
## Features
| | Feature | Description |
|---|---|---|
| π§ | **Native MAA Core** | Run automation logic directly on Android β no PC or emulator needed |
| πͺ | **Dual Mode** | Foreground floating panel / Background virtual display (headless) |
| π¦ | **Full Task Support** | Sanity battles, recruitment, infrastructure, copilot, roguelike, and more |
| β±οΈ | **Scheduled Tasks** | Auto-start tasks at preset times β perfect for daily routines |
| π | **Auto Update** | Automatically check and download app & resource updates on launch |
## Requirements
| Item | Requirement |
|---|---|
| OS | Android 9+ (API 28) |
| Permissions | [Shizuku](https://shizuku.rikka.app/) running & authorized, or rooted device |
| Architecture | arm64-v8a or x86_64 |
## Documentation
| Document | Description |
|---|---|
| [Build Guide](docs/BUILDING.md) | Build APK from source |
| [Roadmap](docs/ROADMAP.md) | Feature plans & progress |
| [Third-Party Notices](docs/THIRD_PARTY_NOTICES.md) | Open-source components & licenses |
## Contributing
Pull requests are welcome! Whether it's a bug fix, UX improvement, or a new feature β we appreciate every contribution.
1. Fork this repository
2. Create your branch (`git checkout -b feat/your-feature`)
3. Commit your changes (`git commit -m 'feat: add some feature'`)
4. Push to remote (`git push origin feat/your-feature`)
5. Open a Pull Request
> Please follow the [Conventional Commits](https://www.conventionalcommits.org/) specification (`feat:`, `fix:`, `docs:`, etc.).
> See the [Build Guide](docs/BUILDING.md) for first-time setup.
If you find this project useful, consider giving it a Star β to help others discover it!
## Acknowledgements
- [MaaAssistantArknights](https://github.com/MaaAssistantArknights/MaaAssistantArknights) β Arknights assistant based on image recognition
- [Genymobile/scrcpy](https://github.com/Genymobile/scrcpy) β Display and control your Android device.
- [Shizuku](https://github.com/RikkaApps/Shizuku) β Using system APIs directly with adb/root privileges from normal apps through a Java process started with app_process.
## License
This project is licensed under [AGPL-3.0](LICENSE). Third-party code retains its original license β see [Third-Party Notices](docs/THIRD_PARTY_NOTICES.md).