Integrity Helper Magisk/APatch/KernelSU Module

Universal web-based UI to manage and install integrity-related Magisk modules

📥 Download Latest Release • 📖 Documentation • 🐛 Report Issues

---

✨ Features

• 🌐 Web UI: Lightweight web interface running on localhost:8585
• 📦 Module Management: Download, install, and track status of required modules
• 🔄 Auto-Updates: Always fetches latest releases from official GitHub repositories
• ⚡ Batch Install: "Install All" button for convenient setup
• 📊 Status Tracking: Persistent state of installed module versions
• 🔒 Safety First: Only downloads from official repos with clear disclaimer
• 🔧 Universal Support: Works with Magisk, APatch, and KernelSU automatically

🛠️ Compatibility

Root Solution	Status	Support Level
Magisk	✅ Full	Complete support
APatch	✅ Full	Complete support
KernelSU	✅ Full	Complete support

The module automatically detects your root solution and configures itself accordingly.

📦 Required Modules

This module manages the following integrity-related Magisk modules:

Module	Description	Repository
PlayIntegrityFork	Play Integrity API bypass	osm0sis/PlayIntegrityFork
TrickyStore	Advanced store restrictions bypass	5ec1cff/TrickyStore
PlayStoreSelfUpdateBlocker	Blocks Play Store auto-updates	himanshujjp/PlayStoreSelfUpdateBlocker
yurikey	Yuri Key integrity module	YurikeyDev/yurikey
ZygiskNext	Next-generation Zygisk implementation	Dr-TSNG/ZygiskNext

🚀 Installation

Step 1: Download

Download IntegrityHelper.zip from the latest release

Step 2: Flash

Flash the ZIP via your root manager:

• Magisk Manager → Modules → Install from storage
• APatch → Install → Select ZIP
• KernelSU → Install → Select ZIP

Step 3: Reboot

Reboot your device to activate the module

Step 4: Access UI

The web UI will automatically start on boot. Access it at: http://127.0.0.1:8585

🎯 Quick Access

After installation, use these commands to open the UI:

For Magisk/APatch:

sh /data/adb/modules/IntegrityHelper/open_ui.sh

For KernelSU:

sh /data/adb/ksu/modules/IntegrityHelper/open_ui.sh

📖 Usage

1. Access the Web UI at http://127.0.0.1:8585
2. View Module Status: See all required modules with their current installation status
3. Install Modules: Click "Install" to automatically download and flash modules through your root manager
4. Update Modules: Click "Update" when a newer version is available
5. Reboot Device: May be required for modules to become active
6. Batch Process: Use "Install All" to process all modules at once
7. View Repositories: Click "Open Repo" to view the module's GitHub page

⚠️ Important Workflow:

• Install/Update → Reboot (if required)

UI Features

• 🔄 Real-time Status: Shows installed versions vs latest available
• 📥 One-click Install/Update: Downloads and flashes latest releases automatically
• ⚙️ Smart Installation: Handles permissions and dependencies
• 📊 Progress Tracking: Visual feedback during operations
• 🔍 Repository Links: Direct access to source code
• 🔄 Update Detection: Shows "Update" button only when newer versions are available

🔧 Technical Details

Component	Technology	Details
Backend	Shell Scripts	Busybox utilities with CGI support
Web Server	Busybox httpd	Lightweight CGI-capable server
Frontend	HTML/JS	Bootstrap-styled responsive interface
Communication	AJAX	RESTful API calls to CGI endpoints
Storage	JSON	State saved in /data/adb/IntegrityHelper/state.json
Downloads	Temporary	Files stored in /data/local/tmp/modules/

⚠️ Safety & Disclaimer

⚠️ Use at your own risk! This tool downloads and installs third-party modules.

Important Notes:

• Always backup your data before installing modules
• Review module descriptions and source code before use
• Only install modules you understand and trust
• Installing third-party modules can potentially harm your device
• May violate terms of service for certain apps/services

What this tool does:

• ✅ Downloads from official GitHub repositories only
• ✅ Verifies module integrity during download
• ✅ Automatically flashes modules through your root manager using proper commands:
  • Magisk: magisk --install-module <zip_path>
  • KernelSU: ksud module install <zip_path>
  • APatch: apd module install <zip_path>
• ✅ Provides clear version tracking and status
• ✅ Offers easy access to module repositories

What you need to do:

• � Reboot your device if prompted for changes to take effect

🐛 Troubleshooting

Common Issues

Issue	Solution
UI not loading	Check if module is enabled in your root manager
Download fails	Ensure internet connection and GitHub access
Install fails	Check root manager logs and module compatibility
Permission issues	Ensure proper root access and SELinux status
Port conflicts	Verify no other service uses port 8585

Debug Commands

# Check if service is running
ps | grep httpd

# View service logs
cat /data/adb/IntegrityHelper/service.log

# Test API endpoints
curl http://127.0.0.1:8585/cgi-bin/api_test.sh

# Check module status
ls -la /data/adb/modules/IntegrityHelper/

📁 Module Structure

IntegrityHelper/
├── META-INF/com/google/android/update-binary  # Installer
├── module.prop                                # Module properties
├── service.sh                                 # Boot service
├── open_ui.sh                                 # UI launcher script
├── webroot/                                   # Web interface
│   ├── index.html                            # Main UI
│   ├── script.js                             # Frontend logic
│   ├── manifest.json                         # Module list
│   ├── httpd.conf                            # Server config
│   └── cgi-bin/                              # CGI scripts
│       ├── api_download.sh                   # Download endpoint
│       ├── api_install.sh                    # Install endpoint
│       ├── api_install_all.sh                # Batch install endpoint
│       ├── api_state.sh                      # State endpoint
│       └── api_test.sh                       # Test endpoint
└── scripts/                                   # Backend scripts
    └── httpd.conf                            # Alternative config

📋 Changelog

v1.0 (Current)

• ✨ Initial release with full functionality
• 🌐 Web-based UI for module management
• 📦 Support for 5 essential integrity modules
• 🔄 Automatic latest version detection
• ⚡ Batch install functionality
• 🔒 CORS-enabled API endpoints
• 📊 Persistent state tracking
• 🔧 Universal root solution support (Magisk/APatch/KernelSU)
• 🚀 Proper module flashing using root manager commands (not file copying)
• 🔄 Smart Update buttons that only appear when updates are available
• 📱 Simplified UI workflow - Install/Update/Reboot

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly on your device
5. Submit a pull request

Development Setup

# Clone the repository
git clone https://github.com/himanshujjp/IntegrityHelper.git
cd IntegrityHelper

# Make your changes
# Test on device
# Submit PR

📄 License

This project is released under the MIT License.

Individual managed modules maintain their own licenses. Please refer to each module's repository for license information.

🙏 Acknowledgments

• osm0sis - PlayIntegrityFork
• 5ec1cff - TrickyStore
• YurikeyDev - yurikey
• Dr-TSNG - ZygiskNext
• Magisk/APatch/KernelSU teams - Root solutions

📞 Support

• 📧 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📖 Documentation: This README

---

Made with ❤️ by himanshujjp

⭐ Star this repo if you found it useful!