cineprompt 1.0.0 → 1.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 CLI tool for building structured AI video prompts and share links via [cineprompt.io](https://cineprompt.io).
 
-Turn shot descriptions into optimized prompts for Sora, Runway, Kling, Veo, Seedance, and other AI video generators.
+Turn shot descriptions into optimized prompts for Sora, Runway, Kling, Veo, Seedance, WAN, Grok Imagine, LTX, and other AI video generators.
 
 ## Install
 
@@ -29,7 +29,7 @@ cineprompt auth cp_your_api_key_here
 ### Build a share link from state JSON
 
 ```bash
-cineprompt build '{"mode":"single","complexity":"complex","subjectType":"landscape","fields":{"media_type":["cinematic"],"tone":["peaceful"],"env_time":"golden hour, warm late afternoon light","shot_type":"establishing shot","movement":"pull out","focal_length":"24mm lens","dof":"deep focus","color_grade":"warm tones"}}'
+cineprompt build '{"mode":"single","complexity":"complex","subjectType":"character","fields":{"media_type":["cinematic"],"mood":["contemplative"],"genre":["drama"],"char_label":"A retired boxer","subject_description":"Weathered face, broken nose","setting":"interior","location_type":["apartment"],"env_time":"night","shot_type":"medium close-up","framing":["positioned left-third of frame"],"focal_length":"85mm","dof":"shallow depth of field, bokeh","movement_type":["static, locked-off"],"lighting_type":["practical lights"],"film_stock":["Kodak Vision3 500T 5219"],"color_grade":["desaturated"],"ambient":"Refrigerator hum, distant sirens"}}'
 ```
 
 Output:
@@ -53,12 +53,12 @@ cat shot.json | cineprompt build
 ### Browse available fields
 
 ```bash
-# List all 92 fields
+# List all 133 fields
 cineprompt fields
 
 # Show valid values for a specific field
-cineprompt fields env_time
-cineprompt fields shot_type
+cineprompt fields mood
+cineprompt fields movement_type
 cineprompt fields media_type
 ```
 
@@ -67,42 +67,60 @@ cineprompt fields media_type
 ```json
 {
   "mode": "single",
-  "complexity": "simple",
+  "complexity": "complex",
   "subjectType": "character",
   "fields": {
     "media_type": ["cinematic"],
-    "tone": ["moody"],
+    "mood": ["nostalgic"],
+    "genre": ["drama"],
     "char_label": "A weathered fisherman",
-    "subject_description": "Deep wrinkles, sun-damaged skin",
+    "subject_description": "Deep wrinkles, sun-damaged skin, calloused hands",
+    "expression": "quietly content",
+    "wardrobe": "Faded yellow slicker, wool cap",
+    "action_primary": "mending a net",
     "setting": "exterior",
-    "location_type": "dock, pier",
+    "location_type": ["dock, pier"],
+    "custom_location": "A fog-wrapped fishing dock at dawn",
     "env_time": "dawn, first light",
     "weather": "fog",
     "shot_type": "close-up",
-    "movement": "handheld",
+    "framing": ["positioned left-third of frame"],
+    "focal_length": "85mm",
     "dof": "shallow depth of field, bokeh",
-    "lighting_style": "soft light",
-    "color_grade": "desaturated",
-    "sfx_environment": ["waves crashing, water ambience"]
+    "movement_type": ["handheld"],
+    "lighting_type": ["daylight"],
+    "key_light": "Diffused morning light through fog",
+    "film_stock": ["Kodak Portra 400"],
+    "color_grade": ["desaturated"],
+    "sfx_environment": ["waves crashing, water ambience"],
+    "ambient": "Creaking dock, distant foghorn, gulls"
   }
 }
 ```
 
 ### Required fields
 
-- **mode** — `"single"` (multishot and frame-to-motion coming soon)
+- **mode** — `"single"` or `"multi_shot"`
 - **fields** — object mapping field names to values
 
 ### Optional fields
 
-- **complexity** — `"simple"` (default) or `"complex"` (unlocks camera body, lens brand, film stock, color science)
+- **complexity** — `"simple"` (default) or `"complex"` (unlocks camera body, lens brand, film stock, color science, environment layers)
 - **subjectType** — `"character"`, `"object"`, `"vehicle"`, `"creature"`, `"landscape"`, or `"abstract"`
 
 ### Field types
 
-- **Button fields** accept exact string values (use `cineprompt fields <name>` to see options)
+- **Button fields** (93) accept exact string values (use `cineprompt fields <name>` to see options)
 - **Array fields** accept multiple values: `"media_type": ["cinematic", "documentary"]`
-- **Free text fields** accept any string: `"subject_description": "whatever you want"`
+- **Text fields** (40) accept any string: `"subject_description": "whatever you want"`
+
+## Modes
+
+**Single Shot** — full cinematography control over one shot. 133 fields across subject, camera, lighting, color, environment, and sound.
+
+**Multi-Shot** — sequence of shots with global settings + per-shot overrides. Recurring characters, 28 transition types.
+
+**Frame → Motion** — dual-prompt workflow for img2vid. Build the frame first (image prompt), then direct the motion with quick-insert chips for camera moves, pacing, transitions, and directing cues.
 
 ## Use with AI agents
 
@@ -134,6 +152,7 @@ CINEPROMPT_API_KEY=cp_your_key cineprompt build '{"fields":{...}}'
 
 - [CinePrompt](https://cineprompt.io) — prompt builder
 - [Guides](https://cineprompt.io/guides) — articles on AI video prompting
+- [Models](https://cineprompt.io/models) — AI video model comparison
 - [Light Owl](https://lightowl.com) — production company behind CinePrompt
 
 ## License