Vivipilot documentation

The practical path from a blank project to an editable composition, a connected Desktop app and a finished export.

Last updated August 26, 2026

Create your first project

Choose a frame, describe the motion and learn how Vivipilot structures the result.

Set up Desktop

Install on macOS, Windows (Microsoft Store), or Linux and choose between BYOK and Vivipilot Agent.

Connect Cloud

Pair Desktop, understand device limits and sync a paid workspace.

Edit a composition

Work with scenes, the timeline, selectable elements and focused Agent revisions.

Export

Choose a supported resolution, frame rate and transparent format for your plan.

Create your first project

  1. Open Cloud Studio or Vivipilot Desktop and choose a project frame.
  2. Describe the subject, intended audience, visual style and the message the animation should communicate.
  3. Review the generated scenes, then select a scene or element before requesting a focused revision.
  4. Preview the full timeline and export only after the timing and project frame are correct.

Set up Desktop

For macOS, download the signed and notarized Apple silicon or Intel DMG from the Desktop page. For Windows, get Vivipilot Desktop from the Microsoft Store (Product ID: 9NQBG8L1762K). Linux packages are on the same Desktop page. Vivipilot Desktop is free and requires BYOK for AI generation: add a supported provider in Settings and keep the project local. Paid users can instead connect their Vivipilot account and select Vivipilot Agent.

On an x86_64 Linux computer, install the latest release with:

curl -fsSL https://downloads.vivipilot.com/install.sh | sh

Supported BYOK providers: OpenRouter, OpenAI, Anthropic Claude, Google Gemini, Ollama and OpenAI-compatible APIs such as LM Studio or vLLM. Provider API billing is separate from consumer chat subscriptions.

Free Desktop has no Cloud or device sync and exports up to 720p at 30 FPS. Your plan determines higher export, storage, history and device limits.

Connect Desktop to Cloud

  1. In Desktop, open Settings and choose Connect to Vivipilot Cloud.
  2. Copy the displayed pairing code.
  3. Sign in at vivipilot.com/desktop/connect, enter the code and approve the device.
  4. Return to Desktop and choose Vivipilot Agent or BYOK from the Agent selector.

If the device limit is full, open account settings, disconnect an old device and repeat the connection.

Edit a composition

Canvas

Select visible elements and adjust their content or layout without rebuilding the scene.

Timeline

Change scene order and duration, then preview transitions at the playhead.

Agent revisions

Select the smallest relevant scope and describe the change you want.

Version history

Paid Cloud plans retain revision history according to the plan. Desktop keeps local project files.

Export

Open Export, choose a resolution and frame rate allowed by the current plan, then confirm the project aspect ratio and duration. Use MP4/H.264 for ordinary playback. Use WebM with alpha or ProRes 4444 only when you need a transparent video and your plan supports it.

Compare export limits →