lotio 1.1.57 → 1.1.59

package/README.md

@@ -35,29 +35,30 @@ xcode-select --install
 ### Command Line
 
 ```bash
-lotio [--stream] [--debug] [--layer-overrides <config.json>] [--text-padding <0.0-1.0>] [--text-measurement-mode <fast|accurate|pixel-perfect>] <input.json> <output_dir> [fps]
+lotio --data <input.json> [--stream] [--debug] [--layer-overrides <config.json>] [--text-padding <0.0-1.0>] [--text-measurement-mode <fast|accurate|pixel-perfect>] [--fps <fps>] <output_dir>
 ```
 
 **Options:**
+- `--data <input.json>` - Path to input Lottie animation JSON file (required)
 - `--stream` - Stream frames to stdout as PNG (for piping to ffmpeg)
 - `--debug` - Enable debug output
-- `--layer-overrides` - Path to layer overrides JSON (for text auto-fit, dynamic text values, and image path overrides)
-- `--text-padding` - Text padding factor (0.0-1.0, default: 0.97 = 3% padding)
-- `--text-measurement-mode` - Text measurement mode: `fast` | `accurate` | `pixel-perfect` (default: `accurate`)
+- `--layer-overrides <config.json>` - Path to layer overrides JSON (for text auto-fit, dynamic text values, and image path overrides)
+- `--text-padding <0.0-1.0>` - Text padding factor (0.0-1.0, default: 0.97 = 3% padding)
+- `--text-measurement-mode <fast|accurate|pixel-perfect>` - Text measurement mode: `fast` | `accurate` | `pixel-perfect` (default: `accurate`)
+- `--fps <fps>` - Frames per second for output (optional, default: animation fps or 30)
 - `--version` - Print version information and exit
 - `--help, -h` - Show help message
-- `fps` - Frames per second for output (default: 25)
 
 **Examples:**
 ```bash
 # Render to PNG frames
-lotio animation.json frames/ 30
+lotio --data animation.json --fps 30 frames/
 
 # Stream to ffmpeg
-lotio --stream animation.json - | ffmpeg -f image2pipe -i - output.mp4
+lotio --data animation.json --stream --fps 30 - | ffmpeg -f image2pipe -i - output.mp4
 
 # With layer overrides
-lotio --layer-overrides layer-overrides.json animation.json frames/
+lotio --data animation.json --layer-overrides layer-overrides.json --fps 30 frames/
 ```
 
 ### Docker (Recommended for Video Output)
@@ -65,7 +66,7 @@ lotio --layer-overrides layer-overrides.json animation.json frames/
 **Quick start with automatic video encoding:**
 ```bash
 docker run --rm -v $(pwd):/workspace matrunchyk/lotio-ffmpeg:latest \
-  data.json - 30 --layer-overrides layer-overrides.json --output video.mov
+  --data data.json --fps 30 --layer-overrides layer-overrides.json --output video.mov
 ```
 
 **Available images:**
@@ -230,11 +231,11 @@ The `samples/` directory contains example Lottie animations and configurations:
 ```bash
 # Sample 1: Basic animation with text customization
 cd samples/sample1
-lotio --layer-overrides layer-overrides.json data.json output/ 30
+lotio --data data.json --layer-overrides layer-overrides.json --fps 30 output/
 
 # Sample 2: Animation with external images
 cd samples/sample2
-lotio data.json output/ 30
+lotio --data data.json --fps 30 output/
 ```
 
 ## Using as a Library

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lotio",
-  "version": "1.1.57",
+  "version": "1.1.59",
   "description": "High-performance Lottie animation frame renderer for the browser",
   "main": "browser/index.js",
   "module": "browser/index.js",