Generate a script

Generate a motion script and Position data, then check the timing and range against your video. Follow the steps from import to playback, or jump to regenerating, adding motion axes, or generating a batch.

Before you start

Start with a video that opens on your computer. Local generation and multi-axis analysis may need models and components on first use. If you already have a .funscript, you can import it instead.

01 Add a video to Library

  1. Open Library → Videos.
  2. Click Import → Import videos and select the video.
  3. Review new, duplicate, and failed imports. Choose collections or tags if needed, then click Done.
  4. Find the imported video and check that its thumbnail and duration have loaded.
Use Import videos for individual files, From folder for a folder, or Import script for an existing script.
Import videos entry point
Check the result
The video opens and its card shows a duration. A video without a script shows No script and a Generate button.
Do I need to generate again if I have a .funscript?

Use Import script to import it, then check the link in Script matching or the video's script selector. Importing a script does not analyze Positions; check whether pose data is already available if you need it.

02 Open generation settings

  1. On the video card, click Generate, or open Details and click Generate script. For a video with a script, open Generation options.
  2. Check the video title, thumbnail, and duration at the top of the panel. Reading duration… means the duration is still loading. If the original file is unavailable, use Locate original to locate it.
  3. Review Output, Processing, Rhythm and the video's VR settings.
Generation settings stay beside the selected video. This example shows Regenerate stroke with Multi-axis, Local, and Exact selected.
Complete generation panel beside the selected video, including VR, output axes, processing, rhythm, and the Generate button
Check the result
Confirm the intended video is selected, the source is readable, and the duration has loaded.

03 Choose generation settings

For a first run, choose Single-axis, leave VR on Auto, and choose your processing mode and rhythm.

Output and Processing

New generation and Regenerate stroke offer these settings. Add multi-axis runs additional-axis analysis locally and does not use the same Local / Cloud selection flow.

  1. For the primary motion curve only, choose Output → Single-axis.
  2. To generate the primary curve and other motion axes, choose Multi-axis and check the additional component requirements.
  3. Under Processing, choose Local or Cloud, depending on availability.
  4. After switching, review Rhythm, component status, and the submit button.
How do axes and processing modes work together?
CombinationProcessingRequirements
Single-axis + LocalKeeps the video on this computer and sends features online to generate the primary curve.Available local model and eligible computer and account.
Single-axis + CloudUploads the full video for online generation of the primary curve.Readable video within the duration limit, plus a working upload connection.
Multi-axis + LocalGenerates the primary curve using local and online processing; analyzes secondary axes on this computer.Both the primary model and multi-axis components must meet their requirements.
Multi-axis + CloudThe interface shows Video uploaded · Secondary axes run here.: video processing is uploaded, while secondary axes still run on this computer.In addition to upload requirements, check local multi-axis support and components.
Local keeps the original video on this computer. Exact is selected.
Local generation settings with Single-axis and Exact selected
Cloud uploads the video and offers the same rhythm options as Local.
Cloud generation settings offering Gentle, Exact, and Intense
View Multi-axis + Cloud settings
Secondary axes still run locally with Multi-axis + Cloud and need the appropriate components.
Multi-axis + Cloud with the first-use component download notice

Local generation still needs an internet connection. The original video stays here, but analysis features are sent online. Stay signed in and connected.

What if Processing is disabled or the capability check fails?

Read the reason beside the option. If you see Could not check local generation, use Retry capability check to check again. Switching to Cloud does not bypass local requirements for secondary axes.

Rhythm and VR

Local and Cloud both offer Gentle, Exact, Intense. Choose a gentler rhythm, the model's original result, or a more intense rhythm.

Exact keeps the model's original rhythm. Preview the result after generation and refine it in the editor if needed.

VR defaults to Auto, so Peakron detects whether the video is VR. Choose On or Off when you need to specify it yourself.

VR optionBehavior
Auto (default)Detect whether the video is VR
OnProcess as VR video
OffProcess as standard video

04 Download models and prepare components

Follow this step for Local generation. Cloud single-axis generation can proceed with cloud settings; multi-axis tasks also need local components.

Local models may download in the background before you click Generate script. Check progress from the Local model indicator at the bottom of the window.

  1. Click the Local model indicator to view the current stage.
  2. During download, check the component, progress, downloaded size, and any available speed or time estimate. This prepares models and runtime components, not your video.
  3. To pause a download, click Pause; to continue, click Resume.
  4. If downloading fails, read the details and click Retry. Resolve disk-space or system-check issues as directed, then click Check again.
  5. When the model is available, return to generation settings and check Local. If other components are still preparing, follow the interface to see whether you can start.
What is being prepared?
StageWhat it means
Model files / GPU componentDownloads models or runtime components. This is not video-processing progress.
Neural Engine programPrepares a Neural Engine program on supported Macs. Initial preparation differs from downloading a file.
Stroke model readyThe primary script model is available. Other components may still be installing; expand the details to check.
A status dot at the bottomWhen nothing needs attention, the indicator may shrink to a dot. Click it to view the model version, disk usage, and current engine.

