yappy

yappy · usage

You share, and it speaks.

Yappy has a single gesture: sharing. You're reading an article and it's time to cook; share it with Yappy and the voice keeps reading for you. A book for tomorrow's walk? Leave it rendering overnight and wake up to an audiobook. This page covers everything else.

on iphone and ipad

Sharing is the whole manual.

  1. From any app, tap share and pick Yappy

    Safari, your email, Files, a voice note, a PDF from a chat. Yappy accepts links, plain text, PDF, EPUB, Word, ODT and audio.

  2. Yappy opens by itself, instantly

    Nothing simmers inside the share sheet: iOS cuts extensions off at 120 MB, so Yappy copies what you shared and jumps to the app, where there are no limits. The jump is the design, not a workaround.

  3. The queue prepares it and it starts to speak

    Articles get cleaned (menus and banners out), videos bring their transcript, PDFs get paginated. If you're still in the app, playback starts on its own the moment it's ready.

  4. Lock the screen and pocket the phone

    The voice carries on. The lock screen shows cover, title and controls; your AirPods pause and resume; the system treats it like any other player.

Everything happens on the device. The only network Yappy touches is the visit to the URL you shared, made from your own phone. Your text never travels to a server: the voice is synthesized inside.

on android

The same gesture.

Share a link, a text or a document with Yappy and it lands in the same queue: article extraction, the karaoke reader and the voice, all on the phone itself. The Android build is the youngest of the family and still lacks three things the iPhone has: lock-screen controls, YouTube videos and the .m4b audiobook player. They're on the way; everything else already works the same.

on mac, windows and linux

One shortcut, and whatever you're looking at speaks.

ActionmacOSWindows and Linux
Read what I'm looking at (the selection, the browser page or the active document) ⌥⌘R Ctrl+Alt+R
Read the clipboard ⌥⌘V Ctrl+Alt+V
Pause or resume ⌥⌘Space Ctrl+Alt+Space

All three shortcuts are configurable in Preferences and work with the app tucked away in the tray. Beyond the shortcut, the desktop holds what doesn't fit in one hand:

The library

Everything you open or share stays on the home screen with its progress. You resume at the exact paragraph.

The paragraph editor

Each paragraph can carry its own voice, speed and pause. Perfect for dialogue, quotes, or bilingual documents.

Local transcription

Drop in a voice note or a recording and the local ear (Parakeet) turns it into readable text, uploading nothing.

Audiobook export

Any document comes out as a real .m4b with chapters taken from the script. Also as .wav or .mp3.

PDFs with eyes

Scanned PDFs go through local OCR before being read. Born-digital ones read straight through, page by page.

Themes

Cream paper by day, light ink on dark by night, or let the system decide.

the bridge

Your computer renders; your phone listens.

A whole book takes a while to synthesize. The bridge hands the heavy lifting to your computer and returns the finished audiobook to your pocket, over a direct, encrypted connection between your two devices (no one's server in between).

  1. On the computer: Preferences, "The bridge"

    Yappy shows you a QR code. It contains your computer's encrypted address and an invitation key.

  2. Point the iPhone camera at the QR

    The camera recognizes the link and opens Yappy: paired. The key is stored, and you can revoke it from the computer at any time.

  3. On the phone: "Convert on the computer"

    Pick the document; the computer synthesizes it at its own pace and the .m4b lands in the phone's library, chapters included. The night works for tomorrow's walk.

audiobooks

The real format: .m4b with chapters.

Yappy doesn't export "one long audio file": it exports .m4b audiobooks like the ones from the stores, with chapters taken from the document's actual headings, cover art and resume support. Listen inside Yappy (with its library and progress) or in any audiobook player you already use. And the guionizador gives them their breathing: a pause after headings, a list's own cadence in lists.

siri, shortcuts and the action button

"Hey Siri, read my clipboard with Yappy."

Yappy exposes real App Intents: they show up on their own in the Shortcuts app, answer to Siri, and can hang off the iPhone's Action button. There is nothing to set up.

Read my clipboard

Copy anywhere, ask Siri, and it speaks.

Resume reading

Picks up the last thing that was playing, right where it was.

Listen to a link

Takes a URL as a parameter: the perfect ending for your own shortcuts.

For hand-rolled automations, the yappy:// scheme is handled too:

URLWhat it does
yappy://action/read-clipboardreads the clipboard right away
yappy://action/resumeresumes (or toggles) playback
yappy://action/openopens the document picker
yappy://library?path=…plays that audiobook
yappy://pair?d=…pairs with a computer (the bridge)

There's also a home-screen widget with the last thing that played, ready to resume with one tap.

settings

Few dials, all real.

The voice

Ten voices, all polyglot: the same voice reads Spanish, English or Japanese without changing its timbre.

The speed

From 0.5× to 2×. The voice is generated at that speed, not sped up afterwards: the pitch never warps.

The pauses

How long it breathes between paragraphs. Headings and lists already bring their rhythm from the guionizador.

The language

Automatic detection per document and per paragraph, or set by hand. Quotes in another language switch on their own.

That was the whole manual.

Share, and listen. The rest are details, already in place.