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.
-
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.
-
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.
-
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.
-
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.
| Action | macOS | Windows 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).
-
On the computer: Preferences, "The bridge"
Yappy shows you a QR code. It contains your computer's encrypted address and an invitation key.
-
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.
-
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:
| URL | What it does |
|---|---|
yappy://action/read-clipboard | reads the clipboard right away |
yappy://action/resume | resumes (or toggles) playback |
yappy://action/open | opens 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.