Thanks for using Woodpecker!

Woodpecker Supports both physical device and simulator iOS8.0+, MacOS10.11+, Objective-C and Swift.

To use Woodpecker, you need import WoodpeckerMacOS.framework to your project, WoodpeckerMacOS.framework will automatically launch and connect to Woodpecker client. Please ensure your app and Woodpecker are in the same network.

1. CocoaPods:

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

Use pod update WoodpeckerMacOS to update the latest version.

2. Carthage:

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


3. Manual Setup:

  1. Download WoodpeckerMacOS.framework
  2. Import WoodpeckerMacOS.framework to your project.


If you have the following problems:

dnssd_clientstub ConnectToServer: connect()-> No of tries: 1 dnssd_clientstub ConnectToServer: connect() failed path:/var/run/mDNSResponder Socket:3 Err:-1 Errno:1 Operation not permitted


Please open the network capability as the image shows, If your app is not sandboxed, just disable it later, and don’t forget to disable the capabilities before send to AppStore



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


Please drag WoodpeckerMacOS.framework to Build Phases -> Embed Framworks.


Mac client is always “waiting connect”

  1. please ensure your app and Woodpecker are in the same wifi.
  2. please ensure WoodpeckerMacOS.framework was the latest version.
  3. connect to Woodpecker client manually, Press the Ctrl and Command key, then double click your mac app’s view, you’ll see the connection page, try search and connect to your Woodpecker 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 slack