nab138 / iloader

iloader: Install SideStore (or other apps) and import your pairing file with ease. iloader：轻松安装 SideStore（或其他应用）并导入您的配对文件。

This repository and iloader.app are the only official ways to download iloader. There is also an unofficial Homebrew cask, an unofficial AUR package, and an unofficial Fedora COPR repository maintained by the community. Do not download from any other sources or websites. 本仓库和 iloader.app 是下载 iloader 的唯一官方渠道。此外，社区还维护有非官方的 Homebrew cask、AUR 软件包和 Fedora COPR 仓库。请勿从任何其他来源或网站下载。

How to use

如何使用

Install usbmuxd for your platform: 为您的平台安装 usbmuxd：

Windows: iTunes
macOS: Included (已内置)
Linux: Potentially included, if not, install via your package manager (可能已内置，若无，请通过包管理器安装)

Install the latest version for your platform from the releases. 从发布页面下载并安装适用于您平台的最新版本。

NixOS: Use the flake github:nab138/iloader
NixOS: 使用 flake github:nab138/iloader

Plug in your iDevice to your computer
将您的 iDevice 连接到电脑
Open the app
打开应用
Sign into your Apple ID
登录您的 Apple ID
Select your action (e.g. install SideStore)
选择您的操作（例如：安装 SideStore）

Features

功能特性

Install SideStore (or LiveContainer + SideStore), import certificate and place rppairing+lockdown pairing files automatically
安装 SideStore（或 LiveContainer + SideStore），自动导入证书并放置 rppairing+lockdown 配对文件
Import any IPA
导入任意 IPA 文件
Intelligent error suggestions to help resolve common issues
智能错误建议，帮助解决常见问题
Manage pairing files in apps like StikDebug, SideStore, Protokolle, etc
管理 StikDebug、SideStore、Protokolle 等应用中的配对文件
See and revoke development certificates & app ids
查看并撤销开发证书和应用 ID

Troubleshooting

故障排除

If you are unable to solve an issue on your own, copy the full error message and ask on the idevice Discord server or open an issue. You can view app logs with the “View Logs.” If nothing is showing up, change the log level to “Debug.” If those logs aren’t helpful, logs with additional are stored in the following locations: 如果您无法自行解决问题，请复制完整的错误信息，并在 idevice Discord 服务器上提问或提交 Issue。您可以通过“View Logs”查看应用日志。如果没有任何显示，请将日志级别更改为“Debug”。如果这些日志仍无帮助，包含更多信息的日志存储在以下位置：

Windows: %APPDATA%\me.nabdev.iloader\logs
macOS: ~/Library/Application Support/me.nabdev.iloader/logs
Linux: ~/.local/share/me.nabdev.iloader/logs/

Translating

翻译

iloader needs localization! If you speak another language and notice iloader does not support it or has mistakes, please consider contributing. To update/edit an existing language, make a PR modifying src/locales/<lang>.json. To add a new language, add your language to src/i18next.ts, and in src/locales copy en.json to a new file titled <langcode>.json and update the strings. iloader 需要本地化！如果您会其他语言并发现 iloader 不支持或存在错误，请考虑贡献。要更新/编辑现有语言，请提交 PR 修改 src/locales/<lang>.json。要添加新语言，请将您的语言添加到 src/i18next.ts 中，并在 src/locales 目录下将 en.json 复制为名为 <langcode>.json 的新文件并更新字符串。

i18next.ts:

const languages = [
  ["en", "English"],
  ["es", "Español"],
  // Your language here...
] as const;

You can also add your name to the translators section of the README. Thank you for translating! 您也可以将您的名字添加到 README 的翻译人员部分。感谢您的翻译！

Building from source

从源码构建

Install bun (or Node.js) and Rust
安装 bun（或 Node.js）和 Rust
Clone the repository and cd into it
克隆仓库并进入目录
Run bun i (or npm i)
运行 bun i（或 npm i）
For development with hot reload: bun tauri dev (or npm run tauri dev)
开发模式（带热重载）：bun tauri dev（或 npm run tauri dev）
Make a production build: bun tauri build (or npm run tauri build)
构建生产版本：bun tauri build（或 npm run tauri build）

Credits

致谢

Icon: made by Transistor
图标： 由 Transistor 制作
UI improved by: StephenDev0
UI 改进： StephenDev0
idevice: by jkcoxson for communicating with iOS devices
idevice： 由 jkcoxson 开发，用于与 iOS 设备通信
isideload: for installing apps
isideload： 用于安装应用
idevice by jkcoxson crate: is used to communicate with the device
idevice (jkcoxson crate)： 用于与设备通信
apple-codesign-quick: by Dadoum for codesigning and entitlements
apple-codesign-quick： 由 Dadoum 开发，用于代码签名和授权
Impactor: by claration was used as a reference for cryptography operations (converting certs to p12, etc.)
Impactor： 由 claration 开发，作为加密操作（将证书转换为 p12 等）的参考
Sideloader: by Dadoum was used as a reference for how apple private developer endpoints work
Sideloader： 由 Dadoum 开发，作为苹果私有开发者端点工作原理的参考
idevice_pair: was used as a reference for pairing file management
idevice_pair： 作为配对文件管理的参考
App made with: tauri
应用基于： tauri 构建

Translators

翻译人员

Thank you to everyone who has contributed translations! See the Translating section if you would like to contribute as well. 感谢所有贡献翻译的人员！如果您也想贡献，请参阅“翻译”部分。 (List of contributors omitted for brevity)

License

许可证

Branding, logos, media assets, and the name “iloader” are not licensed under the MIT License and are subject to separate restrictions. You may retain or use branding materials in forks, tutorials, or documentation if you include a clear link to either the official site (https://iloader.app) or the iloader source code repository (https://github.com/nab138/iloader) and do not imply official endorsement. See LICENSE-BRANDING for full details. 品牌、Logo、媒体资产和“iloader”名称不属于 MIT 许可证范畴，并受单独限制。如果您在分支、教程或文档中保留或使用品牌材料，必须包含指向官方网站 (https://iloader.app) 或 iloader 源代码仓库 (https://github.com/nab138/iloader) 的清晰链接，且不得暗示官方背书。详情请参阅 LICENSE-BRANDING。

Future Plans

未来计划

Checks for if device is in developer mode, has password set, etc
检查设备是否处于开发者模式、是否设置了密码等
Automatic anisette fallback
自动 anisette 后备方案
Team selection when an account has multiple teams
当账户拥有多个团队时进行团队选择
Auto-refresh installed apps
自动刷新已安装应用
Minimize to tray
最小化到托盘
Detect installed apps
检测已安装应用
Refresh apps automatically
自动刷新应用
Set a “default” account to automatically log into
设置“默认”账户以自动登录
Import SideStore account info automatically
自动导入 SideStore 账户信息
Mount DDI and open sidestore after installation
安装后挂载 DDI 并打开 SideStore