Models are reused across videos. Resuming a paused download keeps its progress; updates or additional components may require downloads later. On a Mac, Neural Engine preparation is not a generation failure if the interface says GPU processing is available.

Open these details after setup to check the version, storage, and engine. During download, they show the current step and progress.
Local model details showing version, disk usage, and current engine
What if a download pauses or a check fails?
Status or controlNext step
Checking local model / Downloading model / Updating modelOpen the progress details. Local generation may wait while the primary model updates.
Model download paused → ResumeContinue the existing download. Pauses persist; starting a new generation may also resume it.
Model download failed / Local model check failed → RetryRead Reason, resolve the network or other reported issue, then retry.
Local model cannot install → Check againResolve the disk-space, data-folder, or other reported check, then check again.
Preparing Neural Engine · completed / totalThis prepares a local program on supported Macs rather than downloading a file. Keep Peakron open and follow its progress.
Stroke model ready with background component activityThe primary model is available, but extra components may still be downloading or preparing. Check which ones your task needs.
Can I start while Neural Engine is preparing?

Some local generation can use the GPU while the Neural Engine is preparing. If the reminder appears, choose Later to wait without submitting, or Generate now to start with the available engine. Check the video and settings before continuing. Don't remind me again only hides this reminder; it does not speed up preparation.

What do Checking, cached, and failed mean for multi-axis components?

Checking multi-axis… checks multi-axis support; Checking components checks the required components. First use · … download shows the first-use download size; Components cached · Ready to prepare means files are cached but still need preparation; Analysis ready means the analysis components are ready. If a check fails, use Recheck components. If the panel lets you continue, Tasks still needs to download and verify components. A failed check does not confirm installation.

05 Start generation

  1. Confirm the video, output axes, processing mode, Rhythm, VR, and component status.
  2. Click the generation button at the bottom. Its label changes with the selected operation.
  3. If a preparation reminder appears, review the available processing method and choose whether to continue or wait.
ButtonOperation
Generate scriptGenerate a primary curve for one video.
Generate multi-axisGenerate a new primary curve and additional axes for one video.
Add multi-axisAnalyze additional axes locally using an existing primary curve.
Generate N scriptsSubmit generation tasks for the N listed videos.
Check the result
After submitting, look for the video's task or processing status. If the button is disabled, resolve the account, component, or duration message first.

06 Track generation progress

  1. After submitting, open Tasks and find the video's task.
  2. Follow the relevant download, preparation, upload, and generation stages. The primary curve and secondary axes may finish separately.
  3. If you see Stroke ready · Secondary axes pending, the primary curve is ready but secondary axes are still pending.
  4. When the task finishes, check the video's tracks and versions, then preview playback.
What does Queued after the current task mean?

If the video already has a preparing, uploading, generating, or paused task, a new task may queue behind it. Submitting again adds work rather than speeding up the original. Check Tasks and use the existing task's Retry when appropriate.

If the page fails to refresh after submission, check Tasks first. Before changing settings, confirm the original task's state, then cancel or regenerate as needed.

How do Pause, Resume, Retry, and Cancel work?

Pause appears only during supported stages, such as uploads or secondary-axis component downloads. Pausing a shared download may affect other waiting tasks. Continue with Resume as shown; a task paused for a specific reason may offer Retry. Read errors and restore missing prerequisites, such as source files, before retrying.

Cancel affects the selected active generation task; it does not uninstall models. Pause or resume primary-model downloads from Local model at the bottom. Canceling a task does not remove downloaded components.

What if submission fails?

If Could not submit generation appears, read the error and use Retry generation. If the account or Library changed, reopen the panel and confirm the video. Once a task appears in Tasks, handle its failures there instead.

Check the result
Confirm completion in Tasks and check the script linked to the video. A finished model download or accepted submission does not mean the script is ready.

07 Check the script and Positions

  1. On the video card, click Play with script.
  2. Play a short section to check that video and curve advance together, then seek to other points.
  3. To inspect or edit the curve, click Edit and confirm the linked script and active version. Check each generated axis. After adding axes, verify that the primary curve, manual tracks, and content outside the analysis range remain intact.
  4. To arrange footage by pose, open the Position picker in Mix or MV and preview its categories. See Choose Positions.
The Preview area shows the script tracks. Check that footage and curves advance together during playback.
Play with script showing video and script tracks
Two results with different uses

Peakron generates Position data alongside the funscript. The script describes motion timing and range; Positions label footage by pose so you can choose categories in Mix and MV.

Add multi-axis uses existing Position data to help analyze motion; it does not classify poses again. After regenerating the primary curve, check the returned categories and footage. If no categories are returned, do not assume the old Positions remain.

