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.
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
- Open Library → Videos.
- Click Import → Import videos and select the video.
- Review new, duplicate, and failed imports. Choose collections or tags if needed, then click Done.
- Find the imported video and check that its thumbnail and duration have loaded.
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
- On the video card, click Generate, or open Details and click Generate script. For a video with a script, open Generation options.
- 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.
- Review Output, Processing, Rhythm and the video's VR settings.
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.
- For the primary motion curve only, choose Output → Single-axis.
- To generate the primary curve and other motion axes, choose Multi-axis and check the additional component requirements.
- Under Processing, choose Local or Cloud, depending on availability.
- After switching, review Rhythm, component status, and the submit button.
How do axes and processing modes work together?
| Combination | Processing | Requirements |
|---|---|---|
| Single-axis + Local | Keeps the video on this computer and sends features online to generate the primary curve. | Available local model and eligible computer and account. |
| Single-axis + Cloud | Uploads the full video for online generation of the primary curve. | Readable video within the duration limit, plus a working upload connection. |
| Multi-axis + Local | Generates 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 + Cloud | The 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. |
View Multi-axis + Cloud settings
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 option | Behavior |
|---|---|
| Auto (default) | Detect whether the video is VR |
| On | Process as VR video |
| Off | Process 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.
- Click the Local model indicator to view the current stage.
- During download, check the component, progress, downloaded size, and any available speed or time estimate. This prepares models and runtime components, not your video.
- To pause a download, click Pause; to continue, click Resume.
- If downloading fails, read the details and click Retry. Resolve disk-space or system-check issues as directed, then click Check again.
- 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?
| Stage | What it means |
|---|---|
| Model files / GPU component | Downloads models or runtime components. This is not video-processing progress. |
| Neural Engine program | Prepares a Neural Engine program on supported Macs. Initial preparation differs from downloading a file. |
| Stroke model ready | The primary script model is available. Other components may still be installing; expand the details to check. |
| A status dot at the bottom | When 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.
What if a download pauses or a check fails?
| Status or control | Next step |
|---|---|
| Checking local model / Downloading model / Updating model | Open the progress details. Local generation may wait while the primary model updates. |
| Model download paused → Resume | Continue the existing download. Pauses persist; starting a new generation may also resume it. |
| Model download failed / Local model check failed → Retry | Read Reason, resolve the network or other reported issue, then retry. |
| Local model cannot install → Check again | Resolve the disk-space, data-folder, or other reported check, then check again. |
| Preparing Neural Engine · completed / total | This 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 activity | The 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
- Confirm the video, output axes, processing mode, Rhythm, VR, and component status.
- Click the generation button at the bottom. Its label changes with the selected operation.
- If a preparation reminder appears, review the available processing method and choose whether to continue or wait.
| Button | Operation |
|---|---|
| Generate script | Generate a primary curve for one video. |
| Generate multi-axis | Generate a new primary curve and additional axes for one video. |
| Add multi-axis | Analyze additional axes locally using an existing primary curve. |
| Generate N scripts | Submit generation tasks for the N listed videos. |
06 Track generation progress
- After submitting, open Tasks and find the video's task.
- Follow the relevant download, preparation, upload, and generation stages. The primary curve and secondary axes may finish separately.
- If you see Stroke ready · Secondary axes pending, the primary curve is ready but secondary axes are still pending.
- 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.
07 Check the script and Positions
- On the video card, click Play with script.
- Play a short section to check that video and curve advance together, then seek to other points.
- 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.
- To arrange footage by pose, open the Position picker in Mix or MV and preview its categories. See Choose Positions.
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
- Return to Library → Videos and search for the video by name.
- 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.
- To refine the result, open Edit and check the save status after editing. Use History to review available versions.
- To generate again, open the video's Generation options and choose whether to regenerate the primary curve or add motion axes.
- Export the desired script version from the editor when you need it elsewhere.
| What would you like to do next? | Related guide |
|---|---|
| Organize, find, or locate videos | Collections, tags, and notes · Locate original files |
| Edit curves, manage versions, and export | Choose an editing task · Save and export |
| Check video and script sync | Play video and script in sync |
| Connect a device for playback | Connect a device and check output |
| Arrange footage into a project | Create 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.
- Open the video's Generation options.
- Choose Regenerate stroke and read Replaces stroke · History kept.
- Check Output. Choosing Regenerate does not automatically select Single-axis.
- Review Processing, Rhythm, VR, and video duration again.
- When the task finishes, use the editor's History to check the active result and older versions, then review Positions.
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.
- Under Generation options, select Add multi-axis.
- Under Stroke source, choose an available script and confirm its current primary-curve version. This is not a general history-version picker.
- Without Selected range, analysis covers the interval between the primary curve's first and last nodes, which may be shorter than the video.
- To analyze a section, enable Selected range and enter the start and end times in From (s) and To (s).
- Check component status, range messages, and Stroke and manual tracks kept. Confirm the button reads Add multi-axis.
What range and track conditions apply?
| Requirement | Why it matters |
|---|---|
| Analyze 1 second to 3 hours at a time | Enter times in seconds. The range must fit within both the video and the existing primary curve. |
| At least one replaceable secondary track | Manual, 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 analysis | If 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
- Select videos in Library and click Generate scripts.
- Confirm the selection. VR defaults to Auto and can be changed per video.
- Choose shared Output, Processing and Rhythm.
- Check readability and duration for each video, not just the batch total.
- Confirm the video count on the submit button, then start the batch.
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
| Status | What to check |
|---|---|
| Original missing | Use Locate original to find the correct video. |
| Reading duration… | Wait for the duration to load, then check generation requirements. |
| Generation button is unavailable | Review account, local capability, and duration messages. Videos for script generation must be 60 minutes or shorter. |
| Model paused or failed | Open Local model at the bottom, read the reason, and use Resume, Retry, or Check again as appropriate. |
| Task completed but no curve appears | Check the video's linked script and version, including whether another imported script is selected. |