사용 시기
이 스킬은 프로젝트 스캐폴딩부터 최종 비디오 렌더링에 이르기까지 Remotion 코드를 읽거나 작성할 때마다 불러오세요.
피해야 할 일반적인 AI 실수
커밋하기 전에 모든 Remotion 코드 변경 사항에 대해 다음의 반복적인 실패 패턴을 확인하세요:
- 비결정적 무작위성 —
remotion의random(seed)를 사용하고,Math.random(),Date.now(),new Date()는 절대 사용하지 마세요. 그렇지 않으면 병렬 렌더 시 지글거리는 노이즈가 발생합니다. - 메모이즈되지 않은
<Player>inputProps— 항상 메모이즈된 props를 전달하세요. 메모이즈되지 않은 props는 전체 트리에 리렌더링 폭풍을 일으킵니다. - 비동기 작업(fetch, 폰트 로드, 측정) 시
delayRender()/continueRender()누락 — 이를 생략하면 렌더가 30,000ms에서 중단됩니다. - 캡션의
inputRange가 단조 증가하지 않음 —interpolate의inputRange는 반드시 엄격하게 증가해야 합니다. 짧은 클립의 경우 페이드 윈도우에Math.min(10, Math.floor(duration / 3))을 사용하세요. - 모든 곳에서 선형 이징 사용 — 자연스러운 움직임에는
spring()을 선호하고, 명시적인 기술적 필요가 있을 때만 선형을 사용하세요. @remotion/google-fonts가져오기 누락 — 모든 폰트는 명시적인loadFont({ weights, subsets })호출이 필요합니다.- 단일 컴포지션으로 모든 출력 — 장면을 작고 집중된 컴포지션으로 나누고
<Sequence>또는<TransitionSeries>로 구성하세요. - 더 이상 사용되지 않는
startFrom/endAt— 대신trimBefore/trimAfter를 사용하세요.
새 프로젝트 설정
빈 폴더나 기존 Remotion 프로젝트가 없는 작업 공간인 경우, 다음을 사용하여 프로젝트를 스캐폴딩하세요:
npx create-video@latest --yes --blank --no-tailwind my-video
my-video를 적절한 프로젝트 이름으로 바꾸세요.
미리보기 시작
비디오를 미리 보려면 Remotion Studio를 시작하세요:
npx remotion studio
선택 사항: 단일 프레임 렌더 확인
CLI로 단일 프레임을 렌더링하여 레이아웃, 색상 또는 타이밍을 점검할 수 있습니다. 단순한 편집, 순수 리팩터링, 또는 Studio나 이전 렌더에서 충분한 확신이 있는 경우에는 건너뛰세요.
npx remotion still [composition-id] --scale=0.25 --frame=30
30fps에서 --frame=30은 1초 지점입니다(--frame은 0부터 시작).
규칙 인덱스
자세한 설명과 코드 예제는 개별 규칙 파일을 읽으세요.
핵심(Core)
- core/compositions.md - 컴포지션, 스틸, 폴더, 기본 props 및 동적 메타데이터 정의
- core/sequencing.md - 시퀀싱 패턴 - 지연, 트리밍, 항목 기간 제한
- core/timing.md - interpolate, 베지어 이징, 스프링을 사용한 타이밍
- core/animations.md - 기본 애니메이션 기술
- core/trimming.md - 애니메이션의 시작 또는 끝 트리밍
- core/parameters.md - Zod 스키마로 비디오 매개변수화
- core/calculate-metadata.md - 컴포지션 기간, 크기 및 props 동적 설정
- core/primitives.md - 레이아웃 및 타이밍 프리미티브: Loop, Freeze, Series, Null, IFrame, AnimatedImage, premount
미디어(Media)
- media/images.md - Img 컴포넌트를 사용한 이미지 임베딩
- media/videos.md - 비디오 임베딩 - 트리밍, 볼륨, 속도, 루핑
- media/gifs.md - Remotion 타임라인에 동기화된 GIF 표시
- media/lottie.md - Lottie 애니메이션 임베딩
- media/transparent-videos.md - 투명도가 있는 비디오 렌더링
- media/assets.md - 이미지, 비디오, 오디오 및 폰트 가져오기
- media/light-leaks.md - 라이트 릭 오버레이 효과
- media/3d.md - Three.js 및 React Three Fiber를 사용한 3D 콘텐츠
오디오(Audio)
- audio/audio.md - 오디오 및 사운드 사용 - 가져오기, 트리밍, 볼륨, 속도, 피치
- audio/voiceover.md - ElevenLabs TTS를 사용한 AI 생성 음성 해설
- audio/audio-visualization.md - 오디오 시각화(스펙트럼 막대, 파형, 베이스 반응형)
- audio/silence-detection.md - FFmpeg를 사용한 적응형 무음 감지
- audio/sfx.md - 사운드 효과 사용
- audio/subtitles.md - 캡션 및 자막 개요
- audio/get-audio-duration.md - Mediabunny로 오디오 파일 길이 가져오기
- audio/ai-captions.md - AI 전사: @remotion/openai-whisper, whisper-web, install-whisper-cpp
텍스트(Text)
- text/text-animations.md - 타이포그래피 및 텍스트 애니메이션 패턴
- text/measuring-text.md - 텍스트 크기 측정, 컨테이너에 텍스트 맞추기
- text/fonts.md - Google Fonts 및 로컬 폰트 로드
- text/google-fonts.md - @remotion/google-fonts의 폰트별 패키지, 필요한 weights/subsets 포함
- text/display-captions.md - 화면에 캡션 렌더링
- text/import-srt-captions.md - SRT 캡션 파일 가져오기
고급(Advanced)
- advanced/maps.md - Mapbox를 사용한 지도 추가 및 애니메이션
- advanced/charts.md - 차트 및 데이터 시각화(막대, 원형, 선, 주식)
- advanced/transitions.md - 장면 전환 패턴(기본)
- advanced/transitions-package.md - @remotion/transitions 전체 참조 - 프레젠테이션, 타이밍, 사용자 정의
- advanced/tailwind.md - Remotion에서 TailwindCSS 사용
- advanced/measuring-dom-nodes.md - DOM 요소 크기 측정
- advanced/hdr.md - 색 공간 및 HDR 출력: bt709, displayp3, rec2020, ProRes
유틸리티(Utilities)
- utilities/ffmpeg.md - 비디오 작업을 위한 FFmpeg 사용
- utilities/can-decode.md - Mediabunny를 사용하여 비디오 디코딩 가능 여부 확인
- utilities/extract-frames.md - 특정 타임스탬프에서 프레임 추출
- utilities/get-video-dimensions.md - 비디오 파일의 너비와 높이 가져오기
- utilities/get-video-duration.md - 비디오 파일의 길이(초) 가져오기
- utilities/transcribe-captions.md - 캡션 전사
프로덕션(Production)
- production/delay-render.md - 비동기 작업 중 렌더링 일시 중단: delayRender, continueRender, cancelRender
- production/determinism.md - random(seed)를 사용한 결정적 렌더링; Math.random / Date.now 사용 금지
- production/rendering.md - @remotion/renderer Node SSR: bundle, selectComposition, renderMedia
- production/cli.md - npx remotion 하위 명령 및 플래그(render, still, bundle, studio, benchmark)
- production/config.md - remotion.config.ts Config 설정자(codec, CRF, concurrency, Webpack)
- production/lambda.md - AWS Lambda: deployFunction, deploySite, renderMediaOnLambda, 비용 조정
- production/player.md - @remotion/player 임베딩, PlayerRef, 메모이즈된 inputProps, 버퍼 이벤트
- production/video-tag-decision.md - Video / OffthreadVideo / Html5Video / @remotion/media 중 선택
- production/input-props.md - Prop 해결 순서, Zod 유효성 검사, --props CLI 플래그, 렌더 경계 보안
- production/caption-timing-safety.md - 캡션을 위한 단조 inputRange 및 적응형 페이드 윈도우
- production/performance.md - 하드웨어 가속, 동시성, 이미지 형식, GPU 사전 계산, 벤치마킹
- production/env-vars.md - REMOTION_ 접두사, .env 로딩, inputProps / envVariables를 통한 비밀값
통합(Integration)
- integration/nextjs.md - Next.js App Router: Player SSR 가드, transpilePackages, Lambda API 라우트
- integration/docker.md - Docker: 베이스 이미지, --shm-size, 폰트, Chromium 플래그, CI 예제
- integration/mediabunny-migration.md - deprecated된 media-parser/webcodecs에서 Mediabunny Video/Audio로 마이그레이션
- integration/v5-prep.md - v5 주요 변경 사항에 대비한 v4 코드 미래 보장
패키지(Packages)
- packages/paths.md - @remotion/paths SVG 경로 유틸리티(interpolatePath, warpPath, getLength)
- packages/shapes.md - @remotion/shapes 사전 빌드된 SVG 프리미티브(삼각형, 원, 별, 파이, 하트)
- packages/noise.md - @remotion/noise 시드 기반 펄린 노이즈(noise2D, noise3D, noise4D)
- packages/motion-blur.md - @remotion/motion-blur Trail 및 CameraMotionBlur(제한적으로 사용)
- packages/skia.md - @remotion/skia 고성능 캔버스(React Native Skia)
- packages/rive.md - @remotion/rive 상태 머신 애니메이션(Lottie 대체)