Thanks for using Woodpecker!

Woodpecker Supports both physical device and simulator iOS9.0+, Objective-C and Swift.

To use Woodpecker, you need import a framework to your project, then it will start and connect to Woodpecker client automatically. If you are work with physical device, please ensure your app and Woodpecker are in the same network.

If you’re developing a Mac app, please check Woodpecker for MacOS

1. CocoaPods:

pod 'WoodPeckeriOS', :configurations => ['Debug']

Use pod update WoodPeckeriOS to update the latest version.

2. Carthage:

binary "https://raw.githubusercontent.com/appwoodpecker/woodpecker-ios/master/WoodPeckeriOS-Carthage.json"


3. Manual Setup:

  1. Download WoodPeckeriOS.xcframework
  2. Import WoodPeckeriOS.xcframework to your project.
  3. If you like to use only in Debug configuration, please check this


4. Jailbreak Setup:

  1. TSCydia , select the TSWoodPeckeriOSLoader, it supports iOS 12.0+. Created by manajay
  2. TinXie’s Repository , Created by TinXie


If you have the following problems:

Didn’t work with iOS 14 devices


iOS 14 add a new privacy about local network usage, please ensure your app has the permission, and if you build with the Xcode 12+, please add these two items in Info.plist:

  1. Add description in Privacy - Local Network Usage Description
  2. Add _adhp._tcp in Bonjour services list

In practice, we don’t need to remove these keys when build for AppStore, because the privacy alert won’t appear until we call any local network api, such as bonjour service or multicast


dyld: Library not loaded: @rpath/WoodPeckeriOS.framework/WoodPeckeriOS Reason: image not found


Please drag WoodPeckeriOS.xcframework to Build Phases -> Embed Framworks, then select Embed & Sign.


Mac client is always “waiting connect”

  1. please ensure mac and app are in the same wifi.
  2. please ensure WoodPeckeriOS.xcframework was the latest version.
  3. connect to mac client manually, long press your iOS app’s screen with two fingers, you’ll see the connection page, try search and connect to your mac client.
  4. If it still doesn’t work, click here.


I often connect to other’s mac.

You could make some options to specify which client you’d like to connect, see advanced usage.


You can start with demo app or talk with others at telegram group