README

2025-05-22 20:27:16 +07:00
1 changed files with 91 additions and 2 deletions
--- a/README.md
+++ b/README.md
@@ -1,3 +1,92 @@
-# IPA-Tool---Signer
+# IPA Tool & Signer

-Sửa file IPA/App: đổi tên Bundle, đổi version, xóa file/thư mục dư thừa và hỗ trợ tạo Assets.car nhanh hỗ trợ signer ipa 
+A modern macOS application for modifying and signing iOS IPA files, creating Assets.car from PNG images, and managing provisioning profiles. Built with PyQt6, it offers a sleek interface with Light/Dark mode support and a user-friendly drag-and-drop experience.
+
+## Features
+- **IPA/App Modification**:
+  - Update Minimum iOS Version.
+  - Change Bundle Name and Identifier.
+  - Remove unwanted files/folders (e.g., SC_Info, PlugIns, .dylib) with customizable settings.
+- **Assets.car Creation**:
+  - Generate Assets.car and iOS-compliant icons from a single PNG image.
+  - Supports multiple icon sizes for iPhone and iPad.
+- **IPA Signing**:
+  - Re-sign IPA files with custom certificates and provisioning profiles.
+  - Update App ID, Display Name, Version, and Short Version.
+  - Option for re-signing only without modifying other metadata.
+- **User Interface**:
+  - Drag-and-drop support for .ipa, .app, .png, and .mobileprovision files.
+  - Light/Dark theme with smooth transitions.
+  - Detailed logs with color-coded status (DEBUG, WARNING, ERROR).
+  - Copy logs to clipboard for easy sharing.
+- **Provisioning Profile Management**:
+  - Automatically extract Application ID from .mobileprovision files.
+  - Embed provisioning profiles during signing.
+- **Settings**:
+  - Customize file/folder deletion rules with recursive options.
+  - Theme selection (Light/Dark) with instant preview.
+
+## Screenshots
+Explore the app's interface and features through the screenshots below:
+
+| Main Interface | IPA Signing | Assets Creation | Settings | Info Tab |
+|----------------|-------------|-----------------|----------|----------|
+| ![Main Interface](img/main.png) | ![IPA Signing](img/Signer.png) | ![Assets Creation](img/assets.png) | ![Settings](img/setting.png) | ![Info Tab](img/info.png) |
+
+**Additional Screenshots**:
+
+| *Light Theme* | 
+|---------------|
+| ![Light Theme](img/info1.png) |
+
+| *Dark Theme*  | 
+|---------------|
+| ![Dark Theme](img/info.png) |
+
+| *Log Output*  | 
+|---------------|
+| ![Log Output](img/log.png) |
+
+## Installation
+1. Download the `.dmg` file from the [Releases](https://ctdogit.ctdotech.site/dothanh1110/IPA-Tool---Signer/releases) page.
+2. Open the `.dmg` file and drag `IPATool.app` to your Applications folder.
+3. Launch `IPATool.app` from Applications.
+
+## Usage
+1. **Modify IPA/App**:
+   - Drag an `.ipa` or `.app` file into the "IPA & Assets Tool" tab.
+   - Specify Minimum iOS Version or Bundle Name (optional).
+   - Choose an output directory and click "Sửa IPA/App".
+2. **Create Assets.car**:
+   - Drag a `.png` image into the "IPA & Assets Tool" tab.
+   - Select an output directory and click "Tạo Assets.car".
+3. **Sign IPA**:
+   - Go to the "Signer IPA" tab.
+   - Drag an `.ipa` file and a `.mobileprovision` file.
+   - Select a signing certificate from the dropdown.
+   - Optionally update App ID, Display Name, Version, or Short Version.
+   - Check "Re-Sign Only" if no metadata changes are needed.
+   - Choose an output path and click "Start Signing".
+4. **Settings**:
+   - Customize file deletion rules in the "Settings" tab.
+   - Switch between Light and Dark themes (requires app restart).
+
+## System Requirements
+- **OS**: macOS 10.15 (Catalina) or later
+- **Dependencies**:
+  - Xcode Command Line Tools (for `xcrun` and `actool`).
+  - Valid code-signing certificates in Keychain (for signing).
+- **Disk Space**: ~100 MB
+
+## Notes
+- Ensure Xcode Command Line Tools are installed (`xcode-select --install`) for Assets.car creation.
+- Signing requires a valid Apple Developer certificate and provisioning profile.
+- Use this tool for educational or personal purposes only, in compliance with Apple’s policies.
+
+## Credits
+- **Developer**: Đỗ Thành
+- **Website**: [ctdo.net](https://ctdo.net)
+- **Contact**: [Telegram](https://t.me/dothanh1110) | [GitHub](https://github.com/thanhdo1110)
+
+## License
+© ctdoteam - All rights reserved. This tool is for educational and personal use only.