All docs

Home & Films

When you land on runime.com you see a nebula-backed welcome screen with the headline "Your story, as a film." (let your story become a film) and a prompt box beneath it. This is where your film starts: you write your idea (or attach a PDF screenplay), optionally adjust the aspect ratio, style, quality, dialogue mode and duration from the box's bottom bar, then submit. The page is also the signed-in user's hub: notifications, the account menu, the quick-access dock and the Films page listing all your work are one click away. This article covers every control on the home page and the /films library.

On this page

Top bar, sign-in and notifications

The top bar carries everything about your identity and account. The brand sits on the left; the controls on the right change with your sign-in state. When an admin announcement is active, an announcement bar also appears at the very top of the page.

  • runime logo with the beta badge — the brand at top left plus a small badge showing the product is in beta; not clickable.
  • Sign in — shown at top right while signed out; opens the sign-in window. The same window also opens automatically if you try to submit a film without an account.
  • The account menu (avatar + name) — the dropdown at top right while signed in: Films, Profile, Usage, Billing, Connected apps, Admin and Log out. A live token-balance badge sits next to the Billing row; the balance loads when the menu first opens.
  • Notifications — next to the account menu, with an unread-count badge. The panel lists notifications and project invites; there is a Mark all as read button, and invites carry Accept / Decline buttons — an accepted project appears in your Films list. When empty, the panel reads "No new notifications." (no new notifications).
  • The announcement bar — appears at the very top only while an admin announcement is active; it shows the announcement's title and a truncated text, and clicking opens the full text in a window. You cannot dismiss it — it disappears when an admin removes the announcement.

The prompt box: write your idea or attach a PDF

The prompt box is your film's source. You write your screenplay, story or idea here; the box grows as you type. Instead of writing (or alongside it) you can attach a PDF screenplay — with a PDF attached, written text is not required. There is no image-attachment button and no model picker on the home screen; the only attachment is a PDF, and engines are chosen later in project settings and per shot.

  • Script, story or idea... (screenplay, story or idea — the text area) — you write the film's source here. In manual mode the placeholder becomes "Optional: a note or film name. You'll build it in the editor." (optional: a note or film title — you'll build the editor yourself) and the field may be left empty.
  • Attach PDF — at the far left of the bottom bar; attaches a PDF screenplay or book. Once attached, a dot appears on the icon and the tooltip shows the file name; clicking again removes the attachment. The server rejects files over 25 MB and non-PDF files.
  • MCP — a small link aligned right just above the box; with the hint "Connect Claude, Codex or Cursor over MCP and run runime by chat." (connect Claude, Codex or Cursor via MCP and drive runime by chat) it takes you to the MCP setup doc.
The prompt box and its bottom bar: the PDF paperclip on the left, the Orientation / Style / Quality / Dialogue / Length buttons in the middle, the submit arrow on the right.

Bottom-bar settings: aspect, quality, dialogue, duration

The icon buttons in the box's bottom bar make the film's framing decisions. If you submit without touching any of them, the film is created with the defaults: widescreen 16:9, the Cinematic 3D style, 720p, dialogue set to automatic, duration 1 minute. Note: clicking an already-selected menu option deselects it — if Aspect, Style or Duration is left empty, the corresponding icons shake on submit and the film does not start.

  • Aspect — the aspect ratio, in two groups: Cinema — Widescreen · 16:9 (the default), Cinemascope · 21:9, Classic · 4:3; Social media — Vertical · 9:16, Square · 1:1, Portrait · 4:5. Limited ratios show the note "Only {n} of the connected video models can render this shape"; 4:5 is fully disabled and reads "Not available yet — none of the connected video models outputs 4:5".
  • Quality — 720p — standard or 1080p — high resolution. 720p is fast and cheap; export offers upscale tiers later.
  • Dialogue — how the film speaks: Automatic, Spoken, Narrated, Silent (no dialogue), Fully silent (no audio). The screenwriter honors this choice — a wordless or narrated film is chosen here.
  • Duration — the target film length: Automatic or 1, 5, 15, 30, 45, 60, 75 minutes; the default is 1 minute (not automatic). In the Custom length box at the bottom of the menu you can type any number from 1–240 and confirm with Set or Enter.
  • Free trial note — small text at the bottom of the duration menu: "On the free trial the first film is written to about 1 minute, whichever length you pick." (on the free trial, your first film is written at ~1 minute regardless of the duration you pick). The free run is capped at 60 seconds server-side; the limit is stated right where you make the choice.

The style modal and the auto/manual switch

The brush icon in the bottom bar opens the modal where your film's visual identity is chosen. Three framing decisions are made in a single sentence at the top, the visual style tiles sit below, and the "who writes the screenplay" switch is at the bottom.

  • Style — opens the "Choose a style" modal. Once you choose, a blue dot appears on the icon; the tooltip reads your pick, e.g. "Style · Cinematic 3D".
  • The credit sentence "You're making a {format} in {medium}, spoken in {lang}." — at the top of the modal, three dashed-underlined dropdown words carry three decisions: film type (Story film story film / Promo / Commercial promo/ad), medium (Animation / Live-action live action) and dialogue language (Automatic reads as "the script's own language"; Türkçe, English, Español, Deutsch, Français, Italiano, Português, Русский, العربية, 日本語, 한국어, 中文, हिन्दी). Changing the medium swaps the style grid to that medium's looks, and the previous medium's style resets to the first of the new set.
  • Style grid — image tiles; clicking one selects the style and closes the modal. Animation offers 15 styles: Cinematic 3D, Realistic 3D, Classic 2D, Anime (Japanese), Stop Motion, Claymation, Comic Book, Cel-Shaded, Pixel Art, Watercolor, Low Poly, Rotoscope, Paper Cut-out, Vector / Flat, Silhouette. The Live-action medium offers 5 looks: Natural Realism, Cinematic, Documentary, Moody / Low-key, Vintage Film.
  • Example — a button that appears at a style tile's top right on hover (animation styles only). It opens an iconic reference clip for that style on YouTube in a new tab — so you see what the style really looks like before choosing.
  • Automatic / Manual — the two-position switch at the bottom of the modal decides who writes the screenplay. Its help text: "Automatic: the AI writes the whole screenplay. Manual: start with an empty editor and build the shots yourself (you can have the AI write it later)." In manual mode the submit button is always active and writing an idea is optional.

Submitting, the sign-in window and the waitlist

When your settings are complete, you launch the film with the arrow button. If you're not signed in, the sign-in window opens first; if you are, the request goes to the server and the screen switches to a loading view showing the production stages. During the gradual launch, a signed-in user who hasn't been admitted yet sees the waitlist card in place of the prompt box.

  • Send — at the far right of the bottom bar; creates the film. In automatic mode it is disabled without text or a PDF; in manual mode it is always active. If the Aspect/Style/Duration selection is missing, the relevant icons shake for attention and submission stops. Pressing while signed out opens the sign-in window; on success you go from the loading screen straight into the editor.
  • The checkbox "I accept the Terms of Use and Privacy Policy." — in the sign-in window; the terms and privacy links open in a new tab, and the Google button stays disabled until the box is checked.
  • Continue with Google — sign in or sign up with a Google account. If registrations are closed, a "New sign-ups are currently closed. Existing members can still sign in." notice appears (existing members can still sign in); in invite mode a Invite code field appears — new users enter their code, existing members may leave it empty; an invalid code is rejected.
  • The loading screen — full screen after submitting; it cycles through eight production stages such as "Preparing character prompts" (preparing character prompts), "Outlining the overall scenario" (outlining the screenplay) and "Building the scene plan" (building the scene plan). When the film is ready you are redirected straight into the editor; on error it quietly returns to the home screen.
  • You're in line — shown in place of the prompt box for a signed-in user not yet admitted during the gradual launch. An info card with an "Early access" badge: "Your account is ready — we're letting people in wave by wave, and it's your turn soon." It offers no action; admission is done by an admin. If the gate closes while the page is open, a submit attempt also lands on this card.

Below the hero: the dock, the model strip and the closing composer

For signed-in users, the quick-access dock sits below the prompt box; further down the page are the marketing sections, ending with a second prompt box.

  • The hero dock: Films · Profile · Usage · Billing · Connected apps — a macOS-style dock whose icons grow on hover (shown only for signed-in users not on the waitlist). Each icon's name appears in a bubble on hover (on touch devices the names are always shown). First in line is Films, where your work lives.
  • The model logo strip — a full-width scrolling band under the dock; it streams the names of the engines (providers) that produce the films and pauses on hover. Informational only, not clickable.
  • The down arrow — a gently bouncing visual cue at the bottom of the hero; it signals that marketing sections follow below. Not clickable.
  • Start with an idea (start with an idea — the closing composer) — at the very end of the landing sections, an exact backlit copy of the hero's prompt box. It runs the same creation flow with the same controls — a film started from the bottom of the page is created exactly like one started at the top.

The films library (/films)

All your work is listed on the Your films page as a card grid, newest first. The page opens inside the app shell (left menu); accessing it while signed out redirects you to the home page.

  • Your films — the page title; beneath it the subtitle "Everything you have made, newest first." (everything you've made, newest first).
  • New film — the primary button with a plus icon to the right of the title; it takes you to the home page (the prompt box) — new films start there.
  • Film card — up to 3 per row in the grid, loaded 12 at a time. The cover image shows the film's name ("Untitled film" — untitled film — if unnamed) and a relative update time like "2 days ago"; without a cover, a clapperboard-icon card is shown. Clicking opens the film: the owner and editors go to the editor; a member invited as viewer/commenter goes to the watch page the server grants for their role.
  • Generating / Error — the status badge at a card's top right, only on films that aren't ready: Generating while the film is still generating, Error if production stopped with an error; a ready film has no badge.
  • Shared / "Shared by {name}" — the badge at a card's top left plus the footer line; it shows this film was shared with you via someone's invite, with the owner's name in the "Shared by …" footer line. A shared card has no delete menu — deleting is the owner's job only.
  • Load more — under the grid (when there is more); appends the next 12 films below the current list, disabling itself with a spinner while loading.
  • No films yet. / Start with an idea — the empty-state card shown when you have no films; the Start with an idea link takes you to the home page's prompt box. While the list loads, a skeleton of the real grid (6 grey cards) is shown.
The films grid: cover, name and relative time; status badges at top right, the Shared badge on shared films, and the Load more button below.

Deleting a film

Deletion is offered only to the film's owner and never happens in one click — every delete goes through a confirmation window.

  • Card menu (⋮) → Delete film — the three-dot button that appears at a card's top right on hover (owner only). The single-item menu holds the red Delete film; choosing it opens the confirmation window.
  • The delete confirmation "Delete “{title}”?" — message: "The film, its shots, its sound and everything generated for it go with it." (the film, its shots, audio and everything generated for it go together). Warning: "This cannot be undone. Everything generated for this film is erased from our storage within 24 hours." (this cannot be undone; everything generated for this film is fully removed from our storage within 24 hours). If the film is still generating, an extra warning appears: "This film is still being made — deleting it stops the work in progress." (this film is still generating — deleting stops the work in progress). Buttons: Delete and Discard. On failure the window says "Couldn't delete, please try again." (couldn't delete, try again); the card leaves the grid only after the server confirms.

Costs and things to watch

The only price label on this surface is the free-trial note in the Duration menu: on the free trial, your first film is written at ~1 minute regardless of the duration you pick (the server caps it at 60 seconds). Creating a film does not open a payment window on the spot; the token-spending production steps happen in the editor and show their cost before running. Your current token balance appears next to the Billing row in the account menu.

  • A film submitted without touching anything is created with these defaults: aspect = widescreen 16:9, style = Cinematic 3D, quality = 720p, dialogue = automatic, duration = 1 minute, film type = story film, dialogue language = automatic ("the script's own language"), medium = animation, mode = automatic.
  • Clicking an already-selected option deselects it; if Aspect/Style/Duration is left empty, the relevant icons shake on submit and the film does not start.
  • The 4:5 ratio is deliberately disabled (no connected video model produces it); 21:9, 4:3 and 1:1 are selectable, but the menu tells you only a subset of the model catalog can produce those ratios.
  • A deleted film cannot be recovered; deleting a film that is still generating also stops the work in progress — the confirmation window says so explicitly.