Welcome

What Imaginary Arts is

Imaginary Arts is a Python library for making videos with code. You write a short script that says what the video should contain, run it, and get an mp4.

The library covers everything a short-form video needs:

  • Generated pictures and clips. Describe a scene in words and the library generates a still image or a video clip for it, in a consistent art style, with recurring characters, props and places.
  • Your own footage. Import video, audio and images from disk, trim them, and place them on the timeline next to the generated material.
  • Voice. Turn a script into a narrated voiceover, or transcribe speech from your own footage. Either way you get the audio and the timestamp of every word, which is what makes automatic captions and precise timing possible.
  • Captions and text. Word-by-word or sentence-by-sentence captions, watermarks and titles, in a handful of good fonts.
  • Look. Color grades, film looks, camera motion and transitions, so the result looks like a video and not a slideshow.

There is no editor to click through and nothing to install beyond the Python package: generation and rendering happen on the Imaginary Arts servers, and the finished video is sent back to you. Your script is the video, and re-running it after a change regenerates only what changed, so iterating is fast and cheap.

Who it is for

Two kinds of people use it:

  • People who code and want a video pipeline they can version, reuse and automate. The library is a normal Python package with a small, explicit API.
  • People who don't code but use a coding agent such as Claude Code. Because the whole library is text, an agent can write and run video scripts for you. See Getting started with agents.

How this documentation is organized

  • Getting Started installs the library and walks through a first script.
  • Core Editing is the foundation: the project and its cache, placing things on a timeline, working with files, and transitions.
  • Voice and Subtitles covers voiceovers, speech-to-text, timing things to what is said, and captions.
  • Styling covers text, color, color correction and camera motion.
  • Image and Video Generation covers generating pictures and clips, keeping characters consistent, and iterating on results.

The pages are written to be read in order, but each one stands on its own. Press Next to continue, or jump in wherever you like.