Support

How does LinkLab work?

LinkLab is a macOS menu bar app that uses Apple's xcrun simctl to open deeplinks on the iOS Simulator. You add your app's bundle ID and deeplink URLs, then test them with a single click -- with optional video recording and screenshots.

What are the system requirements?

LinkLab requires macOS 14.0 or later and Xcode installed with at least one iOS Simulator runtime. The app runs from your menu bar and uses minimal system resources.

Does LinkLab send my data anywhere?

No. All deeplink data, recordings, screenshots, and settings stay 100% on your Mac. We only collect anonymous analytics (via Firebase) to improve the app. No deeplink URLs or app data leave your device.

What are the different test modes?

LinkLab offers three test modes: Normal (opens app if needed and triggers deeplink), Cold Start (kills app first then triggers deeplink to test fresh launch), and Warm Start (backgrounds app first then triggers deeplink to test resume behavior).

Can I test deeplinks on multiple simulators?

Yes. Use the Switch dropdown to select which booted simulator to target. LinkLab sends deeplinks to the specific simulator you select, even when multiple simulators are running.

Where are recordings and screenshots saved?

By default, recordings and screenshots are saved to your Desktop in a LinkLab folder organized by app name and date. You can change the output folder in Settings.

How does the subscription work?

LinkLab offers auto-renewable subscription plans (monthly, 6-month, yearly, and 2-year) through the Mac App Store. Subscriptions unlock unlimited deeplinks, unlimited app bundles, smoke testing, and all premium features.

How do I restore my subscription?

Go to Settings in LinkLab and tap "Restore Purchases." Make sure you're signed into the same Apple ID you used for the original purchase.

How do I cancel my subscription?

Open System Settings on your Mac, click your Apple ID, then Subscriptions, and find LinkLab to manage or cancel. You'll retain access until the end of your current billing period.

The simulator won't boot from LinkLab.

LinkLab requires a helper script to boot simulators from within the App Sandbox. Go to Settings and install (or reinstall) the Simulator Boot Script. Make sure Xcode is installed and the command-line tools are configured.

Deeplinks aren't opening in my app.

Make sure the bundle ID in LinkLab matches your app's bundle identifier exactly. Verify that the simulator has your app installed and that your app's URL scheme or universal link configuration is correct.

Video recording isn't working.

Video recording requires a booted simulator. Make sure the target simulator is fully booted (not still loading) before starting a test. Also check that the output folder in Settings is writable.