Repository navigation
Releases
takeone v0.6.0
TakeOne 0.6.0
What is new since 0.5.3
- Motion films use the pinned Open Design branding.
takeone record --flow FILEdrives an app flow from a flow file while the recorder films it, with no one at the keyboard.- The glow recipe honours
--aspect, with a portrait layout.
takeone v0.5.3
TakeOne 0.5.3
What is new since 0.5.2
- TakeOne no longer runs without an AI engine.
- Temporary-folder cleanup reports a full temporary quota in plain words.
- A worker chunk start keeps its text, guarded by a suite check.
takeone v0.5.2
TakeOne 0.5.2
Install TakeOne with npm install -g takeone-axi, or from this release:
npm install -g --allow-remote=all https://github.com/umeranjum17/takeone/releases/latest/download/takeone.tgz
takeone doctor
0.5.2 is the first build of the 0.5 line on npm. The 0.5.0 tag run failed on a build error, and the 0.5.1 npm publish was rejected because package.json had no repository field, which provenance checks require. This release adds it and changes nothing else, so everything in the 0.5.0 and 0.5.1 notes ships here.
What is new since 0.5.1
- npm publish.
package.jsonnow names the repository, so the provenance-signed publish to npm is accepted.
Test these first
npm install -g takeone-axithentakeone --versionprints 0.5.2, andtakeone doctorpasses.npm view takeone-axi repository.urlprints the GitHub repository.
takeone v0.5.1
TakeOne 0.5.1
Install TakeOne with npm install -g takeone-axi, or from this release:
npm install -g --allow-remote=all https://github.com/umeranjum17/takeone/releases/latest/download/takeone.tgz
takeone doctor
0.5.1 is the first build of the 0.5 line on npm. The 0.5.0 tag run failed on a build error and never published, so everything in the 0.5.0 notes ships here too, plus the changes below.
What is new since 0.5.0
- Launch reels. Five more motion patterns and the launch, feature, social and compare recipes, in landscape and portrait. A reflowing bento launch reel is made from one screen and a pitch.
- Model-made segments. Segments the model makes are recorded beside the real screen capture.
- Faster preview. The camera solve is cached, so a repeat preview or render skips it. Preview shows cold and warm timing, and captioned-take band rows are fixed.
- Look. The stage is a near-black field with a soft accent glow that does not band.
- Film gates. Motion films are gated on frozen time and audio loudness; motion-video-kit is attributed.
- Release. The npm publish job gates on build and typecheck, not the full suite.
Test these first
npm install -g takeone-axithentakeone --versionprints 0.5.1, andtakeone doctorpasses.takeone motion <screenshot> --recipe launch --pitch "..."and check the bento reel in landscape and portrait.- Run the same preview twice and confirm the second is faster (cached camera solve).
takeone v0.5.0
TakeOne 0.5.0
Install TakeOne with npm install -g takeone-axi, or from this release:
npm install -g --allow-remote=all https://github.com/umeranjum17/takeone/releases/latest/download/takeone.tgz
takeone doctor
What is new
- Sound in the film. Click ticks, narration and music that ducks under the voice are mixed into rendered films.
- Alpha export.
--alphawrites ProRes 4444 motion films with a real alpha channel. GIF output now steps size and frame rate down to stay bounded. - Smoothness matrix.
scripts/verification/smooth-matrix.tsrenders every source at every export shape and measures the absolute smoothness bars;docs/quality.mdrecords the 14-cell result. - Editorial launch film.
takeone motion <screenshot> --recipe editorial --pitch TEXTlets the signed-in engine plan the copy and beats. With no engine it exits 3 with the sign-in line. - Captions and labels. AI captions are held to their reading time. The planner chooses spotlight, keycaps and click rings. Labels stay off the page text they would cover.
- Camera. Manual zooms now move the camera on every export shape. Tapped controls are framed in portrait and wide phone exports.
- Cleaner frames. Titles and captions stay in the band in every export shape. Zoomed text stays clean. Launch films no longer clip words, show blank edges or hold dead air.
- Score loop. Each improvement is checked against the solved film, and the loop stops when no gain is left.
- Screenshot privacy. Sensitive screenshot masks can be inspected locally before image planning.
- Engine first. Default planning now requires a discovered engine and refuses early without one.
Test these first
takeone motion <screenshot> --recipe editorial --pitch "..."and check the film's sound: click ticks, narration, and music ducking under the voice.- Export the same motion film with
--alphaand open the ProRes 4444 file over a coloured background to confirm the transparency. - Render one take portrait, square and 16:9, and check that titles and captions sit in the band and the tapped control stays in frame.
takeone v0.4.0
TakeOne 0.4.0
Install TakeOne with npm install -g takeone-axi.
- Motion films use the HyperFrames engine by default; install its pinned runtime with
takeone motion install-hyperframes. takeone make --target-scoreand--max-roundsscore films and iterate within a bounded number of rounds. The default judge is Haiku.- Launch-film camera motion and cut-ready scene exports make motion films easier to review and edit.
takeone v0.2.1
Install
Needs Node.js 22.19 or newer and ffmpeg on PATH.
npm install -g --allow-remote=all https://github.com/umeranjum17/takeone/releases/latest/download/takeone.tgz
takeone doctorNew
- Run
takeone --versionto see the installed version.
Known issues
- Signed-in Claude paths that skip a login made with an API key, Bedrock or Vertex, and the stop on a lapsed subscription, are tested against fakes only. They have not run against a real Bedrock or Vertex login or a real lapsed subscription.
- The camera can still cut text while it moves slowly, for example during the follow and drag eases.
- Desktop recording on Linux works on Wayland with Hyprland only. macOS desktop recording is the preview above.
- iOS recording works with the iOS Simulator only, not a real iPhone.
- Videos are silent: there is no audio track.
takeone v0.2.0
The planner is now AI-first, can use an AI account you are already signed in to, and a plan edit follows its beat when the take is cut again.
Install
Needs Node.js 22.19 or newer and ffmpeg on PATH.
npm install -g --allow-remote=all https://github.com/umeranjum17/takeone/releases/latest/download/takeone.tgz
takeone doctorNew
- AI plans the film. The planner decides at each beat which camera rule applies, in batches, and picks a theme, pace, opening, ending and camera style for the whole take. A
--setkey, an explicit--themeor a saved theme still wins over its choice. It also writes an AI title and a caption for each beat. - A long take now gets a film. It is planned in ordered chunks instead of falling back to the base look.
- Plan with an AI account you already have. With no saved planner choice, takeone looks for an installed, signed-in Claude or Codex CLI, then a signed-in ChatGPT or OpenCode Go plan, then a stored key. You can also plan with an installed
piCLI. takeone stores no key of its own for these routes; see discovery order. - A signed-in CLI that refuses stops
takeone makewith exit 3, names the sign-in and the check to run, and renders nothing, instead of quietly falling back. - Edit the plan per beat.
analysis/plan.jsonlists each beat'sshot,idleandfollowchoice; a value you set is kept and applied on render. Each entry has a stablekey, so an edit follows its beat when the take is cut again, an edit whose beat is gone is reported as dropped, and an entry carrying another beat's key is refused. - A plan edit the render cannot honour now stops with one error naming the beat, its kind and the value, instead of being dropped silently.
takeone render <take> --previewrenders the same film at about 480p and 30 fps with no motion blur, for a quick look at a theme, aspect or--setchange. The 1080p proxy it needs is made once beside the take.- Screenshot films can be planned locally while AI image planning is off.
TAKEONE_RENDER_THREADS=<n>holds a render or export to a fixed ffmpeg thread count.- macOS desktop recording preview: video only, through ScreenCaptureKit with a one-time Screen Recording approval, and
takeone doctorreports the grant. It was built on Linux and has not been run on a Mac.
Improved
- The default frame has a blue-to-violet backdrop and a softer shadow, and the drawn cursor is larger and smoother.
- The title band is more compact in landscape and keeps the text-safe inset.
- The camera holds a crop that cuts no text when it comes to rest, and eases the drag and the follow release more calmly.
- Blurred wide camera renders are faster.
- Android recordings: the immersive-mode confirmation is documented and automated.
Known issues
- Signed-in Claude paths that skip a login made with an API key, Bedrock or Vertex, and the stop on a lapsed subscription, are tested against fakes only. They have not run against a real Bedrock or Vertex login or a real lapsed subscription.
- The camera can still cut text while it moves slowly, for example during the follow and drag eases.
- Desktop recording on Linux works on Wayland with Hyprland only. macOS desktop recording is the preview above.
- iOS recording works with the iOS Simulator only, not a real iPhone.
- Videos are silent: there is no audio track.
Guide: https://github.com/umeranjum17/takeone/blob/main/docs/guide.md
takeone v0.1.2
Third tester build: takeone doctor no longer reports a failed install when only optional checks are missing.
Install
Needs Node.js 22.19 or newer and ffmpeg on PATH.
npm install -g --allow-remote=all https://github.com/umeranjum17/takeone/releases/latest/download/takeone.tgz
takeone doctorFixed
takeone doctorexits 0 when only optional checks are false, such as no AI key set. It exits 1 only when a check every capture route needs fails: ffmpeg, the state dir or the takes root.- Each doctor row names the capture route that needs it in
needed_by, so you can see which rows matter for the route you are using.
Known issues
- Desktop recording works on Linux only (Wayland with Hyprland). macOS desktop capture is not supported yet.
- iOS recording works with the iOS Simulator only, not a real iPhone.
- Videos are silent: there is no audio track.
Guide: https://github.com/umeranjum17/takeone/blob/main/docs/guide.md
takeone v0.1.1
Second tester build: the install, render and recording fixes from the first tester pass.
Install
Needs Node.js 22.19 or newer and ffmpeg on PATH.
npm install -g --allow-remote=all https://github.com/umeranjum17/takeone/releases/latest/download/takeone.tgz
takeone doctorFixed
- An isolated install no longer reads the host keyring: set
TAKEONE_NO_KEYRING=1and takeone stays off the OS keyring entirely. - Films render as parallel time segments instead of one long pass, and rendering no longer hangs on sources with no zoom headroom (for example a 1080p source in a 4:5 export).
- The text guard now also covers recordings that end before the take does, so the last frame is still checked.
take.jsonrecords takeone's real package version, so takes made with different builds are distinguishable.- README and guide close the Linux, iOS Simulator and Android install gaps from the first pass.
Known issues
- Desktop recording works on Linux only (Wayland with Hyprland). macOS desktop capture is not supported yet.
- iOS recording works with the iOS Simulator only, not a real iPhone.
- Videos are silent: there is no audio track.
Guide: https://github.com/umeranjum17/takeone/blob/main/docs/guide.md