القائمة
Use when working with FFmpeg across Node/Static/WASM, the PlatformBridge, the FFmpeg detection/fallback chain, or browser/React Native runtime constraints in ffmpeg-video-composer.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Use when creating or editing a video template JSON (the template descriptor), adding or changing sections/filters/maps/variables/transitions/looks/motion/audio/layers, or debugging template validation errors in ffmpeg-video-composer.
Use when building, testing, linting, formatting, typechecking, or running any app or package in the ffmpeg-video-composer monorepo, or when looking for the right pnpm/vp command.
Use when building, modifying, or consuming the on-device FFmpeg engine — the Rust crate packages/ffmpeg-engine, the leclap-ffmpeg Expo native module, the run/probe/version/cancel API, the uniffi bindings, build-engine.sh, or the FFmpeg-from-source toolchain in scripts/ffmpeg.
Use when adding a segment type, platform adapter, editor manager, or core service in packages/ffmpeg-video-composer, or when wiring new dependencies into the tsyringe container.
استنادا إلى تصنيف SOC المهني
| name | cross-platform-ffmpeg |
| description | Use when working with FFmpeg across Node/Static/WASM, the PlatformBridge, the FFmpeg detection/fallback chain, or browser/React Native runtime constraints in ffmpeg-video-composer. |
The core never calls FFmpeg directly — it goes through an AbstractFFmpeg adapter chosen by the runtime. PlatformBridge detects the environment and wires the right adapter; the Node path additionally auto-detects an FFmpeg binary with a fallback chain. Full detail: docs/ffmpeg-fallback-strategy.md and docs/architecture.md.
packages/ffmpeg-video-composer/src/platform/PlatformBridge.tspackages/ffmpeg-video-composer/src/platform/ffmpeg/ (AbstractFFmpeg, FFmpegNodeAdapter, FFmpegStaticAdapter, FFmpegWasmAdapter, FFmpegDetector, plus *Music* adapters)| Runtime | FFmpeg | Filesystem | Logger |
|---|---|---|---|
| Node.js | FFmpegNodeAdapter → FFmpegStaticAdapter | FilesystemNodeAdapter | PinoLogAdapter |
| Browser | FFmpegWasmAdapter (@ffmpeg/ffmpeg) | BrowserFilesystemAdapter (IndexedDB) | console logger |
| React Native | FFmpegLeclapAdapter (on-device engine) | FilesystemExpoAdapter | ReactNativeLogger |
FFmpegDetector resolves, in order:
ffmpeg -version on PATH) → FFmpegNodeAdapter (fluent-ffmpeg).ffmpeg-static bundled binary → FFmpegStaticAdapter.@ffmpeg/ffmpeg WASM → FFmpegWasmAdapter.Installing system FFmpeg (e.g. via mise) is the fastest Node path.
packages/ffmpeg-video-composer/src/index.ts registers Node adapters into the tsyringe container.packages/ffmpeg-video-composer/src/browser.ts registers WASM + IndexedDB + browser event manager.Keep the two bundles separate — anything imported by browser.ts must be browser-safe (no Node built-ins).
fetch for remote assets; no Node fs.BrowserEventManager); the WASM adapter wires FFmpeg's progress listener to it.AbstractFFmpeg — breaks one or more platforms.browser.ts path → bundle/runtime failure in the browser.AbstractFFmpeg and every concrete adapter that should support it.