Troubleshooting

A permission shows as off (or on but not working) after I granted it

macOS sometimes needs a permission re-toggled, most often right after an app update, which is normal Mac behavior for any app. Open System Settings ▸ Privacy & Security, find the permission, turn Twinly off and back on, and reopen the app if it asks. The fastest reset for everything at once is Set everything up in Twinly's Access tab.

My voice clone sounds robotic

Re-record your voice prompts in a quiet room at your normal pace, then rebuild the clone in the Voice tab. The on-device Twinly Voice has a quality ceiling, for the most natural sound, use Apple Personal Voice or bring a paid Cartesia or ElevenLabs key, which re-clones from the same recordings. For Personal Voice itself, re-create the voice in System Settings ▸ Accessibility ▸ Personal Voice. Full detail: Voice & calls.

A website task fails or the twin says it cannot click something

Two common causes. First, the page needs you signed in or is behind a paywall, sign in first, then ask again. Second, the target is a graphics canvas with nothing to click, a CAD or 3D viewport, a drawing canvas, or a map with no labels. Twinly finds things by their on-screen name or text, so a text-free WebGL or canvas surface cannot be automated; it reports this honestly rather than guessing a pixel. More on why in How Twinly executes.

My phone call has no audio on one side

This is almost always the BlackHole audio bridge. The call app's microphone must be set to BlackHole 2ch (in Chrome on voice.google.com, set the site microphone), and your system output must stay on your real speakers, not BlackHole. If BlackHole is not installed, get it from existential.audio/blackhole. Also confirm Screen Recording is granted, that is how the twin hears the other side. Full wiring: Voice & calls.

Gmail will not connect

You need a 16-character App Password, not your normal Google password, and 2-Step Verification must be on (app passwords do not exist without it). Create one at myaccount.google.com/apppasswords and paste it into Settings ▸ Gmail. Some Workspace or Advanced Protection accounts disable app passwords by policy. While Gmail is unavailable the twin falls back to Apple Mail. Setup: Email (Gmail).

macOS shows a password prompt saying Twinly wants to use the keychain

A key was added outside the app (with the security command-line tool), so macOS treats it as not belonging to Twinly and prompts every time. Open Keychain Access, delete the Twinly item, then re-enter the key inside the app's Settings. Keys the app saves itself never prompt.

The first phone call after launch is slow to speak

Apple's Personal Voice model loads on first use and a cold load takes a moment. Twinly pre-warms it at launch and when a call becomes likely, so this is rarely noticeable, but the very first call right after opening the app can pay a small one-time delay. Open Twinly a minute before an important call and it disappears.

The twin cannot drive Mail or Messages

An Automation prompt was declined once, and macOS never re-asks on its own. Open System Settings ▸ Privacy & Security ▸ Automation, expand Twinly, and turn on the app it needs to control. Then try the task again.

Computer use stops working with errors about no window

Your screen is locked or the display went to sleep. macOS blocks screen access and clicking on a locked Mac, with misleading errors. Unlock it and keep the display awake while the twin works.

The island disappeared from the top of my screen

It was hidden from its own right-click menu. Press Command + \ to summon it, or click the Twinly icon in the menu bar and choose Message your twin. Right-click the island for the Hide and Quiet suggestions options.

Open the Showcase tab's readiness panel; its live checks catch the common misconfigurations with a fix-it hint for each. If it is something new, email founders@twinly.tech with what you tried, we answer.