edenfunf/reelmimic

blender-product-film

Premium 3D product films rendered in Blender (headless, GPU) — dark studio, rim light, light sweeps, glass/liquid/metal materials, condensation and bubbles, macro and orbit camera moves, shallow depth of field, then crisp 2D titles, transitions, music and S…

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/edenfunf/reelmimic --skill blender-product-film

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Blender product film

Everything is driven by JSON shot specs → scripts/pfilm.py (runs inside Blender) → PNG frames → scripts/finish.py (edit, titles, audio). Blender 4.2+(BLENDER 環境變數或在 PATH 上;建議有 OptiX/CUDA 的 GPU)。選配 Real-ESRGAN(REALESRGAN 環境變數指到 realesrgan-ncnn-vulkan)。

Pipeline

build/
  product/        prep_product.py output (from the user's photo)
  shots/S1.json   one spec per shot (format: top of scripts/pfilm.py)
  renders/…       frames
  edit.json       the cut: order, transitions, titles, music, SFX (format: top of scripts/finish.py)
  1. Product. User photo (front view, plain background) →

python scripts/prep_product.py <photo> --out build/product --height <real height m> Small images are AI-upscaled 4× first. Open `build/product/check.png` and confirm the green silhouette hugs the product and the magenta print mask covers the label/cap and not the clear body. No photo → procedural "type": "bottle" (see pfilm.py).

  1. Shot specs. One JSON per shot in build/shots/, written from the plan's shot table (camera language below).
  2. Look-dev stills (fast, do this first, iterate here):

python scripts/render_shots.py build --quality final --stills auto (start/middle/end of each shot) → out/check/<id>_stills.jpg

  1. Motion preview of every shot + a rough cut compared to the reference:

python scripts/render_shots.py build --quality preview --cut → out/check/<id>_preview.jpg, out/preview_cut.mp4, compare sheets

  1. Compare with the reference (see Review) and fix; repeat 3–5 until every shot passes.
  2. Final: python scripts/render_shots.py build --quality final (≈1.5–4 s/frame at 1080p) → python scripts/finish.py build/edit.json.

Camera language (use these; name them in the plan)

Every shot has a move, a subject, a fill and a motivation. Speed: match the reference, measured. Premium films move slowly — the reference's shot_details[].camera.pace is usually slow/medium. The ranges below are the total travel for a ~3 s shot at a slow pace; macro shots need far less travel than full-product shots (on a small region, fill 0.95→0.85 already reads as a 50% zoom). Always: preview → --cut compare → scale with camera.speed_scale (ratio reference speed ÷ our speed, floor ≈ 0.2 so nothing goes dead) → re-preview, before the final render.

MoveSpecWhenTypical
Hero reveal (pushreveal / dollyin from dark)dolly_in, fill 0.7→0.8, lens 85, light sweep acrossopening, closing3–4 s
Macro slidemacro_slide, lens 60–100, region = the detail, fill 0.9→0.92, angle −3→+3material / detail proof2–3 s
Orbitorbit, angle −25→+10, fill 0.7→0.75, height rising a littlereveal the form, turn the label into view3–4 s
Cranedolly_out + target moving up (pure crane reads backwards in compare), height ±0.03scale, cap-to-base travel2–3 s
Rack focusrack_focus, focusfrom/focusto (m), lens 100, fstop 2.8droplets → label, foreground → product2 s
Static + light sweepstatic + lights.sweeptext beat with product still alive2–3 s
Product spinproduct.rotate [a, b] with a slow cameraturntable feel without moving the cameraany

Rules of the look (what makes it read "premium"):

  • Black stage, low key. set.backglow gives a soft coloured pool on a dark backdrop; key light low (≈5), rim strips do the modelling,

one moving sweep light per hero shot. Never a flat bright background.

  • The product fills the frame. Hero ≥ 0.7 of frame height; details via region + fill ≥ 0.8. A small product in a big black frame is the #1 failure.
  • Every shot moves (camera or product or light), slow and eased — no cut to a dead still.
  • Open with a reveal: shot 1 starts dark and the light finds the product (lights.reveal: [0, 1.5]), centred or on a third with

purpose. It is the most striking image of the film — never a static, half-empty frame.

  • Empty frame has a job. More than half the frame black and empty is only allowed when a title lives there. Tall thin products

(bottles) cover little area even at full height: crop tighter (cap-to-label), go lower and closer, or put the title in the empty side. pfilm prints PFILM_WARN (and meta.json) when the product is small or its texture too soft for the close-up — treat warnings as defects.

  • Close-up rims: pfilm switches to a 4 mm strip at equal radiance on close-ups (a fine edge line). Don't force closeup_rim up:

a thick continuous white outline reads as a cut-out sticker.

  • Titles: headline cards 0.06–0.09 of frame height, supers next to the product 0.04–0.05, closing brand line ≥ 0.05.

Never three text beats in a row without a product image between them unless the reference does exactly that.

  • Depth of field by depth, not f-number: "dof": "shallow|medium|deep" computes the f-stop for the camera distance

(macro at f/3.5 leaves ~2 mm sharp — unusable). Focus sits on the product's front surface automatically.

  • Titles are 2D, in negative space, never over the product: short (3–8 characters/words), grey + white two-tone, light_up or rise reveal.

Title-only frames (black + text) ≤ 15% of runtime — a product film is pictures first.

  • Macro on bubbles / droplets needs a bright area behind the product (clear things only show what they refract): bring the backdrop

close (set.backdrop_dist ≈ 0.55) and make the back spot small and bright (backglow_spread ≈ 30, strength 9–16, backglow_height ≈ 0.25).

  • Light sweep energy ≈ 6–10. A bright strip passing between lens and product washes the label and cap to white.
  • Atmosphere (pfilm set): ground_fog = low rolling haze at the base only (density ≈ 0.3, height ≈ 0.08 m) for "mist / cool" beats —

never a whole-frame grey wash. caustics = moving water-light lines on the backdrop for "ocean / water" beats; best on a mid-blue backdrop (backdrop_color), keep it subtle (default strength 0.35) and let depth of field soften it.

  • Rising bubbles are product.bubbles (inside the water); condensation is product.droplets (outside). A shot that promises bubbles must show bubbles.
  • Clear liquids need light BEHIND them. In a dark field, water reads as black ink unless something bright sits behind it:

keep a soft bright zone behind the product in every dark shot (set.backglow strong and low behind the body, or a glow card), so the liquid refracts light and reads clear. "Is the water clear?" is the first question for any drink film.

  • Titles say something. Repeating the product name is not a message: each text beat is one claim (taken from the pack or the

user) followed by the picture that proves it. The name appears at the open and the close.

  • Don't repeat a detail: the same close-up subject (e.g. the cap) at most twice per film; vary subject, scale and angle between

neighbouring shots. Keep the product's colours identical across shots — change light level, not hue.

  • The last shot is a hero: full product or shoulder-and-label, fill ≥ 0.7, a final light sweep across the name, and ≥ 1 s of stable

frame before the fade.

  • Proof shots: turn each claim into a picture of the product (droplets = cold, bubbles rising = fresh, macro label = the name, orbit = the shape).

Only claims that are printed on the product or given by the user; never invent specs for a real brand.

  • Cuts on motion: the next shot continues the direction of the last (orbit right → next move right), or dips through black at section breaks.

Review (mandatory before the final render)

For every shot, put the reference shot it maps to next to ours (video-clone scripts/compare.py), open it, and score 1–5: lighting (low key, rim, highlights) · material realism · camera motion (type and speed match the reference) · composition / fill · typography · pacing. Any score < 4 → fix the spec and re-render stills/preview. Write the scores to out/check/review.md. Also open one full-res still per shot and look for: blown highlights, washed-out label, visible light panels, clipping into the product, text over the product, flat black frames.

Known pitfalls

  • EEVEE's screen-space refraction breaks clear bottles (black bands) → preview and final both use Cycles (default).
  • Big emissive cards behind the product flood the frame → use set.backglow (backdrop + spot), not an emissive wall.
  • Glossy floors mirror the softboxes → lights are light-linked to the product (automatic).
  • Blender renders CJK blank from Noto variable fonts → 3D text uses Microsoft JhengHei; but titles belong in finish.py anyway.
  • Web product photos are tiny (≈400 px) → prep upscales with Real-ESRGAN; still, avoid extreme label macros (fill > 0.95 on text).
  • Baked highlights in the product photo are removed from the print mask (thin white outlines are kept, semi-opaque).
  • Ghost / doubled label text → check `print.png`'s alpha first, not the lights. Upscaled small CJK text leaves speckles between strokes.

Best fix for a user's own product: clear the name area in print.png and re-typeset the printed name in place (same text, colour, position; 2× resolution), then update product.json (m_per_px, bottom_px) — see a project's build/relabel.py for a worked example.

  • Photo relief (bump from the photo) is off by default: it turns JPEG noise into embossed grain.
  • Hue-matched print (a blue stripe on a blue-tinted bottle) gets cut out as "clear body" → patch those holes in print.png.
같은 저장소의 Skills

더 많은 Skills

모든 Skills
edenfunf
커뮤니티

anime-cel

Make Japanese TV-anime style videos (MP4) with code — cel-shaded characters with tapered line art, big detailed eyes, hair clumps with a specular band, comedic anime reactions (sweat drop, anger vein, sparkle eyes, ≥< eyes, dot eyes, tears), painted skies with cumulus clouds, school/street/classroom/rooftop sets with time-of-day palettes, speed/focus lines, impact frames, dramatic zooms, smears, sakura petals and anime subtitles (CJK). Canvas 2D rendered frame by frame in headless Chrome, encode

1시간 설치 수
2
GitHub Stars
2.1천
업데이트
11월 17일
edenfunf
커뮤니티

painted-animation

Make hand-painted watercolour-and-ink cartoon videos (MP4) with code — p5.js + p5.brush rendered frame by frame in headless Chrome, encoded with ffmpeg — starring Clawd or any character. Use when the user asks to make an animation, animated short, cartoon, music video, lyric video, animated GIF/loop or "a video of Clawd…", or mentions the PDoomVideo / ClaudeAnimationBase approach. Covers storyboarding, the engine API, the render-and-look review loop, music/lyric sync and splitting long videos ac

1시간 설치 수
2
GitHub Stars
2.1천
업데이트
11월 17일
edenfunf
커뮤니티

paper-cutout

Make paper cut-out / stop-motion style animated videos (MP4) with code — handmade construction paper, cardstock, kraft, felt and tissue pieces with scissor-cut or torn edges and soft drop shadows, photographed on a table under a warm lamp; jointed paper puppets with brass split-pin joints, moving in 12 fps steps. Canvas 2D rendered frame by frame in headless Chrome, encoded with ffmpeg. Use when a reference video or brief calls for paper craft, cut-paper, papercraft, stop-motion paper, kids' sto

1시간 설치 수
2
GitHub Stars
2.1천
업데이트
11월 17일
edenfunf
커뮤니티

pixel-art

Make modern, polished pixel-art animated videos (MP4) with code — indie-game look (Celeste / Eastward / Stardew-level scenes, original), 480×270 art upscaled ×4 with nearest-neighbour, limited palettes (day / dusk / night) with Bayer dithering, parallax skies, hills, forests and towns, dithered light and weather, auto-outlined procedural pixel characters with 16 expressions, walk cycles, jumps and held props, emote bubbles, dither / diamond / iris / block transitions and crisp RPG dialogue-box c

1시간 설치 수
2
GitHub Stars
2.1천
업데이트
11월 17일