Talking Tom
An open-source macOS app that turns a PDF, Word document, or text file into clean spoken audio. It removes citations, repeated headers, page numbers, and OCR noise, then narrates the useful text with a Microsoft Edge neural voice. A waveform player, pitch-preserving speed control, and saved transcript make the result practical for long readings.
Why I built it. Computer science and philosophy both involve a lot of reading. I wanted a way to move dense papers off my desk and into a walk—and to replace another subscription with a tool shaped around the way I actually study.
macOS security. This download is an unsigned source installer. Apple may warn that it cannot verify the developer or check the software for malware. See Apple’s security guidance. If the message says the app will damage your computer or contains malware, stop and report the exact warning. No API keys or personal settings are included; use your own Anthropic key.
Need to force-open the installer? Use Apple’s per-app security override in step 3 below. It approves only this installer; do not disable Gatekeeper or remove quarantine protection.
New in 1.2.0: compact player and reliable speed control. Shrink Talking Tom to 380 × 270 pixels beside your PDF; enlarge it or click Full app to return to the editor. Native macOS audio now changes playback speed from 0.5× to 2× without the previous one-hour limit or rebuilding the recording in memory. Speed is relative to the saved audio, whether it was generated at 1× or another rate. Your position, pause state, text, and normal launch size are preserved.
Updating? Quit Talking Tom, then run setup.command from the new download. Your settings, saved audio, and transcripts are preserved.
Open-source personal project. Talking Tom is unofficial and is not affiliated with or endorsed by Outfit7, Microsoft, or Anthropic. An Anthropic API key is required for the app’s Claude-powered document processing. Text selected for narration is sent to Microsoft’s online Edge voice service to generate audio, and document text is sent to Anthropic through your API key. Settings, generated audio, and transcripts are stored locally on your Mac.
Reads what matters
A built-in rules pass removes citations, headers, footers, page numbers, and OCR word splits. Claude then handles messier documents while preserving their meaning and structure.
English, Spanish, or both
Choose from English and Spanish neural voices. Claude prepares the document before narration, and “Read in” can translate it independently of the app’s bilingual interface.
A real audio player
Scrub the waveform, jump ten seconds, and listen from 0.5× to 2× without shifting the pitch. The MP3 and its text transcript are saved together.
Install and use
- Check the requirements. You need a Mac—Intel or Apple Silicon—an internet connection, and an Anthropic API key. You do not need to install Python, Homebrew, or any other software prerequisite.
- Review the installer. Download and unzip the file, open the
talking-tom-1.2.0folder, and readREADME.mdbefore openingsetup.command. This source installer is not signed with Developer ID or notarized by Apple. - If macOS blocks
setup.command, force-open it with Apple’s per-app override.- Try to open
setup.commandonce so macOS records the blocked attempt. - Open System Settings → Privacy & Security, scroll to the Security section, and click Open Anyway beside the message about
setup.command. - Authenticate if macOS asks, then click Open in the warning that appears. Terminal should begin the setup.
- Use this override only for the “cannot verify the developer” warning. If macOS says the file contains malware or will damage your Mac, stop and do not bypass that warning.
- Try to open
- Let setup finish. A Terminal window downloads a private copy of Python and the app’s dependencies, then builds Talking Tom in your Applications folder and places a shortcut on your Desktop. This takes about two minutes. When Terminal says Done., you can delete the downloaded folder.
- Open the app. Launch Talking Tom from Applications or the Desktop shortcut. On first launch, choose English or Español; you can change this later in Settings.
- Connect Claude before using Talking Tom.
- Use Anthropic’s official API overview for its current setup guidance.
- Create or manage your key on Anthropic’s API Keys page . Anthropic’s Billing page contains its current payment and credit options.
- Open Settings in Talking Tom, paste your Anthropic API key, and save it.
- Choose a document and listen. Select a PDF, Word (
.docx), or text file—or paste text—then choose a voice, speed, cleaning mode, and output language. Talking Tom saves the MP3 and transcript in~/Talking Tom/.
Install
Read README.md before setup.commandLaunch
Open Talking Tom from ApplicationsYour files
~/Talking Tom/Generated audio and transcripts stay together in this folder.
6ce68a15d037f42e4b8eecd2d6bc226fc98d6d384250bc6656e6419f7b4ac26a