Author Guide
Guides to writing, listening, and publishing in the BadgerLeaf workspace.
Task recipes
Add sound cues
Attach simple start or end audio cues to a manuscript block.
Choose and buy a subscription
Compare published Beta plans and complete a secure US Stripe checkout.
Configure narration voices
Set narrator defaults and optional spoken-dialog voices before listening and publishing.
Create a book and manuscript
Add a book and a manuscript manually when you want to start inside BadgerLeaf.
Edit a manuscript
Work in the manuscript editor without losing the publishing structure around the text.
Find and replace
Search manuscript text, blocks, inline items, and repeated spacing with literal or regex matching.
Find files and downloads
Open Job Status for the account, select the job, and use Files or Downloads. Available formats depend on what that job produced. Listening and publishing share this history; project exports remain separate export jobs.
Find Help
Open the Author Guide from the account menu and keep it available while you work.
Import a manuscript
Bring markdown or plain text into a book manuscript.
Listen to a short preview
Listen to a short selection, stop playback, or start it manually if needed.
Listen to selection
Listen to a short selection, stop playback, or start it manually if needed.
Move, replace, and restore files
Move, rename, replace, delete, or restore files and follow their reference-update jobs.
Navigate the Explorer
Use the Explorer to move between projects, books, manuscripts, saved versions, and settings.
Project package import and export
Move project packages through queued import and export workflows.
Recommended first workflow
Move through the smallest complete manuscript-to-preview path.
Start a new project
Create the project container that will hold books, manuscripts, assets, and settings.
Use chat while working
Choose between resource-bound chat, floating chat, and dedicated chat.
Concept reference
Account
The membership and ownership context for projects.
Account members and permissions
How account membership, invitations, roles, and scoped permissions work together.
Account settings
Account-level collaboration settings.
Account, project, book, and manuscript
How the main writing objects fit together.
Agent review jobs
Queue a background manuscript review using one of your ready agents.
AI assistant settings
Guidance fields that shape assistant behavior for an account, project, book, or manuscript context.
Artwork and image settings
How image assets are selected, sized, and reused for book, manuscript, and inline output.
Asset picker dialogs
Choose ready project assets for artwork, inline images, and audio cues.
Assets, voices, and effects
The supporting materials behind audiobook-oriented listening and publishing.
Book
A book groups manuscripts and book-level publishing settings inside a project.
Book settings
Book-level overrides for one title inside a project.
Chat agents
Configure and manage assistant agents used from chat surfaces.
Editor block, table, image, and link settings
Controls used by manuscript editor dialogs for selected content.
Effect preset settings
Reusable audio effect definitions used by sound cues and previews.
Effects and sound cues
Reusable audio effects and placed cues for audiobook production.
Explorer
The sidebar for projects, books, manuscripts, headings, and actions.
Include in
Include in offers Print & audio, Print only, Audio only, and Neither. These choices control the existing outputs; they do not add a new file format. Inline math keeps its print-only restrictions. Neither can hide a heading from output without removing its section boundary.
Listening and publishing
Listen to a short selection, stop playback, or start it manually if needed.
Manuscript
The editable source text that drives ebook and audiobook production.
Manuscript editor
The writing surface for the selected manuscript.
Manuscript settings
Manuscript-level publishing overrides, assistant guidance, and artwork choices.
Notifications and invitations
Review account invitations and other notifications that need a response.
Profile and visibility
Pen name and discoverability controls for your public-facing profile identity.
Project
A publishing effort that collects books, manuscripts, assets, voices, and listening and publishing settings.
Project and book heading settings
How heading presets and block defaults drive section rhythm, audio cues, paragraph timing, and output tables of contents.
Project library
Upload, find, preview, and organize images, audio, and other project files.
Project Settings
Open **Project Settings** immediately above **Project library** in the Explorer. It starts collapsed. Choose **General**, **Typography**, **Headings & contents**, or **Voices** to edit in the main workspace. Switching sections keeps your drafts and scroll position. **Save changes** saves all changed sections and keeps the page open. In nested editors, **Apply changes** adds edits to the project draft; save the project afterward. Leaving with unsaved edits offers keep or discard. Book and manuscript settings remain in their own dialogs; they can override inherited project defaults where supported. Provider secrets are never retained after leaving the project settings session. **Provider keys** appears only for users approved to use their own provider keys (BYOK). Silence at the edges of synthesized speech is trimmed automatically; there is no toggle. Authored pauses and heading/block timing are unchanged. **General** contains only the project chat toggle. Put project background and author guidance in **Project library** > **Reference and Guidance**, not a description field. Existing description metadata is preserved; saving settings neither migrates it nor overwrites the reference document.
Pronunciation settings
Reusable pronunciation rules for names, invented terms, and other narration-sensitive words.
Provider key manager
Project-scoped provider keys used by listening and publishing and assistant integrations.
Publish manuscript
Publish manuscript prepares files for the entire manuscript, even when you select only audio. Choose the output formats, then Publish. Publication ready means the files are ready to download, not that your work has been distributed publicly.
Understand Usage and Billing
Read account capacity, agent counters, managed credits, and narration allowances.
Voices
Narration settings for text-to-speech output.
Workspace
The authenticated writing surface where author work happens.
Troubleshooting
An audio asset is not ready
Understand why an uploaded asset may not be usable immediately.
I cannot find a project, book, or manuscript
Check account context and the Explorer before recreating missing work.
Import is still processing
What to check when an imported manuscript has not become ready.
Listening or publishing failed
Check the job status and Technical details. The original error, identifiers, and diagnostics remain available for support. Check narration service, payment source, voice settings, and audio file readiness before retrying. A processing failure does not establish that manuscript edits were lost.
Live updates or chat are offline
What to do when realtime workspace behavior is unavailable.
Token inspector
Inspect decoded browser tokens when debugging authentication and audience issues.