TalkieServer Setup — Talkie Docs

TalkieServer is a lightweight local service that enables communication between your Mac and iPhone. It runs on your Mac and handles secure pairing and data sync.

This page is a preview — details may change as development continues.

Interested in this feature? Leave your email and we'll reach out when it's ready.

What is TalkieServer?

TalkieServer is a TypeScript service that runs locally on your Mac. It acts as a bridge between the Talkie Mac app and the Talkie iPhone app, enabling:

Device Pairing — Securely connect your iPhone to your Mac
Voice Sync — Transfer voice recordings from iPhone to Mac
Local Processing — All data stays on your network, never touches external servers

Prerequisites

Bun Runtime

Bun is a fast JavaScript runtime that TalkieServer uses. It's similar to Node.js but significantly faster.

Install Bun

Talkie will prompt you to install Bun if it's not detected. You can also install it manually:curl -fsSL https://bun.sh/install | bash

What Gets Installed

When you enable iPhone connectivity, Talkie installs the following packages locally:

Package	Purpose
elysia	Fast HTTP server framework
@elysiajs/cors	Cross-origin request handling
tweetnacl	Cryptographic operations for secure pairing

All packages are installed locally in the TalkieServer directory within the app. They don't affect your system or other projects.

Installation Steps

Open Talkie Settings

Click the Talkie menu bar icon and select Settings, or press ⌘,

Navigate to iPhone Sync

Select the "iPhone" tab in the settings sidebar.

Enable TalkieServer

Click "Enable iPhone Sync". Talkie will check for prerequisites and prompt you to install any missing dependencies.

If Bun is not installed, you'll be prompted to install it first. This requires an internet connection.

Install Dependencies

When prompted, click "Install Dependencies" to run bun install. This downloads the required packages (typically takes a few seconds).

Start the Server

Once dependencies are installed, TalkieServer will start automatically. You'll see a green status indicator when it's running.

Manual Installation

If you prefer to install dependencies manually (or need to troubleshoot):

Terminal

# Navigate to TalkieServer directory
cd ~/Library/Application\ Support/Talkie/TalkieServer

# Install dependencies
bun install

# (Optional) Start server manually
bun run src/server.ts

Troubleshooting

"Bun not found"

Install Bun from bun.sh, then restart Talkie.

"Cannot find package 'elysia'"

Dependencies are missing. Click "Install Dependencies" in settings, or run bun install manually.

"Port 8765 already in use"

Another process is using the port. Restart Talkie — it will automatically clean up stray processes.

Next Steps

TalkieServer is now ready. Next, set up Tailscale to enable secure networking between your Mac and iPhone.

Configure Tailscale

Set up secure networking between your Mac and iPhone