Docs · 05
Voice & calls
The twin speaks as you. Set up a voice once, then it can read things aloud, leave voice notes, and hold real phone calls, book the table, chase the package, negotiate a bill, all in a clone of your voice. This page covers every voice option and how calls work.
01Your voice options
Twinly's Voice tab offers four ways to give the twin a voice, in a simple grid. The first two are free and fully on your Mac; the last two are optional paid cloud voices for top-tier quality.
| Option | Where it runs | Quality | Best for |
|---|---|---|---|
| Twinly Voice (our clone) | On-device | Natural, has a ceiling | A free clone of your own voice |
| Cartesia (bring key) | Cloud, paid | Top-tier | The best-sounding calls |
| ElevenLabs (bring key) | Cloud, paid | Top-tier | The best-sounding calls |
02The Twinly Voice clone (our own, on-device)
Twinly can build its own clone of your voice, entirely on your Mac, from a short set of recordings. In the Voice tab you read a curated set of prompts once; every clip is saved with its text, which makes them a proper training set rather than loose samples. Twinly then builds a voice clone from them.
Recording the prompts once benefits every voice path: the Twinly clone uses them, and the paid providers below stitch them into their reference audio. Record once, choose any voice.
03Top-tier voice: Cartesia or ElevenLabs (optional)
For the best-sounding voice, bring a key from Cartesia or ElevenLabs, two paid cloud voice services with instant cloning. In the Voice tab, paste your key into the provider's card, click clone once, and it builds the voice from your recorded prompts.
- Renders are cached on your device, so repeating a line costs nothing.
- If something goes wrong (out of credits, bad key, rate limited), Twinly shows one calm sentence, never a wall of error text.
- Keys live in your OS keychain (the macOS Keychain, or Windows Credential Manager on a PC), written by the app.
04BlackHole: the audio bridge for calls
To make a phone call, the twin's spoken voice has to reach the call as if it were your microphone. macOS does not let one app feed another's mic directly, so Twinly uses a small, free, open-source audio driver called BlackHole. Twinly plays your cloned voice into BlackHole, and the calling app uses BlackHole as its microphone. The far party hears your voice; nothing leaves your Mac, no cloud, no speaker-to-mic loop.
Install it
- Download the free BlackHole 2ch installer from existential.audio/blackhole and run it like any Mac app.
- Confirm it installed: open Audio MIDI Setup (Applications ▸ Utilities) and look for a device named BlackHole 2ch. If it is not there, restart your Mac once, the driver loads at startup.
Wire the call path
- Set the calling app's microphone to BlackHole. For Google Voice in Chrome: open
voice.google.com, click the site-settings icon in the address bar, and set Microphone to BlackHole 2ch. - Keep your system output on your normal speakers (System Settings ▸ Sound ▸ Output). That is what Twinly listens to for the other side of the call, and how you can hear your own twin.
05How a phone call works
Once your voice is set and BlackHole is wired, just ask: "call the restaurant and book a table for two at 8". The twin finds the number, places the call through your phone line, and holds the conversation grounded in your goal, with a standing rule to never invent details and to offer to call back when it does not know something.
You watch it live in the Phone tab and on the island: the transcript scrolls, and you can mute or end the call at any moment. The twin works through your own number, so the business sees your real line calling, not a robot.
06Coming soon: answering incoming calls
Today the twin places outbound calls in your voice. Answering incoming calls, recognizing you when you phone your own Mac, and screening unknown numbers, is in active development and not available in this release yet.
07A note on the first call
The Twinly Voice engine loads its model on first use, so the very first thing it says after a fresh app launch can take a moment. Twinly hides this by warming the voice at launch and the instant a call becomes likely, so in practice calls start speaking immediately. If you want a flawless first call, just open Twinly a minute beforehand.