Skip to main content
Send EdenLive a video feed, one reference image, and a text prompt. The video guides the layout, camera, and motion. The reference and prompt guide the appearance. Use a reference and prompt that match the scene in the video.

Match the reference to the opening view

Capture a frame from the view you plan to stream. In a 3D scene, place the player and camera before you capture it. Restyle the frame with an image editor or image-generation tool, keeping the camera angle, perspective, and positions of the main objects. In a third-person view, keep the character in the same position and at about the same size. EdenLive scales and center-crops the reference to 1280 × 704. Check the crop before you start, especially around objects near the edges. The generated output is also 1280 × 704. In an image-generation tool, try this instruction to restyle the captured frame:
Use that instruction in your image tool and upload the resulting image as your reference. Then write a scene prompt for EdenLive.

Describe the scene you want to see

Describe the setting and what appears in it. Specify materials, lighting, or other details that matter to the appearance. If a simple shape represents a character, describe who you want to see in its place. Match that description to the reference image.
Adapt this prompt to your own scene and reference image. For a third-person scene with a capsule-shaped player, you could add:
Test these prompts with your own scene. Movement, collisions, and game rules remain in your app, and its rendered video guides the camera movement and action. Use a nonblank prompt of up to 4096 characters. See set_prompt for the command format.

Change the appearance during a world

Send a new prompt with set_prompt. It applies from the next generated chunk, while EdenLive retains the world’s visual history. A large style change can appear gradually. Updating the prompt leaves a paused world paused. For example, keep the campground and change its lighting:
To replace the reference image:
  1. Pause the world with set_paused.
  2. Upload the new image.
  3. Call set_image with the upload reference. This ends the current world.
  4. Call start to create a new world from the image. See the schema guide for the full sequence.

Try a webcam or another video source

In a custom client, source_video can carry a webcam feed or video played from a file. Publish that video at a steady 10 to 60 fps and use set_source with source: "client". The tutorial shows how to publish video from a canvas. Create the reference from the view where you plan to start the video. Check the framing and orientation of the frames your client actually sends. For a webcam, check whether mirroring affects only the preview or also the transmitted video. Keep the camera steady for your first test, then introduce movement gradually. Our examples use rendered 3D scenes. We have not validated output quality for webcams or prerecorded video, including moving subjects. Treat the suggestions above as a starting point for your own tests.

See also