@docyrus/animaguru 0.14.0 → 0.15.0

package/README.md

@@ -339,6 +339,21 @@ animaguru motion get skeleton-list-swipe --write animations/launch/src/scenes
 
 Then call the entry function from `Film.build()`, for example `skeletonListSwipe(this, { at: 4 })`. `--write` refuses to replace an existing scene (pass `--force`) and keeps shared modules that already exist.
 
+## Asset library
+
+CLI 0.15.0 adds `animaguru library`. Pro and Team accounts (and members of a team on the Team plan) can search AnimaGuru's asset library: ready-made sprites with animation sheets, images, video clips, music, voice-over speech and sound effects. Search uses natural language and keywords together. Importing into a project or downloading spends no credits, so check the library before generating a common asset.
+
+```sh
+animaguru library types                                   # types, counts, and whether this account has access
+animaguru library search whoosh for a scene transition --type sfx
+animaguru library search upbeat piano background --labels corporate --limit 3
+animaguru library get pixel-knight                        # description, details (length, size, frames) and files
+animaguru library import pixel-knight --project PROJECT_ID  # sprites become characters, media become saved assets
+animaguru library download mountain-lake-sunrise --output assets/   # saves ID.EXT; sprites save ID/ with sheets and animation.json
+```
+
+An imported image, clip or audio file appears in `assets list` with its file SHA, so it can start an image-to-video generation or be a soundtrack. A sprite's `animation.json` lists frame rectangles `[x, y, w, h]`, per-frame durations, fps, loop and pivot. Staff publish entries with `animaguru library publish --project ID (--asset ASSET_ID | --character SLUG) --title … --summary … --description … --labels …`, and edit or remove them with `library update` and `library remove --yes`.
+
 ## Submit and share videos
 
 Run `animaguru auth login`, then submit from a finished AnimaGuru video workspace: