Skip to content

Export and extras

jp edited this page Jul 12, 2026 · 2 revisions

Export & extras

Take the audio with you, take the text with you, and drive playback without opening the app. Plus the first-run flow and the little celebrations along the way.

Make your own audiobook (.m4b export)

Shipped via #1003.

Turn any fiction into a chaptered audiobook file you can keep, copy, or play in any audiobook app. Candela renders every chapter through your selected neural voice, encodes the PCM to AAC, and muxes it into a single .m4b with per-chapter markers (title + start offset for each chapter), so your audiobook player's chapter list lines up with the source. An .mp3 fallback path exists for players that don't read M4B chapter atoms.

Because synthesis happens locally, export time scales with book length and device speed — the same engine and per-voice tuning you use for playback apply to the rendered file. Launch it from a fiction via the Create audiobook sheet.

Export as EPUB

The :source-epub-writer module serializes a fiction back out to a standards-compliant EPUB — a title page that notes where the text came from, plus one XHTML document per chapter — so you can read it in any EPUB reader or archive it offline. (This is the export counterpart to the local-EPUB import source.)

Now Playing home-screen widget

Add the Now Playing widget to your Android home screen to control playback without opening Candela. Three sizes adapt to the space you give it:

Size Shows Controls
1×1 cover / current chapter tap to open the app
4×1 cover, title, progress Play / Pause, Next
4×2 cover, title, progress Play / Pause, Next, Sleep timer

The widget tracks the live playback snapshot, so it stays in sync with the notification, lock screen, and Bluetooth transport.

First-run onboarding

Shipped via #599.

A brand-new install walks through a short, forward-only three-screen welcome:

  1. Welcome — what Candela is.
  2. Voice picker — choose a starter voice (a Piper voice gets you a first chapter in seconds; Kokoro is the heavier, multi-speaker option).
  3. First fiction — pick something to listen to right away (the TechEMPOWER resource library, a sample, or paste a URL).

After you finish (or skip), the welcome never reappears for the life of the install. It can be replayed for testing from Settings → Developer → Reset onboarding.

Milestone celebrations

Candela marks a few moments with a one-time celebration dialog — a version-milestone card on qualifying builds (the v0.5.00 "graduation" card and the v1.1.0 "ignite" card), shown once per install and then dismissed forever — plus a small confetti easter-egg in the reader. These are celebrations of app milestones, not a reading-streak tracker; Candela does not gamify how often you read.

See also

Clone this wiki locally