Repository navigation
v0.8.0
Experimental: make a recap like a reference reel. --recap_like REFERENCE (a link such as YouTube, or a video file) and the "Make the whole recap like this reel" box on the Recap screen read a reference reel's pace, picture shape, text layout (a "DAY N" label over each shot, a headline opening, the ending), label colour, size and lettering, and set the recap's options for you (anything you set yourself wins). It has been tried on one reference, so expect to adjust. To read the text it needs a picture reader: Gemini with your key (the reel's frames are sent to Google) or a local Ollama vision model; without one only pace, shape and length are copied. It approximates the look with the fonts that ship with ShortsFlow (it cannot copy an exact font) and never reuses the reference's footage, music or graphics. New options it uses: --recap_itinerary (an itinerary reel: "DAY 2" above the place name, straight cuts, a tiered opening headline, a soft dark band behind labels), --recap_text_style (colour, size, bold, glow), --recap_font display (a heavy display serif, Abril Fatface, SIL Open Font Licence) and --layout crop for recaps.
-
Recap: "Let me review the shots first" (
--recap_plan_only, then--recap_moments): the shot picked for each day is shown with a preview in the final shape; swap it for an alternative, trim it or drop it before anything is rendered. An itinerary reel picks each day's most scenic shot. -
Style cloning (
--clone_style, "Copy the style of a reel"): the reference can be a link as well as a file. -
Recap and Clip tool Auto-edit lists include the templates saved or cloned since the app started; saved templates keep their text boxes; the browser app can join the shorts into one video (
--join_reel). -
Failed runs now say the likely cause in plain words (FFmpeg or Node missing, graphics card busy, speech model download, full disk, blocked link).
-
Facts videos no longer repeat: the last 40 hooks and facts go into the prompt as "do not repeat" (history kept between daily runs by the workflow cache).
-
Recap review: rendering the reviewed shots no longer picks shots again (it was slow and used the vision model), and the reviewed files match whatever the slash style. FFmpeg and the other helper programs the recap starts no longer flash a console window on Windows.
-
The transcript cache keeps the newest 200 transcripts (older cache files are removed). Fixed: Stop then Continue re-cut every piece; a reviewed plan lost its titles and warnings at render; the continue-a-run list only accepts a run's own
command.jsoninsidesessions/; the cut-piece cache key now covers grade, HQ, superres, filler file and crop points, and finished clips have a key too. -
Style cloning:
--clone_style REFERENCE --save_as NAME(and "Copy the style of a reel" on Start here) measures a reference reel on this PC (shot length from the cuts, colour, loudness) and saves a template; pauses, filler cuts, punch-in zooms and cutaway pictures are inferred from the pace and the summary says which parts were measured and which were guessed. Captions, graphics, music and the reel's footage are not copied. Use it with--auto_edit NAME. -
Browser app: "Save these settings as my template" on Start here keeps the chosen Auto-edit style, caption style, extras, colour grade, visual template and covers under a name (a JSON file in
~/.shortsflow/templates/); it shows up in the Auto-edit list straight away and as--auto_edit NAMEon the command line. -
Seven new caption styles (
--caption_style): MARKER (highlighter sweep), SOFT (clean words fading in), WORDCUT (words cut in), NEGATIVE (keyword in a muted tone), HANDWRITTEN (script with an underline), SIMPLE (tall plain capitals) and TYPEWRITER (typed letter by letter). Each has a preview picture in the browser app's picker. Fonts Caveat and JetBrains Mono (SIL OFL) are bundled. -
Known issue, not fixed: the bundled caption fonts (Anton, Noto Sans for Cyrillic, Devanagari and Arabic) are never loaded, because
remotion-video/package.jsontells the bundler that only CSS files have side effects and it dropsimport "./fonts". Captions use the machine's own fonts. Turning the import on stalled a browser tab in the E2E render on GitHub's runner, so it is left off until it can be tested there. Caveat and JetBrains Mono (the two new styles) are loaded only when their style is used. -
Fixed: the letterbox check could report an impossible crop window (for example negative sizes on a video that starts black), which made FFmpeg fail on every clip that used the plain face crop: those clips were dropped silently. Such a window is now ignored, a clip cut that fails on the GPU encoder is retried once on the CPU, and any cut that still fails is reported.
-
Browser app redesign: one "What do you want to make?" chooser with icon cards (Shorts, Highlights, Dub, Recap, Photo reel, Idea, Clip tool) instead of tabs, a video-kind picker that sets the moment picking, edit style, framing and captions in one choice, a plain "Picture in the tall frame" choice (automatic, crop, fit), everything else under one Advanced section, a progress view (stages, bar, listening and rendering percent, elapsed time), "Your projects" tiles with thumbnails of earlier runs, and a primary button that stays in view. Checked at phone width, in light and dark mode, with keyboard-only use and for text contrast.
-
Review the moments first:
--plan_onlywrites the chosen moments toplan.jsonwithout rendering, and the browser app shows them with a playable preview in the shape of the final short, a timeline, nudges, your own extra moments and a Render button.--only_between START-ENDlimits the search to a part of a long video. -
--auto_edit autopicks the edit style from the file name,--user_contextand the video length, and prints why and the runner-up. -
Videos and photos already on this PC are used in place: the link boxes accept a file path, Recap accepts folder paths (each day folder stays a day), Photo reel accepts a photo folder, and Browse buttons open the system file or folder dialog. When the app is opened from another device (
--host 0.0.0.0or--share), paths and Browse dialogs are switched off for visitors; uploads and web links still work. -
Recaps:
--recap_font handwritten, and a visual template with intro and outro covers laid over every finished recap (portrait and landscape); the template text boxes are worded for a trip. -
Game footage: on Automatic the review shows the picture the tool will use and the render uses the same decision.
-
Fixed: a cut piece (
temp_segments/seg_N.mp4) was reused by its number, so a rerun with other moments or another framing could use old footage (wrong clip, old bars). A piece is now reused only when its source, moment and settings match; a finished clip only when it is newer than its piece. -
Fixed: ticking "game footage" forced the fit layout, so "Fill the screen (crop)" was ignored.
-
The transcript of a video is kept once on this PC (
~/.shortsflow/cache/transcripts,SHORTSFLOW_TRANSCRIPT_CACHE=offturns it off), so the same video is not transcribed again in every new run. -
Fixed: a Gemini model that did not answer in time was retried four times on each of four models (up to 300 s per try), which could hold a run for tens of minutes. A timeout now moves on to the next model, and the optional video outline waits at most 40 s per try.
-
Game footage with
--visual_context: a moment that looks like real filmed footage (a just-chatting part of a stream recording, for example) is flagged in the plan and on the review card instead of passing as a story moment. It is only flagged, never removed. -
--join_reel(shorts): after the clips are made, they are also joined into one video,reel_joined.mp4in the session folder, with crossfades or the look chosen with--transitions. The shorts stay as they are. This is the vertical counterpart of the highlights video, which was landscape only. -
Browser app: the Stop button only shows while a run is going, and light mode has a warm page behind white cards so the sections stand out (dark mode unchanged).
-
A project logo (one wide bar over three tall bars: a long video becoming shorts) in the browser app header and tab icon, the README, the website and a social preview card (
assets/branding/).