🇬🇧 English | 🇫🇷 Français
A modern desktop editor for creating, aggregating, testing and exporting Lunii-compatible story packs.
Story Studio pour Lunii est un editeur desktop open source pour creer, importer, verifier et exporter des packs d'histoires compatibles Lunii. La documentation utilisateur en ligne est actuellement disponible en français ; ce README reste la présentation anglaise du projet.
Story Studio for Lunii lets you create, import, organize, test and export Lunii-compatible story packs in a visual desktop workspace. Everything stays local: images, audio, navigation, simulation and ZIP export.
Import your media, assemble and trim audio, crop images, organize menus and story paths, then export a Lunii-compatible ZIP without juggling between several tools.
Story Studio is a community tool. It is not affiliated with, endorsed by, or sponsored by Lunii.
Story Studio is currently in beta. The app is usable, but it may still contain bugs, edge cases and compatibility issues with some community packs. Please keep backup copies of important projects and report reproducible problems through GitHub issues.
Story Studio 0.9.8 adds comprehensive searchable user documentation, improves folder and simulator navigation, and lets YouTube imports select an available audio language. It also makes recovered sessions and custom endings clearer.
Discover Story Studio with two ready-to-open packs that you can explore in the simulator and adapt in the editor:
 Léo la licorne Download from Proton Drive |
 Toudou mon doudou + Cache-Cache — complete collection Download from Proton Drive |
To explore a pack in Story Studio:
- Download its ZIP file from Proton Drive.
- Launch Story Studio and click Modify an existing pack.
- Select the downloaded
.zipfile.
These packs are distributed separately from the software. Their stories, audio files and illustrations are not covered by Story Studio's MIT license.
| Status | Beta |
| Target platforms | Windows x64, Linux x86_64 and macOS Apple Silicon |
| Interface language | French only for now |
| Project format | .mbah |
| Export format | Lunii-compatible ZIP packs |
| Main stack | React 19, Vite, Tauri 2, Rust |
| Workflow | Guided home workflows, visual tree editor, ZIP pack aggregation, node-based navigation, media explorer, simulator |
| Privacy model | Local app, no hosted backend, no telemetry |
Story Studio keeps the complete workflow in one local application: start from your own files or an existing pack, prepare the media, build the navigation, test the result and export a pack ready for the story box.
Start however you like, reopen saved work, edit an existing ZIP/7z pack, or start from a podcast or YouTube source. Dedicated guided flows also let you aggregate several packs or inspect a community pack.
Import or record audio, then adjust it before using it in a story. A long recording can be split into reusable clips, while several files can be reordered and assembled into a single track without changing the originals.
| Split one recording into clips | Assemble several files into one track |
|---|---|
 |
 |
Generate voices locally with zero-config Piper or use XTTS for advanced voice cloning. ComfyUI can produce illustrations through a local service, with both voice and image jobs followed from Story Studio's generation queues.
| Generate a voice locally with Piper or XTTS | Generate an illustration with ComfyUI |
|---|---|
 |
 |
Images can then be cropped, resized and adjusted for the 320x240 story-box format.
Build menus and stories in the tree, assign their images and audio, and define what the buttons do during and after playback. The Media explorer keeps used and unused files available alongside the project.
Open the diagram full-screen to understand the complete structure, story groups and return paths without losing the level-by-level organization.
The floating simulator then lets you play through the same navigation directly on top of the diagram before exporting.
Check the public metadata, cover, filename and pack-wide audio or navigation options. Story Studio reports whether the project is ready, then generates the Lunii-compatible ZIP from the same workspace.
| Review pack metadata before export | Adjust pack-wide generation settings |
|---|---|
 |
 |
