Skip Navigation

How to fix issues with the Mirror app

Last updated on 12 Mar 2024
3 min read

This article is about our legacy Mirror app, which is no longer supported

The legacy Mirror app is no longer supported. This means there won’t be bug fixes or improvements, but you can still use it with Sketch. If you choose to keep using legacy Mirror, please note that the app may not work as expected.

This article lists common issues that you may run into, but these may become more common as time passes since Sketch, macOS, and iOS will keep introducing updates while the legacy Mirror app will not.

Why can’t I connect Mirror to the Mac app?

If you’re having issues with your connection, here are a few things to check:

Common solutions

  1. Check that both devices, iOS phone and macOS computer, are connected to the same WiFi network.
  2. Quit both Sketch and Mirror. Then relaunch Sketch first and Mirror second.
  3. Restart your Mac and repeat step 2.
  4. Check that you’re running the latest versions of the Mac app and Mirror. If you updated Sketch or Mirror, quit, relaunch and retry.

Alternatively, you can connect to Mirror through USB; you’ll need a USB cable that matches your device and computer physical ports or an adapter.

If the problem persists

If you can’t connect to Mirror over your WiFi or USB, here are some steps you can take:

  • Make sure that it’s not a local network issue; for example, your device may be connected to a router but without access to the internet. To do so, you can reboot your network devices (routers and/or APs) and your iOS and macOS devices.
  • Ensure your network is not configured to block devices from connecting to each other. This is usually the case with public WiFi.
  • Check that you are running the latest versions of iOS, macOS, the Mac app, and Mirror.
  • If you’re still seeing the same issue after updating your software and devices, see the question below.

After you’ve tried all of the above solutions but still can’t connect, some settings in your network may need some adjustment.

If you’re in an office environment, you may need to ask your network administrator to check the following:

  1. Is Bonjour (sometimes called MDNS or Multi Cast) enabled on your router and Mac?
  2. Is UPnP enabled on your router?
  3. Is TCP Port 58005 allowing a connection between your iOS device and Mac?
  4. Is your Mac blocking or disabling your Websocket connection? Mirror needs this to work.

How can I make sure my firewall allows Mirror traffic?

If you’re using a corporate or campus network, they are usually firewalled, and the required traffic for Mirror is sometimes blocked by default. You may have to ask your network admin to add a rule to allow _sketchmirror._tcp.local traffic in the network.

Can I change the connection port for Mirror?

By default, Mirror connects to a random port each time you open it, but you can change this to a fixed port with the following Terminal command. To set the connection port to port 8080, for example, type the following in Terminal:

defaults write com.bohemiancoding.sketch4.plist mirrorWebPort -int 8080

Why can’t I see any Artboards visible in Mirror when connected via USB?

If you’re having trouble connecting to Mirror via USB, here are some steps you should take:

  • Update to the latest version of Mirror on your iOS device.
  • If, after updating, the Artboards are still not visible in Mirror, you may need to delete the app from your iOS device and install it again.
  • If the problem persists after reinstalling Mirror, a restart of your iOS device can help. Follow these instructions on the Apple Support website. This action won’t delete any information or apps on your device.

Is Mirror available for Android?

There is no official Android version of Mirror, but other people have built apps for Android that work well with our Mac app such as Crystal.

Crystal works very similarly to Mirror: You need to put your Mac and your Android device on the same WiFi network, launch Sketch, launch Crystal and accept the notification in the Mac app to connect to Crystal.

Once you’ve accepted the connection request, you’ll need to select an Artboard for it to display in the Crystal app.