v0.2.1 Python 3.12+ MIT License CLI

Vidius: Professional CLI for Google Vertex AI Veo Video Generation

A high-performance command-line tool for generating and extending high-definition videos with Google Veo 3.1 models (standard, fast, lite) via Vertex AI or the Gemini Developer API.

uv tool install --python 3.12 git+https://github.com/charles-forsyth/vidius.git

View Repository Explore Terminal Output

Key Capabilities

Designed and tuned for modern terminal workflows and automated pipelines.

✨

Veo 3.1 Model Tiers

Direct access to Veo 3.1 Standard, Fast, and Lite tiers with duration, aspect ratio, and audio controls.

✨

Image-to-Video & Morphing

Animate still images or interpolate smoothly between starting and ending frames for morphing transitions.

✨

Multi-Reference Images

Supply up to 3 reference images to maintain character appearance and visual style across shots.

✨

Video Extension

Extend previously generated Veo videos seamlessly for continuous long-form storytelling.

Terminal Showcase

Real, unmodified terminal outputs captured directly from the CLI engine.

vidius --help

Usage Examples

Quick command recipes for terminal operations.

Text-to-Video Prompt

Generate 8-second 16:9 video with synchronized audio:

vidius "A cinematic drone shot over coastal mountains at sunrise"

Frame Interpolation

Interpolate between start and end frames:

vidius "A flower blooming" --image bud.png --last-image flower.png

Character Style Transfer

Reference character sheet with Lite tier:

vidius "A knight in armor" --ref-image character_sheet.png -m lite

Vertical Reel / Short

Generate 6-second vertical 9:16 clip:

vidius "A dancer on stage" -ar 9:16 -d 6

Citation

If you use this tool in your research or applications, please cite:

Forsyth, C. E. III (2026). Vidius: Veo 3.1 Video Generation CLI (Version 0.2.1) [Computer software]. University of California, Riverside. https://doi.org/10.5281/zenodo.23755681

@software{forsyth2026vidius,
  author       = {Forsyth, Charles E. III},
  title        = {Vidius: Veo 3.1 Video Generation CLI},
  version      = {0.2.1},
  year         = {2026},
  publisher    = {Zenodo},
  affiliation  = {University of California, Riverside},
  doi          = {10.5281/zenodo.23755681},
  url          = {https://github.com/charles-forsyth/vidius}
}