Docs · 08
Voice & calls
Twinly speaks in a clone of your own voice, built and run entirely on your Mac. Set it up once and the twin can leave voice notes, read things aloud, and hold real phone calls: book the table, chase the package, argue a refund.
01Twinly Voice: your own voice, on your Mac
Twinly Voice is the one voice Twinly speaks in: your own, cloned on your Mac, and nothing about it leaves the device. It needs a Mac with Apple silicon (M1 or newer); on an Intel Mac the Voice screen says so. Everything happens on the Voice screen, no terminal:
- Install the voice engine. A one-time download; the card shows its progress, and you can keep using the app.
- Record your clips. Read each prompt in the tone it names. Eight clips is the minimum; the full set is what makes it sound most like you. Record in a quiet room at your normal pace.
- Click Build my clone.
- Type a line and click Say it to hear it. A Pace control sets how fast it talks.
If the voice mispronounces your name, type how it should sound (“Oh-jus-vah”). That corrects the speech everywhere the twin talks, without changing your recordings.
02Before your twin can call
Calls go out through Google Voice in Google Chrome, from your own number. The Voice screen walks you through two one-time steps under Before your twin can call:
- Install BlackHole, a free audio driver (an Install button is right there). It carries your twin's cloned voice into the call, so the other side actually hears it. If it does not show up after installing, restart your Mac once.
- Sign in to Google Voice in Chrome at
voice.google.comand turn on calling. Your twin dials from Chrome, so that is where you need to be signed in.
Before every call, Twinly sets Google Voice's microphone to BlackHole for you, so there is nothing to change in Chrome's settings. Chrome also needs View ▸ Developer ▸ Allow JavaScript from Apple Events turned on once; Twinly's setup shows you where.
BlackHole is used only during calls. On Windows the audio bridge is VB-Cable, wired the same way.
03How a call goes
Just ask: “call the restaurant and book a table for two at 8”. The twin finds the number, places the call from your Google Voice line, and works toward your goal:
- It waits for them to pick up before it says hello.
- It speaks in whole sentences, without “um”s or trailing off, spells out an email address, and says something again when asked.
- It knows your name, email and phone, and makes your case in its own words when they ask why.
- It never invents facts. When it needs something it does not know, it says “one second, let me check” and asks you in the island.
- It hangs up after goodbye, and the task tells you what was said and how the call ended.
Watch it in the island while it talks: mute your twin or end the call at any moment. Calls show in Recents, each with how it ended. Whether a call waits for your OK before it dials follows your approval mode.
04Not yet: answering incoming calls
Today the twin places outbound calls. Answering incoming calls and screening unknown numbers is not available in this release.
05A note on the first call
Twinly starts the voice engine at launch and again the moment a call becomes likely, so calls start speaking right away. Right after a fresh launch the very first line can take a moment; open Twinly a minute before an important call.