Kaynağa Gözat

Add initial README for iOS Activation Tool Suite

This README provides an overview of the iOS Activation Tool Suite, including architecture, prerequisites, and quick start instructions.
rhcp011235 2 ay önce
ebeveyn
işleme
536d5a732f
1 değiştirilmiş dosya ile 75 ekleme ve 0 silme
  1. 75 0
      README.md

+ 75 - 0
README.md

@@ -0,0 +1,75 @@
+iOS Activation Tool Suite
+
+A complete, end-to-end solution for iOS device activation management. This repository contains both the client-side automation logic and the server-side infrastructure required to handle device activation payloads.
+
+Architecture Overview
+
+The suite is divided into two core components:
+
+Client Automation (client/): A Python-based utility that interacts directly with connected iOS devices via USB. It handles lifecycle management (reboots), system log analysis, and filesystem operations (AFC).
+
+Server Backend (server/): A PHP application that dynamically generates device-specific activation payloads. It serves as the central authority for handling device requests and delivering the necessary configuration databases.
+
+Repository Structure
+
+.
+├── client/                 # Python client application
+│   ├── activator.py        # Main automation entry point
+│   └── README.md           # Client-specific documentation
+├── server/                 # PHP backend infrastructure
+│   ├── public/             # Web root
+│   ├── templates/          # SQL templates for payload generation
+│   ├── assets/             # Device configuration storage
+│   └── SETUP.md            # Server deployment guide
+└── package_builder.sh      # Deployment automation utility
+
+
+Prerequisites
+
+Client-Side (macOS)
+
+Python 3.6+
+
+libimobiledevice (via Homebrew)
+
+pymobiledevice3 (via pip)
+
+curl
+
+Server-Side
+
+PHP 7.4 or newer
+
+SQLite3 extension enabled
+
+Write permissions for cache directories
+
+Quick Start
+
+1. Build Release Package
+
+Use the included builder utility to generate a deployable package. This handles asset extraction and directory setup automatically.
+
+chmod +x package_builder.sh
+./package_builder.sh
+
+
+This will generate release_package.tar.gz.
+
+2. Server Deployment
+
+Deploy the contents of the server directory from the release package to your web host. Ensure the public folder is set as the document root.
+
+See server/SETUP.md for detailed configuration steps.
+
+3. Client Configuration
+
+Update the activator.py script to point to your deployed server URL before running.
+
+# Run the client tool
+sudo python3 client/activator.py
+
+
+Disclaimer
+
+This tool is provided for educational and research purposes only. The authors are not responsible for any misuse of this software or damage to devices. Ensure you have authorization before performing operations on any device.