Documentation

Getting Started

1. Install Planetanium

Download the app for your platform and install it.

2. Configure API Keys

Open Settings (gear icon in the top bar) and add your API keys:

You only need the keys for the services you want to use. At minimum, you need ElevenLabs (transcription) and one image generation provider.

3. Create Your First Project

1. Click New Project
2. Upload or record your audio narration
3. Click Transcribe — AI will transcribe with word-level timing
4. Click Detect Scenes — AI segments your narration into scenes
5. Click Generate Images — AI creates visuals for each scene
6. Optionally, Animate scenes to create video clips
7. Click Export to render the final video

Core Features

Prompt Editor

All generation features open a dialog with full prompt control:

• Detect Characters — Identify and extract characters from your narration
• Detect Scenes — Segment narration into logical scenes
• Generate Description — Create detailed descriptions for scenes
• Generate Shots — Break scenes into individual shots
• Generate Image — Create visuals with customizable prompts
• Animate — Convert images to video clips

Each dialog lets you review and edit the prompt before generation, giving you complete control over AI output.

Transcription

Transcription uses ElevenLabs Scribe v2 which provides:

• Word-level timing for precise synchronization
• Speaker diarization (identifies different speakers)
• High accuracy across languages

When you edit transcription text, your changes are stored as overlays — the original transcription is preserved, and your edits are applied on top.

Shots

Shots are the building blocks of your video:

• Each shot belongs to a scene
• Shots can have character references for consistency
• Shots can be individually animated
• Adjust shot duration and timing on the timeline

Working with Scenes

After scene detection, you can:

• Split or merge scenes by adjusting boundaries on the timeline
• Edit scene text to change the narration segment
• Upload custom images for any scene
• Regenerate individual images with different prompts

Character Consistency

For stories with recurring characters:

1. Go to the Characters panel
2. Add characters with descriptions
3. Upload or generate reference portraits
4. Enable character references when generating scene images

Visual Styles

To maintain a consistent look:

1. Open the Visual Style panel
2. Upload reference images that represent your desired style
3. Add a style description (e.g., “watercolor illustration, soft colors”)
4. All generated images will follow this style

Export Options

Planetanium offers three export options:

Export Settings

Customizing Prompts

Advanced users can customize the AI prompts used at every stage:

1. Open Settings > Prompts
2. Edit templates for scene detection, image generation, etc.
3. Use template variables like {{scene_text}} and {{style_description}}

Troubleshooting

Images not generating? Check that your API key is valid and has credits. Try a different model.

Transcription failing? Ensure your ElevenLabs key is active. Check that the audio file is not corrupted.

Export quality issues? Use 1080p resolution and 30fps for best results. Ensure source images are high quality.