Package Exports

videoforge
videoforge/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (videoforge) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🎬 VideoForge — AI Video Generator CLI

Multi-provider AI video generation from your terminal.

5 Providers: Runway, fal.ai, Replicate, Google Veo, OpenAI Sora
Text-to-Video: Generate videos from text prompts
Image-to-Video: Animate still images into video clips
15 Style Presets: cinematic, animation, vfx, anime, pixel-art, glitch...
11 Resolution Presets: 480p → 4K, phone, tiktok, youtube, story...
Batch Processing: Generate multiple videos from YAML config
Templates: Save prompts with {variables} for repeatable generation
Cost Tracking: Per-provider spending summaries
History: Full generation log with search

Quick Start

npm install -g videoforge

# Configure a provider
videoforge config set runway.apiKey "your-key"

# Generate a video
videoforge gen "a cat walking across a sunlit room"

# Generate with a style preset
videoforge gen "ocean waves crashing" --preset cinematic --resolution 1080p

# Animate an image
videoforge animate input.png "zoom in slowly with parallax"

# Compare providers
videoforge compare "a rocket launching into space"

Commands

Generate Video

videoforge generate <prompt>          # (alias: gen, g)
  -p, --provider <name>              # runway, fal, replicate, veo, sora
  -m, --model <model>                # Specific model
  -d, --duration <seconds>           # Video duration
  -R, --resolution <preset>          # 480p, 720p, 1080p, 4k, phone, tiktok...
  -f, --fps <number>                 # Frames per second
  --format <type>                    # mp4, webm (default: mp4)
  -n, --count <N>                    # Number of videos
  -s, --preset <style>               # Style preset
  -t, --template <name>              # Use saved prompt template
  -v, --var <key=value>              # Template variable (repeatable)
  --negative <prompt>                # Negative prompt
  --seed <number>                    # Seed for reproducibility
  --quality <1-100>                  # Quality (default: 80)
  -o, --output <path>                # Output file path
  --open                             # Open video after generation

Animate Image

videoforge animate <image> [prompt]   # (alias: anim, a)
  -p, --provider <name>              # Provider to use
  -d, --duration <seconds>           # Video duration
  -R, --resolution <preset>          # Resolution preset
  --format <type>                    # Output format
  -o, --output <path>                # Output file path
  --open                             # Open after generation

Other Commands

videoforge compare <prompt>           # Compare across providers
videoforge batch <file.yaml>          # Batch generate from YAML/JSON
videoforge convert <input> --to webm  # Convert format (requires ffmpeg)
videoforge providers list             # List all providers
videoforge history list               # View generation history
videoforge template save <n> <p>      # Save prompt template
videoforge cost summary               # Spending summary
videoforge cost pricing               # Per-provider pricing
videoforge config set <key> <val>     # Set configuration
videoforge config list                # Show all config

Providers

Provider	Models	Capabilities	API Key
Runway	gen4, gen3a_turbo	Text-to-Video, Image-to-Video	`runway.apiKey`
fal.ai	minimax-video, kling-video	Text-to-Video, Image-to-Video	`fal.apiKey`
Replicate	wan-2.1, ltx-video	Text-to-Video, Variations	`replicate.apiKey`
Google Veo	veo-2.0-generate	Text-to-Video	`veo.apiKey`
OpenAI Sora	sora	Text-to-Video	`sora.apiKey`

Setup

videoforge config set runway.apiKey "your-runway-key"
videoforge config set fal.apiKey "your-fal-key"
videoforge config set replicate.apiKey "your-replicate-key"
videoforge config set veo.apiKey "your-veo-key"
videoforge config set sora.apiKey "your-sora-key"

Style Presets

Preset	Description
`cinematic`	Dramatic lighting, film grain, professional color grading
`animation`	Smooth 2D/3D animation, vibrant colors, fluid motion
`vfx`	Visual effects, particles, explosions, CGI quality
`product-demo`	Clean, professional product showcase
`social-media`	Fast-paced, attention-grabbing, vertical format
`game-trailer`	Intense, action-packed, epic scale
`explainer`	Clear, educational, step-by-step graphics
`ambient`	Slow, atmospheric, mood-setting
`pixel-art`	Retro pixel animation, 8-bit style
`anime`	Japanese anime style, dynamic poses
`3d-render`	Photorealistic 3D rendering, ray tracing
`timelapse`	Accelerated time passage, smooth transitions
`glitch`	Digital glitch, cyberpunk aesthetic, neon
`minimal`	Clean minimalist motion graphics
`watercolor`	Artistic watercolor paint style

Resolution Presets

Preset	Resolution	Use Case
`480p`	854×480	SD preview
`720p`	1280×720	HD
`1080p`	1920×1080	Full HD
`4k`	3840×2160	Ultra HD
`phone`	1080×1920	Mobile (9:16)
`square`	1080×1080	Instagram (1:1)
`youtube`	1920×1080	YouTube (16:9)
`tiktok`	1080×1920	TikTok (9:16)
`story`	1080×1920	Stories (9:16)
`og-video`	1200×630	Open Graph
`tablet`	1024×1366	Tablet (3:4)

Batch Processing

Create a YAML file:

items:
  - prompt: "ocean waves at sunset"
    provider: runway
    duration: 5
    preset: cinematic
  - prompt: "neon city streets at night"
    provider: fal
    resolution: 1080p

videoforge batch videos.yaml
videoforge batch videos.yaml --dry-run  # Preview only

Templates

# Save a template with variables
videoforge template save product-shot "{product} rotating on {background} background" --preset product-demo

# Use the template
videoforge gen "" -t product-shot -v product=sneaker -v background=white

# List and manage
videoforge template list
videoforge template show product-shot
videoforge template delete product-shot

Format Conversion

Requires ffmpeg installed locally:

videoforge convert video.mp4 --to webm
videoforge convert video.mp4 --to gif
videoforge convert video.webm --to mp4

Part of the Forge Ecosystem

Tool	Purpose
AppForge	Scaffold projects
BackForge	Backend init
TestForge	AI test generation
ImgForge	AI image generation
AudioForge	AI audio generation
VideoForge	AI video generation
ScreenForge	App store assets
StoreForge	Store deployment
MonForge	Production monitoring

videoforge