Find your results in Library

  1. Return to Library → Videos and search for the video by name.
  2. Add it to a collection or use tags to make it easier to find. Start with a small set of videos as you organize your library.
  3. To refine the result, open Edit and check the save status after editing. Use History to review available versions.
  4. To generate again, open the video's Generation options and choose whether to regenerate the primary curve or add motion axes.
  5. Export the desired script version from the editor when you need it elsewhere.
Return to a video and script by name, collection, or tag.
Searching Library for a video and its linked script
What would you like to do next?Related guide
Organize, find, or locate videosCollections, tags, and notes · Locate original files
Edit curves, manage versions, and exportChoose an editing task · Save and export
Check video and script syncPlay video and script in sync
Connect a device for playbackConnect a device and check output
Arrange footage into a projectCreate a Mix · Create a Music Video

Regenerate a script

With a usable primary curve, the panel may default to Add multi-axis. To replace that curve, switch to Regenerate stroke.

  1. Open the video's Generation options.
  2. Choose Regenerate stroke and read Replaces stroke · History kept.
  3. Check Output. Choosing Regenerate does not automatically select Single-axis.
  4. Review Processing, Rhythm, VR, and video duration again.
  5. When the task finishes, use the editor's History to check the active result and older versions, then review Positions.
Regeneration updates the current primary curve. Older versions remain available in History.
Regenerate stroke with output, processing, and rhythm settings

Regenerate updates the script linked to this video. It does not use the Add workflow's Stroke source to pick an arbitrary history version. Returned tracks are updated and history is retained. Keeping primary and manual tracks is an Add multi-axis rule; it does not mean Regenerate leaves all edits or drafts untouched.

Want to keep the curve and only add axes?

Choose Add multi-axis. If you do regenerate, save edits you want to keep and retain a version in History or an exported file. Check the active tracks afterward rather than relying only on "History kept."

Add axes to an existing script

The primary curve is the L0 track. Additional-axis analysis uses it as its basis. Choose the curve first, then the analysis range.

This local workflow handles one video. It needs that video's enabled L0 track, an active version without unsaved edits, and at least one second of motion.

  1. Under Generation options, select Add multi-axis.
  2. Under Stroke source, choose an available script and confirm its current primary-curve version. This is not a general history-version picker.
  3. Without Selected range, analysis covers the interval between the primary curve's first and last nodes, which may be shorter than the video.
  4. To analyze a section, enable Selected range and enter the start and end times in From (s) and To (s).
  5. Check component status, range messages, and Stroke and manual tracks kept. Confirm the button reads Add multi-axis.
This example keeps the primary curve and analyzes only 2–10 seconds for additional axes.
Add multi-axis with Selected range set to 2–10 seconds, keeping primary and manual tracks
What range and track conditions apply?
RequirementWhy it matters
Analyze 1 second to 3 hours at a timeEnter times in seconds. The range must fit within both the video and the existing primary curve.
At least one replaceable secondary trackManual, imported, disabled, and unsaved-draft tracks are protected. Analysis cannot proceed if every target axis is protected.
Keep the source curve and target-track state unchanged during analysisIf the basis changes, a conflict preserves your edits. A conflict does not mean new tracks were successfully applied.

Replaceable generated tracks update within the analysis range and retain nodes outside it. Add multi-axis keeps the primary curve and uses existing Position data; it does not generate new Positions.

Why is Stroke source unavailable, or why can't I submit a range?

Check that the script belongs to this video, L0 is enabled with an active version, and unsaved edits are resolved. Empty or sub-second curves cannot be used. Keep the range between the first and last primary nodes. If every secondary track is protected, review which tracks you intend to regenerate.

Generate scripts in a batch

  1. Select videos in Library and click Generate scripts.
  2. Confirm the selection. VR defaults to Auto and can be changed per video.
  3. Choose shared Output, Processing and Rhythm.
  4. Check readability and duration for each video, not just the batch total.
  5. Confirm the video count on the submit button, then start the batch.
The upper batch panel lets you review each video and its VR setting.
Batch panel listing Sofia, Ciara, and Gabby with individual VR settings
Scroll down to choose output axes, processing, and rhythm for the batch.
Shared Output, Processing, and Rhythm settings farther down the batch panel
What limits apply to batches and existing scripts?

A batch can contain up to 100 unique videos. New generation or regeneration supports videos up to 60 minutes each in Local and Cloud; the limit is per video, not the batch total. Split longer videos outside Peakron before importing. Output, processing, and rhythm are shared; VR is per video. Adding axes to existing curves currently requires individual tasks.

Troubleshooting

StatusWhat to check
Original missingUse Locate original to find the correct video.
Reading duration…Wait for the duration to load, then check generation requirements.
Generation button is unavailableReview account, local capability, and duration messages. Videos for script generation must be 60 minutes or shorter.
Model paused or failedOpen Local model at the bottom, read the reason, and use Resume, Retry, or Check again as appropriate.
Task completed but no curve appearsCheck the video's linked script and version, including whether another imported script is selected.
Next: Edit a script →