Anil-matcha/vox-ai-motion-graphics-generator
muapi-director
VerifiedTurn ONE topic, talking-head video, or photo into a finished Vox-style paper-collage explainer / ad video on the MuAPI platform (api.muapi.ai) + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all automated. Three input modalities: a topic (B-roll), a talking-head video (A-roll mode), or a single photo of a person/product anchored into the collage (C-roll mode).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| assets/demo.mp4 | binary | 6.3 MB |
| assets/youtube-thumbnail.jpg | binary | 100.1 KB |
| examples/sample-beats.json | config | 2.4 KB |
| references/beat-layer.md | markdown | 3.3 KB |
| references/prompt-guide.md | markdown | 3.0 KB |
| references/voices.md | markdown | 1.4 KB |
| scripts/aroll_assemble.py | script | 2.6 KB |
| scripts/aroll_clips.py | script | 4.5 KB |
| scripts/asr_beats.py | script | 4.9 KB |
| scripts/assemble.py | script | 6.4 KB |
| scripts/audio.py | script | 3.7 KB |
| scripts/clips.py | script | 5.8 KB |
| scripts/croll_keyframes.py | script | 5.1 KB |
| scripts/keyframes.py | script | 3.1 KB |
| scripts/muapi_client.py | script | 9.0 KB |
| scripts/provider.py | script | 5.5 KB |
| scripts/style_bakeoff.py | script | 2.4 KB |
| scripts/styles.py | script | 11.5 KB |
| scripts/text_overlay.py | script | 4.6 KB |
scripts/styles.py
View on GitHub#!/usr/bin/env python3
"""
Per-era and per-theme style bible for muapi-director.
Defines theme presets, prompt compositions, and aspect routing for image/video generation.
"""
STYLE_BASES = {
"tang": (
"Classical Chinese gongbi fine-line court painting fused with Dunhuang mural "
"style, painted with mineral pigments (ochre, vermilion, malachite green, lapis "
"blue, gold) on aged cracked silk with flaking patina, elegant flowing brushwork "
"and decorative cloud motifs. Ornate, luminous, museum handscroll aesthetic."
),
"song": (
"Song Dynasty literati ink-wash painting in the minimalist 'one-corner' "
"manner of Ma Yuan and Xia Gui: vast empty negative space, sparse delicate "
"monochrome ink with the faintest grey wash on aged cream silk, misty and "
"restrained. Quiet, refined, elegant."
),
"ming": (
"Blue-and-white porcelain illustration: cobalt-blue underglaze brushwork "
"on a white porcelain ground with subtle celadon crackle-glaze texture, flowing "
"porcelain-painting line and wash, decorative wave and cloud borders. Elegant, "
"iconic, ceramic aesthetic with aged patina."
),
"qing": (
"Aged late-imperial Chinese court painting on dark silk in the fusion "
"Sino-European manner of Giuseppe Castiglione, in a somber twilight palette of "
"deep crimson, fading imperial gold and dusk shadows. Fine detailed brushwork, "
"darkened silk with patina. Melancholic, ornate, empire-in-decline mood."
),
"modern": (
"High-contrast black-and-white woodcut print in the 1930s Chinese modern woodcut "
"movement style (Lu Xun era), with the grain of an aged sepia photograph. Bold "
"gouged black-and-white lines, rough carved texture, torn newsprint edges, "
"sepia-and-ink tone. Stark, urgent, revolutionary."
),
"rising": (
"Bold contemporary minimalist 'new Chinese' graphic poster: elegant "
"modern flat shapes with fine gold linework and a touch of ink-brush energy, a "
"palette of bold red, deep ink and gold, generous negative space, dynamic upward "
"motion. Sleek, powerful, optimistic, classical-modern fusion."
),
}
TITLE_TREATMENT = (
"Include a title cartouche with large red Chinese characters '{title_cn}' and a "
"small clean English subtitle '{title_en}', plus a single red seal stamp. Keep the "
"headline crisp and legible."
)
COLLAGE_MECHANICS = (
"Clearly layered hand-cut paper cut-outs with visible torn and scissor-cut edges, tape "
"corners and soft real paper drop shadows, on a bold flat {bg} paper background. Halftone "
"print dots, newspaper-clipping scraps, paper-stencil shapes, aged paper texture, slight "
"print misregistration, scattered geometric paper accents (triangles, circles, zigzags, "
"washi tape). Figures are PRINTED / illustrated cut-outs, NOT CGI, NOT a 3D render — keep "
"print grain and paper imperfections. High-contrast, punchy, tactile, hand-assembled."
)
STYLE_LIBRARY = {
"american-retro": (
"Vintage 1950s-60s American advertising and pulp-magazine paper collage: bold flat "
"retro colors, mid-century engraved and illustrated Western cut-out figures, classic "
"Americana printed imagery, nostalgic."
),
"modern-flat": (
"Clean modern flat 2D illustrated collage in the Vox explainer motion-graphic style: "
"bold flat-color vector-illustration cut-outs, simple confident shapes, a limited "
"contemporary palette, crisp infographic editorial layout."
),
"zine": (
"Gritty punk zine / ransom-note collage: torn newspaper and magazine scraps, cut-out "
"mismatched headline letters, photocopied high-contrast halftone, black-and-white with "
"one spot color, raw hand-cut edges. DIY, analog, urgent."
),
"photo-collage": (
"Cinematic documentary photo-collage: real black-and-white archival photographs cut "
"out and layered with soft drop shadows, one restrained accent color, sepia and "
"monochrome vintage photography. Serious, editorial, museum-like."
),
"chinese-ink": (
"Mixed-media collage of Chinese woodblock-print and ink-mural cut-out figures, aged "
"rice-paper and Chinese newspaper clippings, vermilion seal stamps. Oriental, historical."
),
"newsprint-editorial": (
"Vintage newsprint editorial collage in the style of a mid-century front-page news "
"feature: bold cut-out photographs and illustrations laid over a broadsheet newspaper "
"page, heavy halftone print dots, aged newsprint texture with slight ink "
"misregistration, tactile cinematic editorial energy — reads like a newspaper feature "
"spread brought to life, not an ad."
),
"gilded-deco": (
"Vintage luxury editorial paper collage, 1920s art-deco advertisement mood: aged "
"cream paper with visible grain, champagne-gold foil paper accents, thin art-deco "
"geometric line frames and gilded arches, torn French newspaper clippings, halftone "
"print dots, slight print misregistration. Hushed, opulent, museum-vitrine calm — "
"reads like a perfume-house press page, not a pop ad."
),
}
DEFAULT_STYLE = "american-retro"
THEME_PRESETS = {
"american-retro": {"idiom": "american-retro", "palette": "bold retro primaries — red, mustard, teal, cream",
"type_style": "bold wood-type / heavy slab, all-caps", "finish": "heavy halftone dots, aged newsprint, slight misregistration",
"mood": "nostalgic, punchy", "motion_style": "punchy"},
"swiss-modern": {"idiom": "modern-flat", "palette": "two-color + one red accent, lots of white",
"type_style": "Helvetica/Akzidenz grotesque, tight caps", "finish": "clean flat, very subtle grain",
"mood": "precise, confident", "motion_style": "calm"},
"punk-zine": {"idiom": "zine", "palette": "black & white + one fluorescent spot color",
"type_style": "ransom-note cut-out mismatched letters", "finish": "photocopy grain, heavy misregistration",
"mood": "urgent, rebellious", "motion_style": "max"},
"soviet-constructivist": {"idiom": "Russian Constructivist photomontage, bold diagonal geometry",
"palette": "red, black, cream", "type_style": "bold condensed gothic set on strong diagonals",
"finish": "letterpress, newsprint", "mood": "heroic, urgent", "motion_style": "punchy"},
"wpa-propaganda": {"idiom": "1930s WPA / vintage travel silkscreen poster",
"palette": "muted 3-color screenprint", "type_style": "gothic / stencil caps",
"finish": "screenprint grain, flat ink", "mood": "earnest, civic", "motion_style": "calm"},
"70s-groovy": {"idiom": "1970s groovy print", "palette": "mustard, rust, avocado, cream",
"type_style": "bulbous 70s display serif", "finish": "riso grain, warm", "mood": "warm, funky", "motion_style": "punchy"},
"chinese-ink": {"idiom": "chinese-ink", "palette": "ink black + vermilion, aged paper",
"type_style": "Chinese brush characters + small English + red seal", "finish": "rice-paper, ink bleed",
"mood": "elegant, historical", "motion_style": "calm"},
"atomic-age": {"idiom": "1950s atomic-age retro-futurism", "palette": "teal, orange, cream",
"type_style": "atomic script + geometric caps", "finish": "halftone, starbursts",
"mood": "optimistic, bright", "motion_style": "punchy"},
"newsprint-editorial": {"idiom": "newsprint-editorial", "palette": "cream white, deep red, mustard yellow, charcoal black",
"type_style": "bold condensed newsprint headlines, all-caps", "finish": "aged paper, heavy halftone dots, high contrast, slight print misregistration",
"mood": "energetic, tactile, cinematic editorial", "motion_style": "punchy"},
"gilded-deco": {"idiom": "gilded-deco", "palette": "aged cream, champagne gold, charcoal black, muted deep gold",
"type_style": "elegant high-contrast didone serif, wide letter-spacing", "finish": "gold foil, aged paper grain, fine halftone, slight misregistration",
"mood": "luxurious, calm, vintage editorial", "motion_style": "calm"},
}
def resolve_theme(name):
return THEME_PRESETS.get(name)
_GPT_SIZE = {
"16:9": {"1k": "1536x1024", "2k": "2048x1152", "4k": "3840x2160"},
"9:16": {"1k": "1024x1536", "2k": "1152x2048", "4k": "2160x3840"},
"1:1": {"1k": "1024x1024", "2k": "2048x2048", "4k": "2048x2048"},
"3:4": {"1k": "768x1024", "2k": "2160x2880", "4k": "2160x2880"},
"4:3": {"1k": "1024x768", "2k": "2880x2160", "4k": "2880x2160"},
}
_GPT_QUALITY = {"1k": "medium", "2k": "high", "4k": "high"}
def image_params(model, aspect="16:9", resolution="1k"):
if "gpt-image" in model:
return {"size": _GPT_SIZE.get(aspect, {}).get(resolution, "1024x1024"),
"quality": _GPT_QUALITY.get(resolution, "medium")}
return {"aspect_ratio": aspect, "resolution": resolution}
VIDEO_ASPECT_SUPPORT = {
"veo3.1-image-to-video": ["16:9", "9:16"],
"veo31-image-to-video": ["16:9", "9:16"],
"gemini-omni-flash/image-to-video": ["16:9", "9:16"],
"runway-image-to-video": ["16:9", "9:16", "1:1"],
"kling-video": ["16:9", "9:16", "1:1"],
}
def _aspect_value(aspect):
w, h = aspect.split(":")
return float(w) / float(h)
def resolve_video_aspect(project_aspect, model):
support = None
for key, enum in VIDEO_ASPECT_SUPPORT.items():
if key in model:
support = enum
break
if support is None:
return None, True
if project_aspect in support:
return project_aspect, True
if project_aspect == "adaptive":
return ("adaptive" if "adaptive" in support else support[0]), True
target = _aspect_value(project_aspect)
nearest = min((a for a in support if a != "adaptive"),
key=lambda a: abs(_aspect_value(a) - target))
return nearest, False
def _headline(title_cn, title_en, style, type_style=None):
if title_cn:
return (" " + TITLE_TREATMENT.format(title_cn=title_cn, title_en=title_en))
ts = f" in {type_style}" if type_style else ""
seal = "a vermilion seal stamp" if style == "chinese-ink" else "a small paper sticker accent"
return (f" Include a torn-paper banner with a big bold cut-out English headline "
f"'{title_en}'{ts} and {seal}. Keep the headline crisp and legible.")
def compose_collage_prompt(scene, title_cn, title_en, bg="warm ochre", aspect="16:9",
with_title=True, style=DEFAULT_STYLE,
palette=None, type_style=None, finish=None):
idiom = STYLE_LIBRARY.get(style, style)
pal = f" Palette: {palette}." if palette else ""
fin = f" Print finish: {finish}." if finish else ""
block = f"{idiom}{pal} {COLLAGE_MECHANICS.format(bg=bg)}{fin}"
if with_title:
title = _headline(title_cn, title_en, style, type_style)
else:
title = " No big headline in this shot (a small accent only); it is a cut-in detail."
return (f"{block} SCENE (as layered paper cut-outs): {scene}.{title} "
f"Aspect ratio {aspect}.")
def compose_keyframe_prompt(era: str, scene: str, title_cn: str, title_en: str,
aspect: str = "16:9") -> str:
base = STYLE_BASES[era]
title = TITLE_TREATMENT.format(title_cn=title_cn, title_en=title_en)
return (
f"{base} SCENE: {scene}. Arrange the composition with one clear focal subject "
f"and strong editorial poster balance. {title} Aspect ratio {aspect}."
)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |