timeline | object | The video, scene by scene, with its look; or a script, whose lines become its scenes: text, or one already voiced, as given back voiced, each voiced line kept as it was voiced and not voiced again. A timeline is {version: 2, title?, aspect_ratios: [9:16, 1:1, 4:5, 16:9], brand?: {back, text, accent: colours like #1c1c1c (the accent colours a caption style's key or said word; leave it out to keep captions black and white), font: the font of words on screen that name none, one of Inter Tight, Inter, Manrope, Archivo, Montserrat, Poppins, Figtree, Bricolage Grotesque, Rubik, Bebas Neue, Anton, Oswald, League Gothic, Fraunces, Playfair Display, Instrument Serif, DM Serif Display, PT Serif, Caveat, Bangers, Luckiest Guy, JetBrains Mono}, voice?: {name: one of Achernar (soft, female), Achird (friendly, male), Algenib (gravelly, male), Algieba (smooth, male), Alnilam (firm, male), Aoede (breezy, female), Autonoe (bright, female), Callirrhoe (easy-going, female), Charon (informative, male), Despina (smooth, female), Enceladus (breathy, male), Erinome (clear, female), Fenrir (excitable, male), Gacrux (mature, female), Iapetus (clear, male), Kore (firm, female), Laomedeia (upbeat, female), Leda (youthful, female), Orus (firm, male), Pulcherrima (forward, female), Puck (upbeat, male), Rasalgethi (informative, male), Sadachbia (lively, male), Sadaltager (knowledgeable, male), Schedar (even, male), Sulafat (warm, female), Umbriel (easy-going, male), Vindemiatrix (gentle, female), Zephyr (bright, female), Zubenelgenubi (casual, male)}, captions?: {style: clean (Clean: White, heavy, a few words at a time. Each word lights up as it is said.), pill (Pill: The word being said sits in a white pill, in black.), box (Box: The phrase on a dark rounded box, for busy footage.), bold (Bold: Heavy words that pop in as they are said; the word being said grows.), subtitles (Subtitles: One or two full lines, smaller, without movement: for talks and wide videos.) or off; size?: a type size, 16 to 400, pixels on a frame whose shorter side is 1080 (about 72 reads like a phone app's captions; larger means fewer words at a time); font?: one of the fonts below (Inter Tight when left out); rows?: 1 or 2 lines a caption runs to (1 when left out); width?: how wide a caption may run, as a share of the frame's shorter side, 0.2 to 3; colour?: a colour like #ffffff; said_colour?: the word being said in Pill, on its pill (near-black when left out); weight?: 100 to 900, the nearest its font has (its style's when left out); ahead?: the words not said yet, style (As its style: as its style shows them), faded (Faded: faint until each is said), full (Full: as clear as the word being said) (style when left out; none to come in a style that shows each word as it is said); outline?: false for none, or {colour?, width?: 0 to 30, percent of the type size}; shadow?: false for none, or {colour?, opacity?: 0 to 100 percent, blur?: 0 to 100 and distance?: 0 to 50, percent of the type size, the shadow dropped straight down} (the style's own when left out); in?: style (As its style: the move its style has), none (None: just there), fade (Fade: comes up from nothing), rise (Rise: lifts into place), pop (Pop: springs up with a little overshoot) (style when left out); out?: fade (Fade out: a quick fade as the next comes), none (None: just gone) (fade when left out); with a size, each caption is as many words as fit its width in its rows, never ending on a weak word; case: as_said, capitals, lower_case; place?: {x, y}: where every caption sits, its middle as shares of the frame's width and height, 0.05 to 0.95 (above the bottom of the safe area when left out); lines?: [{from, to: the first and last word of one scene's line it shows, each {scene: id, word, nth?}; text?: what it shows instead of those words, such as 58% for fifty-eight percent, at most 120 characters; place?: {x, y} for this one; hide?: true to show nothing for it; hold?: true to stay on screen until the next caption; inline?: true for text shown among the words around it, in their caption, such as a figure for words said, never a caption of its own}]: captions set by hand, none overlapping; every other caption is made from the words said, a few at a time}, pauses?: {longest?: seconds, 0 to 5, that every longer pause plays; at?: [{after: {scene: id, word, nth?}, seconds: 0 to 10}]: a pause after that word set by hand, made where there was none; or {before: {scene: id, word}, seconds} for the quiet before the first word of a line with nothing said before it, from its scene's start}: a pause is a gap of a quarter second or more between two words the voice said, or before a line's first word or after its last where nothing is said before or after it; a line not voiced yet has only the pauses set on it by hand, which play exactly as set once it is voiced; longest leaves the quiet before a first word and after a last word as voiced; shortened, lengthened or removed, the video is that much shorter or longer and everything after it moves with its words, and nothing is voiced again, transition?: cut, blur, fade, push, zoom between images (cut, none, when left out), look?: natural, mono, film, crisp over the images, progress?: true for a thin bar showing how much is left, safe?: {area: usual (TikTok, Reels and Shorts: inside the lines captions and text sit on, clear of what the apps put over a video), tiktok (TikTok: clear of TikTok's buttons, name and caption), reels (Instagram Reels: clear of Instagram's buttons, name and caption), shorts (YouTube Shorts: clear of YouTube's buttons, name and caption), even (Even margin: the same distance from every edge), none (None: only the frame's edges and middle) (usual when left out; TikTok, Reels and Shorts each in 9:16 only, the usual one in other shapes), margin?: for even, a share of the frame's shorter side, 0.01 to 0.25 (0.05 when left out)}: where nothing a person needs to read should sit, as placed gives it in each aspect ratio; keep text boxes, logos and captions inside it, music?: {prompt?: what it sounds like, its mood, instruments and pace, only when the person asks for music (made when it runs, as long as the video), src?: a file_id, from?: prompt when it was made from those words, volume 0 to 1}, scenes: [{id, line: what is said, duration: seconds, hold?: seconds it runs on after its line and its clips end, keys?: one or two words of the line, exactly as written, that carry its meaning}], images: [{id, at, until?, src?: a file_id, kind: image or video, motion: still, push, punch, zoom_in, zoom_out, pan_left, pan_right (still when left out; punch jumps closer on a key word), fit?: whole to show all of an image of another shape on a blurred copy of itself, prompt?: what it shows in a sentence or two (made from those words when it has no src), from?: prompt when it was made from them, make?: false to show the video's colours instead, box?: where it sits when not filling the frame, fades?: true for an image with an until to fade in and out (it is simply there when left out), turn?: degrees turned clockwise (-180 to 180), crop?: {left, top, right, bottom}: shares of the image trimmed from each side, 0 to 0.9, length?: a clip's own seconds (read from its file when a draft is saved), start?: seconds into a clip where it begins, to cut its beginning, to?: seconds into a clip where it stops, to cut it short, volume?: 0 to 1 and fade?: seconds for a clip's own sound}], words: [{id, value: the words shown, at most 200 characters, a new line where it breaks, at, until?, box: {x, y, w}: where the text box sits (a box as below; w is the width its words wrap at), font?: one of Inter Tight (Tight and even; every caption style's face.), Inter (The plainest, most legible sans; explainers and data.), Manrope (Calm, geometric and modern.), Archivo (Sturdy grotesque with real weight; news and how-tos.), Montserrat (The face most short-form captions are set in.), Poppins (Round geometric sans; friendly brands and lifestyle.), Figtree (Clean and warm, a little softer than Inter.), Bricolage Grotesque (Quirky editorial sans.), Rubik (Slightly rounded corners; playful but tidy.), Bebas Neue (Tall capitals; titles, numbers and sport.), Anton (Heavy, narrow capitals; the loudest hook text.), Oswald (Condensed, with weights; lists and labels.), League Gothic (Classic condensed gothic; posters and film titles.), Fraunces (Soft, old-style serif; warm stories.), Playfair Display (High-contrast serif; elegant titles.), Instrument Serif (Narrow editorial serif.), DM Serif Display (Bold display serif; quotes and headlines.), PT Serif (Classic text serif with italics; reports, history and quotes.), Caveat (Quick handwriting; notes and asides.), Bangers (Comic-book capitals; reactions and gaming.), Luckiest Guy (Fat cartoon capitals; kids, gaming and hooks.), JetBrains Mono (Monospace; code, terminals and numbers that line up.), weight?: 400 to 900 (the nearest the font has), italic?: true for its italics where it has them, size?: a type size, 16 to 400, pixels on a frame whose shorter side is 1080 (about 120 a title, 72 a line, 48 small print), colour?, align?: left, center, right, outline?: false for none, or {colour?, width?: 0 to 30, percent of the type size}; shadow?: false for none, or {colour?, opacity?: 0 to 100 percent, blur?: 0 to 100 and distance?: 0 to 50, percent of the type size, the shadow dropped straight down} (none and a soft shadow when left out; an outline may also be a colour alone), back?: a colour for a rounded box behind each line, in?: how it comes in, none (None: Just there.), fade (Fade: Comes up from nothing.), rise (Rise: Each word lifts into place.), slide (Slide: Slides in from the left.), pop (Pop: Springs up from small, with a little overshoot.), blur (Blur in: Each word sharpens out of a blur.), typewriter (Typewriter: Typed out, letter by letter.), wipe (Wipe: Revealed from left to right.), word_pop (Word by word: Words pop in one after another.), stomp (Stomp: Slams down from huge with a small shake.), highlighter (Highlighter: A marker swipes in behind the words.), letters (Letter cascade: Letters tumble in one by one.), count (Count up: Its numbers run up to their value.) (none when left out), out?: how it goes, none (None: Just gone.), fade (Fade out: Fades away.), sink (Sink: Each word drops away.), slide_out (Slide out: Slides off to the right.), pop_out (Pop out: Swells a touch, then shrinks to nothing.), blur_out (Blur out: Dissolves into a blur.), wipe_out (Wipe out: Wiped away from left to right.), backspace (Backspace: Deleted letter by letter from the end.) (none when left out)}]: text boxes, inside the safe area unless the person says where; words without a box are from before and sit at a place (top, middle, bottom) and come in by an animation (blur, rise, hook, pop, slide, fade, typewriter), sounds: [{id, src: a file_id, at, until?, volume 0 to 1, fade: seconds it fades in and out}]}. The script is said in one voice, scene after scene; a scene lasts its duration, at least as long as its line takes to say, and a scene with no line is a pause; a clip that begins in a scene, with no until or until the scene's end, plays from its start (or its first frame) to its own end (or its to) and the scene runs on until it does, then for its hold, and everything after moves along. A clip's sound plays, lowered while the voice speaks. Images, words and sounds each begin at their at and end at their until. A moment is {scene: id} (its start, or with end: true its end), {scene: id, word: one word of its line, nth?: 2 for its second time, end?: true when it has been said}, or {item: id of an image, words or sound, end?: true}, any of them with plus?: seconds after it (in tenths). An image with no until lasts until the next image with no until begins; a clip never shows past its own end (or its to); words on screen last for the scene they begin in; a sound lasts its own length. Where images show at the same time, a later one in images is drawn on top of an earlier one; where none shows, the video's colours. A logo, or anything else that stays on screen, is an image with a box from the first scene's start until the last scene's end, small (w about 0.18) in a top corner inside the safe area, unless the person says where. A box is {x, y, w}: its middle as shares of the frame's width and height (0.5, 0.5 is the middle; -1 to 2, so it can hang over an edge) and its width as a share of the frame's shorter side (0.02 to 10); its height follows its own shape, and what is outside the frame is not shown. Ids are short names, each used once. files?: [file_id, …]: files kept with the video and not yet placed in it, so its Media shows them when it is opened again. Files are file_ids from this workspace. |