Repository navigation
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