Existing community packs can also be analyzed separately. The checker groups structural, image and audio findings, proposes safe corrections and can export a detailed report.
- Visual tree editor with nested menus, multi-select, drag-and-drop and contextual actions.
- Guided home workflows to edit an existing pack, create from a podcast or YouTube, aggregate ZIP packs, and check/correct a community pack.
- Lunii ZIP pack import: inspect, extract into an editable project, preserve branching graphs with shared references, and aggregate with your own stories.
- Built-in audio workflow: microphone recording, trimming, cuts, fades, assembly and silence insertion.
- Built-in image workflow: automatic 320×240 cropping, text-image generation from node names.
- Local voice generation with Piper by default and XTTS as an advanced opt-in backend.
- Media explorer with tags, filters, usage counters and quick previews.
- Built-in simulator to test navigation and end nodes before export.
- Validation and render queue: compatibility checks and serial generation with log tracking.
- Optional local integrations YouTube via yt-dlp, XTTS (voice) and ComfyUI (images).
- Project comfort: optional-save sessions, autosave, recovery snapshots, safety versions, configurable shortcuts, light/dark themes, full diagram view.
I was looking for a simple tool to create audio stories for my child. As a former video editor, I could never find in existing tools what felt essential to me: a visual and straightforward interface that makes building a narrative fluid and frictionless, without relying on command-line tools or dealing with complex folder structures.
Story Studio was born from that need: bringing import, images, audio, navigation, simulation and export into one clear local workspace.
| Platform | Requirements and limits |
|---|---|
| Windows x64 | Windows 10 or later with WebView2 |
| Linux x86_64 | A glibc-based distribution with WebKitGTK 4.1 and the usual GStreamer codecs; AppImage, DEB and RPM packages are available |
| macOS Apple Silicon | macOS 11 or later on an M1-or-newer Mac; Intel Macs are not supported |
Bundled third-party binaries keep their own licenses and pinned provenance — see THIRD_PARTY_NOTICES.md and the corresponding-source offer.
Download the package for your platform from the GitHub Releases page:
- Windows x64: use the EXE installer, or the MSI package for managed deployments.
- AppImage: make the file executable with
chmod +x Story-Studio*.AppImage, then run it. - Debian/Ubuntu: install the downloaded DEB with
sudo apt install ./Story-Studio*.deb. - Fedora: install the downloaded RPM with
sudo dnf install ./Story-Studio*.rpm. - macOS Apple Silicon: open the DMG, drag Story Studio into Applications, then launch the app.
The macOS build has no Developer ID certificate and is not notarized. Gatekeeper may therefore block its first launch. In Finder, Control-click the app and choose Open, or use System Settings → Privacy & Security → Open Anyway. Do not disable Gatekeeper globally.
AI integrations are optional. XTTS was tested on Linux in CPU mode; GPU mode was not validated for 0.9.8. It has not been installed or manually validated on macOS. ComfyUI is manually validated on Windows only: manual Linux and macOS tests have not been run.
To build from source or contribute, see CONTRIBUTING.md.
Story Studio saves projects as .mbah files. Runtime assets are organized in
managed workspace folders:
| Folder | Purpose |
|---|---|
fichiers-importes/ |
Imported media files when copy-on-import is enabled |
enregistrements/ |
Microphone recordings |
voix-generees/ |
XTTS-generated voice clips |
images-generees/ |
ComfyUI-generated and edited images |
zips-extraits/ |
Unpacked ZIP collections |
sauvegardes/ |
Default save folder and safety versions |
exports/ |
Suggested output folder for generated packs |
Files in managed media folders use a {project-name}__ prefix so multiple
projects can share the same workspace more safely.
Application data is stored under %LOCALAPPDATA%\com.hugs11.story-studio on
Windows, ${XDG_DATA_HOME:-~/.local/share}/com.hugs11.story-studio on Linux,
and ~/Library/Application Support/com.hugs11.story-studio on macOS.
User-selected files remain accessible outside these folders, including on
external macOS volumes under /Volumes.
When Story Studio offers to delete media from disk, it only deletes files inside managed workspace media folders. External source files are removed from the project or media library reference only.
- Online user documentation — currently available in French
- Piper and XTTS local voices — French
- ComfyUI integration — French
- Security model
- Third-party notices
- Changelog
- Complete and validate the Windows x64, Linux x86_64 and macOS Apple Silicon packages.
- Exit beta with a polished v1.
- Adapt the app to support other story-box devices.
Contributions are welcome, especially:
- Reproducible bug reports.
- Compatibility notes for community packs.
- Documentation improvements.
- Focused pull requests with clear testing notes.
Please read CONTRIBUTING.md before opening a pull request.
Story Studio is a local desktop file editor. Optional XTTS and ComfyUI features connect to local services configured by the user.
See SECURITY.md for the permissions model and vulnerability reporting process.
Story Studio source code is licensed under the MIT License.
Bundled third-party binaries and copied third-party assets remain under their respective licenses. See THIRD_PARTY_NOTICES.md.