Docs

Projects & Home Screen

Managing your audiobook projects from the home screen.

Screenshot: Home screen with project cards grid

Creating a New Project

Click the "New Project" button on the home screen to create a project. You can upload your manuscript by dragging and dropping a file onto the upload area, or by clicking to browse your files.

Supported Formats

.md — Markdown files. Chapters are split on top-level headings (# Chapter Title).
.txt — Plain text files. Parsed the same way as Markdown — use headings for chapter breaks, or the entire file becomes one chapter.
.pdf — PDF files. Text is extracted and chapters are detected automatically.

For best results, use Markdown files with clear heading structure. Each top-level heading becomes a separate chapter.

Project Cards

Screenshot: Close-up of a project card showing badges

Each project card shows the project name and status badges:

Chapters — The number of chapters in the project.
Snippet progress — How many audio snippets have been generated out of the total.

Managing Projects

Click on a project card to open it in the editor. To delete a project, click the delete button (🗑) on the project card. You will be asked to confirm before deletion.

Deleting a project permanently removes all its data, including generated audio. This action cannot be undone.

Project Ownership

Each project belongs to the user who created it. You can only see and edit your own projects on the home screen. Admin users can see all projects across all users via the Admin panel.