# Install ipapatch with Homebrew

CLI tool to patch iOS IPA files and their plugins. Version 2.1.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:ipapatch
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ipapatch
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:ipapatch
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ipapatch>
- **Version:** 2.1.3
- **Source summary:** CLI tool to patch iOS IPA files and their plugins
- **Homepage:** <https://github.com/asdfzxcvbn/ipapatch>
- **Repository:** <https://github.com/asdfzxcvbn/ipapatch>
- **Upstream docs:** <https://github.com/asdfzxcvbn/ipapatch#readme>
- **License:** MIT
- **Source archive:** <https://github.com/asdfzxcvbn/ipapatch/archive/refs/tags/v2.1.3.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- ipapatch (cli)
- ipapatch (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.1.3
- Local data: ok
- Upstream repository: https://github.com/asdfzxcvbn/ipapatch
- Upstream latest detected: v2.1.3 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

ipapatch is a Go CLI for modifying iOS IPA packages and their plugin payloads. Its niche is the iOS sideloading and app-modification workflow, where users need a portable binary that can patch app bundles without driving Xcode.

### Project history

The README presents ipapatch as a tool for fixing IPA plugin-related problems in share sheets, widgets, VPNs, and similar extension contexts. It uses zxPluginsInject by default and credits Chocolate Fluffy's original IPA patcher tweak plus blacktop's ipsw and go-macho work for making native load-command injection possible.

The release stream began in May 2025 with v1.0.0. Early releases skipped watch apps, added a `--plugins-only` flag, removed an oversized archive dependency, and tightened how modified binaries and output IPAs were handled.

### Adoption history

The project has modest but visible adoption through GitHub stars and a Homebrew formula. Its packaging matters because the target workflow is highly CLI-oriented: downloading a release binary or installing through Homebrew is simpler than building a Go toolchain on every device or CI host.

The README emphasizes cross-platform goals across macOS, Linux, and iOS, with Windows described as less proven. That portability is part of the appeal for IPA patching workflows that span desktop hosts and jailbroken or development devices.

### How it is used

ipapatch is used after an IPA has already been obtained: the user runs the CLI against the package to inject or adjust plugin-related Mach-O load commands and then passes the output into signing or installation tooling.

Release notes show practical polish around output compatibility, such as v2.1.0's fix for IPAs that some signing apps and tools could not extract and v2.1.3's fix for signing unusual binaries.

### Why package nerds care

Package nerds care about ipapatch because it turns a fragile iOS app-modification workflow into a distributable command-line package. It is small, specialized, and sits at the intersection of archive formats, Mach-O editing, app extensions, and code-signing expectations.

The project also shows the value of dependency diet in CLI packaging: v2.0.0 removed the external `zip` dependency so releases could behave more like self-contained native binaries.

### Timeline

- 2025-05-11: v1.0.0 marked the first public release.
- 2025-05-17: v1.1.0 reduced executable and output IPA sizes by replacing a broad archive dependency with zip-specific handling.
- 2025-05-17: v1.1.1 added the `--plugins-only` flag.
- 2025-07: v2.0.0 removed the external `zip` command dependency.
- 2025-08-12: v2.1.2 updated the bundled zxPluginsInject dependency to v1.0.1.
- 2025-08-31: v2.1.3 fixed signing for unusual binaries.

### Related projects

- Related projects named by the upstream README include zxPluginsInject, Chocolate Fluffy's original patch, blacktop's ipsw, and go-macho.
- It belongs near other IPA tooling such as app duplication, sideload signing, and Mach-O patching utilities, but its own scope is plugin and extension patching rather than App Store download or signing.

### Sources

- <https://formulae.brew.sh/formula/ipapatch>
- <https://github.com/asdfzxcvbn/ipapatch>
- <https://github.com/asdfzxcvbn/ipapatch/releases>
- <https://github.com/asdfzxcvbn/zxPluginsInject/releases/tag/v1.0.1>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ipapatch
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [ipatool](https://www.automicvault.com/pkg/brew/ipatool/) - Shares av.db curated category or tags: cli, developer-tools, ios, ipa, mobile-development.
- [ios-deploy](https://www.automicvault.com/pkg/brew/ios-deploy/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development.
- [ios-sim](https://www.automicvault.com/pkg/brew/ios-sim/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development.
- [react-native-cli](https://www.automicvault.com/pkg/brew/react-native-cli/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development.
- [rswift](https://www.automicvault.com/pkg/brew/rswift/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development.
- [cyan](https://www.automicvault.com/pkg/brew/cyan/) - Shares av.db curated category or tags: cli, developer-tools, ios, ipa.
- [kdoctor](https://www.automicvault.com/pkg/brew/kdoctor/) - Shares av.db curated category or tags: cli, developer-tools, mobile-development.
- [skip](https://www.automicvault.com/pkg/brew/skip/) - Shares av.db curated category or tags: cli, developer-tools, mobile-development.

## Combined YAML source

View the package source record on GitHub. [combined/ipapatch.yml](https://github.com/automic-vault/db/blob/main/combined/ipapatch.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
