Skip to content

README.md

Latest commit

 

History

History
253 lines (188 loc) · 9.29 KB

README.md

File metadata and controls

253 lines (188 loc) · 9.29 KB

Integrity Helper Magisk/APatch/KernelSU Module

Integrity Helper Version Compatibility

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

Made with ❤️ by himanshujjp

⭐ Star this repo if you found it useful!