Docs / Concepts

Project directory

A project is one folder. It holds the series, one folder for each episode and one folder for each shot.

One project is one series. minicut new makes the project folder with its first episode, ep01. The loops then add their files to it, so you and your agent can open any of the work. Characters, locations, props and styles are not in the project folder. They live in your home folder, and the project lists them by id in series.json.

With no --dir, a project goes in the projects folder of your home folder. Each episode is epNN, and ep001 with three digits when you plan more than 99 episodes. Each shot is cNN.

Project folder
rain-shop/
  series.json               title, screen shape, episode list and library ids
  source/
    sources.json            the sources the story comes from, empty at first
  research.md               the researched idea
  script.md                 the story and world document
  episodes/
    ep01/
      script.md             the episode script
      shots.md              the shot sheet
      assets.md             the asset list and the picture prompts
      prompts.md            the video prompts, one section for each shot
      loops.json            the round of each loop
      mock.sheet.jpg        one frame of every shot, made for the Mock loop
      index.html            the episode timeline, empty until the first cut
      minicut.json          the editor settings for this episode
      music/                the episode's music
      scenes/               scene files
      canvas/               canvas boards of this episode
      clips/
        c01/                one folder for each shot
          prompt.md         the video prompt of the shot
          clip.json         the shot's model, settings and picked take
          lines/            the voice of each spoken line
          t01.mp4           a take, saved as t01, t02, and on
          t01.json          the record of the take

Created by minicut new

minicut new makes series.json, source/sources.json, and in ep01 the clips and music folders, index.html and minicut.json. Every other entry appears when the step that makes it runs. See Steps and loops.

The fields of each file are on Project files.

Next