Update README and replace demo video

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.mp4 filter=lfs diff=lfs merge=lfs -text

README.md

@@ -8,10 +8,74 @@ sdk_version: 6.18.0
 python_version: '3.12'
 app_file: app.py
 pinned: false
-short_description: Convert your library to the spoken word
+short_description: Convert your books to the spoken word
+tags:
+  - track:backyard-ai
+  - sponsor:openai
+  - sponsor:nvidia
+  - sponsor:modal
+  - badge:off-brand
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Scriptorium
+
+Scriptorium is a Gradio-based app for turning EPUB books into audiobooks. It provides a custom front-end for uploading and configuring a book, previewing voices, running long-form synthesis, and exporting the finished audiobook once generation completes.
+
+## Demo video
+
+<video controls width="100%" src="https://huggingface.co/spaces/build-small-hackathon/Scriptorium/resolve/main/Video.mp4">
+  Your browser does not support the video tag.
+</video>
+
+[Open video directly](https://huggingface.co/spaces/build-small-hackathon/Scriptorium/resolve/main/Video.mp4)
+
+## Social media post
+https://bsky.app/profile/unlimiteddreamco.xyz/post/3moe744qpos2m
+
+## What it does
+
+- Parses EPUB uploads into chapter text and metadata.
+- Lets users select which chapters to include.
+- Supports preview generation before committing to a full render.
+- Runs full-book synthesis with progress updates and an export flow after completion.
+- Exports finished renders from session-scoped storage.
+
+## Project structure
+
+- `app.py`
+  - Main Gradio server entrypoint and API registration.
+- `frontend/`
+  - Custom HTML/CSS/JS interface for the three-step app flow.
+- `backend/epub.py`
+  - EPUB validation, parsing, metadata extraction, and chapter shaping.
+- `backend/synthesis_service.py`
+  - Main orchestration layer that routes preview/render work to local or Modal-backed synthesis.
+- `backend/modal_client.py`
+  - Client for the optional remote Modal synthesis service.
+- `modal_app.py`
+  - Modal FastAPI worker app for remote preview and render jobs.
+- `backend/export.py`
+  - Audiobook packaging and export helpers.
+- `tests/`
+  - Backend and integration-oriented test coverage for parsing, synthesis routing, Modal client behavior, and API wiring.
+
+## Models and synthesis backends
+
+Scriptorium currently supports these speech models:
+
+- `OmniVoice`
+  - Main model for presets, design-prompt voices, and voice cloning.
+- `Magpie TTS`
+  - Multilingual synthesis with speaker presets and optional text normalization.
+
+It can run them through two execution backends:
+
+- `HF/local`
+  - Runs synthesis inside the Hugging Face Space runtime.
+- `Modal`
+  - Offloads synthesis to a separately deployed Modal worker.
+
+The in-app voice presets such as `The Archivist`, `The Novice`, `The Warden`, and `The Illuminator` are themed preset layers on top of the underlying synthesis configuration.
 
 ## Modal backend configuration
 

Video.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c79c6c487a54fd57c7d48a9eed73d22445321b8c582ffb25f1f09d0a16437493
+size 7131007