Skip to content
Back to search

fframes

programmatic video rendering framework that is actually fast

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dmtrKovalenko/fframes with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dmtrKovalenko/fframes'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dmtrkovalenko--fframes/badge.svg)](/listings/dmtrkovalenko--fframes)

HTML

<a href="/listings/dmtrkovalenko--fframes"><img src="/api/listings/dmtrkovalenko--fframes/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 419 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="landing/brand/fframes-wordmark-dark.svg" />
  4. <img alt="fframes" src="landing/brand/fframes-wordmark.svg" width="360" />
  5. </picture>
  6. </p>
  7. <p align="center">
  8. <b>Video vibe coding framework that is actually fast.</b>
  9. </p>
  10. <p align="center">
  11. <a href="https://crates.io/crates/fframes"><img alt="crates.io" src="https://img.shields.io/crates/v/fframes.svg" /></a>
  12. <a href="https://docs.rs/fframes"><img alt="docs.rs" src="https://img.shields.io/docsrs/fframes" /></a>
  13. <a href="./LICENSE.txt"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-blue.svg" /></a>
  14. <a href="https://x.com/fframes_rust"><img alt="@fframes_rust on X" src="https://img.shields.io/badge/X-@fframes__rust-black.svg" /></a>
  15. </p>
  16. https://github.com/user-attachments/assets/9fdfd7b6-121b-4b49-bbf4-6f34d240f3a5
  17. ---
  18. ## What is it for
  19. fframes is a framework for rendering videos from code. Assuming you are not going to write the thousands lines of code fora video yourself our goal is **quick and efficient** iteration speed for your AI agent, **great and useful real time preview for you**, and **fastest in industry rendering speed** (we are over 30x faster than remotion).
  20. ## Get started
  21. Start with a skill and ask your favorite AI agent to make something you want. Then iterate.
  22. ```sh
  23. npx skills add https://fframes.studio
  24. ```
  25. ## Here is how your videos composed in the code
  26. Every frame is an SVG tree returned by a Rust function, written with the `svgr!` macro. From
  27. [examples/hello-world](examples/hello-world/src/hello_world.rs), shortened: a square moves along a timeline and a line
  28. of text prints the current frame.
  29. <details>
  30. <summary><b>Show the code</b></summary>
  31. ```rust
  32. impl Video for HelloWorldVideo<'_> {
  33. const FPS: usize = 30;
  34. const WIDTH: usize = 1920;
  35. const HEIGHT: usize = 1080;
  36. fn duration(&self) -> fframes::Duration<'_> {
  37. fframes::Duration::Seconds(30.)
  38. }
  39. fn audio(&self) -> AudioMap<'_> {
  40. AudioMap::none()
  41. }
  42. fn render_frame(&self, frame: Frame, ctx: &FFramesContext) -> fframes::Svgr<'_> {
  43. fframes::svgr!(
  44. <svg
  45. xmlns="http://www.w3.org/2000/svg"
  46. viewBox="0 0 1920 1080"
  47. width={ctx.current_video_size.width}
  48. height={ctx.current_video_size.height}
  49. >
  50. <rect
  51. x="400"
  52. y="400"
  53. width="200"
  54. height="200"
  55. fill="blue"
  56. transform={frame.animate(fframes::timeline!(
  57. at 0., animate Transform::translate(0, 0) => Transform::translate(200, 480), Easing::Linear,
  58. at 2. => 6.0, animate Transform::translate(200, 480) => Transform::translate(750, -400), Easing::Linear,
  59. at 6.0 => 10.0, animate Transform::translate(750, -400) => Transform::translate(1310, 480), Easing::Linear,
  60. ))}
  61. />
  62. <text
  63. x="100"
  64. y="440"
  65. font-family="JetBrains Mono"
  66. font-size="74"
  67. font-weight="500"
  68. fill="#3b5563"
  69. >
  70. {format!("This frame index: {}, second: {:.2}", frame.index, frame.seconds())}
  71. </text>
  72. </svg>
  73. )
  74. }
  75. }
  76. ```
  77. </details>
  78. ## Inspiration
  79. Here is a list of some of the examples we store in the repo. Feel free to ~~inspire~~ steal them for your videos. Click an example name to browse its source, or a poster for a preview.
  80. #### [fframes-intro](examples/fframes-intro)
  81. The 128 second [launch video](https://x.com/0xfflock/status/2104432561200279774), everything placed on the beat grid of its soundtrack.
  82. <a href="https://github.com/user-attachments/assets/9fdfd7b6-121b-4b49-bbf4-6f34d240f3a5">
  83. <img alt="Watch fframes-intro" src="examples/_previews/fframes-intro.jpg" width="640" />
  84. </a>
  85. #### [made-of-motion](examples/made-of-motion)
  86. A 20 second promo with pixel objects, a perspective carousel, thermal shaders and per-exposure vector ink, an adaptation of a reference film.
  87. <a href="https://github.com/user-attachments/assets/3c51ccae-3541-4c79-817c-f544cf83e415">
  88. <img alt="Watch made-of-motion" src="examples/_previews/made-of-motion.jpg" width="480" />
  89. </a>
  90. #### [hello-world](examples/hello-world)
  91. A simple "hello world" video. A good start if you want to really read the code.
  92. <a href="https://github.com/user-attachments/assets/4731c533-c120-44d0-8022-e09600d0c52f">
  93. <img alt="Watch hello-world" src="examples/_previews/hello-world.jpg" width="640" />
  94. </a>
  95. #### [arm](examples/arm)
  96. An animated robo arm movement video using 3D capabilities.
  97. <a href="https://github.com/user-attachments/assets/f752ebc6-6d7c-4304-abb6-27becc64801c">
  98. <img alt="Watch arm" src="examples/_previews/arm.jpg" width="640" />
  99. </a>
  100. #### [signal-lab](examples/signal-lab)
  101. A 24 second motion study: product UI, data storytelling and a technical explainer.
  102. <a href="https://github.com/user-attachments/assets/d03e5fe7-4782-4a67-9571-e435ed367477">
  103. <img alt="Watch signal-lab" src="examples/_previews/signal-lab.jpg" width="640" />
  104. </a>
  105. #### [beta](examples/beta)
  106. A complicated multi-scene example (our beta announce video).
  107. <a href="https://github.com/user-attachments/assets/fee736cc-e6e4-4ad6-b2a8-ca2ad287ab53">
  108. <img alt="Watch beta" src="examples/_previews/beta.jpg" width="640" />
  109. </a>
  110. #### [marketing](examples/marketing)
  111. Our announcement video from 2021. With audio visualization.
  112. <a href="https://github.com/user-attachments/assets/963e7f80-e13a-44a2-95de-63684e175006">
  113. <img alt="Watch marketing" src="examples/_previews/marketing.jpg" width="640" />
  114. </a>
  115. #### [shaders](examples/shaders)
  116. GPU shader layers composed with SVG: an SkSL background and a Shadertoy raymarcher clipped into a card.
  117. <a href="https://github.com/user-attachments/assets/2a97f8d0-abb9-4b24-9149-cde560b1efcb">
  118. <img alt="Watch shaders" src="examples/_previews/shaders.jpg" width="640" />
  119. </a>
  120. #### [shader-mode](examples/shader-mode)
  121. A 31-second shader promo with reference audio, a moving panel wall, native preview footage and 18 GPU shader programs, rendered with Skia on Metal or Vulkan.
  122. The preview is silent: its soundtrack is not in the repository.
  123. <a href="https://github.com/user-attachments/assets/53bed61f-6478-471b-81c1-125a3054ee18">
  124. <img alt="Watch shader-mode" src="examples/_previews/shader-mode.jpg" width="640" />
  125. </a>
  126. #### [neon-triangle](examples/neon-triangle)
  127. A minimal shader clip built to make banding and motion artifacts easy to spot.
  128. <a href="https://github.com/user-attachments/assets/8f15791f-0dc4-4589-bec4-c63e4ec0f912">
  129. <img alt="Watch neon-triangle" src="examples/_previews/neon-triangle.jpg" width="640" />
  130. </a>
  131. #### [svg-in-3d](examples/svg-in-3d)
  132. An svgr UI on the screen of a turning 3D monitor, showing a 3D cube with the svgr logo: four nested levels of SVG and 3D that never leave the GPU.
  133. <a href="https://github.com/user-attachments/assets/09432a37-4bd9-42ac-b068-ce92f59695af">
  134. <img alt="Watch svg-in-3d" src="examples/_previews/svg-in-3d.jpg" width="640" />
  135. </a>
  136. #### [captions](examples/captions)
  137. A showcase of different effects available for `Captions` module in fframes
  138. <a href="examples/_previews/captions.png">
  139. <img alt="Caption presets and custom word highlights" src="examples/_previews/captions.png" width="640" />
  140. </a>
  141. #### [audio-announce](examples/audio-announce)
  142. Beautiful sound waves audio visualization + subtitles for your video.
  143. <a href="https://github.com/user-attachments/assets/2b6706b8-562d-41fe-97aa-cc8198980001">
  144. <img alt="Watch audio-announce" src="examples/_previews/audio-announce.jpg" width="640" />
  145. </a>
  146. #### [podcast](examples/podcast)
  147. An audio visualization for a podcast placeholder video.
  148. <a href="https://github.com/user-attachments/assets/602f32c6-4c4c-4d07-b5e9-da5e9dfe80ad">
  149. <img alt="Watch podcast" src="examples/_previews/podcast.jpg" width="640" />
  150. </a>
  151. #### [teej-podcast](examples/teej-podcast)
  152. Teej's podcast with 2 speakers video and chapters visualization.
  153. <a href="https://github.com/user-attachments/assets/fb57ae04-f908-4787-9ef0-bd440d36b1a4">
  154. <img alt="Watch teej-podcast" src="examples/_previews/teej-podcast.jpg" width="640" />
  155. </a>
  156. #### [tiktok](examples/tiktok)
  157. A TikTok-like vertical video with audio visualization
  158. <a href="https://github.com/user-attachments/assets/20dda3c9-8c44-4ea9-9663-860527d635be">
  159. <img alt="Watch tiktok" src="examples/_previews/tiktok.jpg" width="240" />
  160. </a>
  161. #### [lottie](examples/lottie)
  162. An 18 second vertical launch video for Lottie support: every animation is a Lottie file and the music is synthesized in Rust.
  163. <a href="https://github.com/user-attachments/assets/3736d334-624b-42b5-870d-0afd39cfe3ff">
  164. <img alt="Watch lottie" src="examples/_previews/lottie.jpg" width="240" />
  165. </a>
  166. #### [conference-splash-screen](examples/conference-splash-screen)
  167. One splash screen per conference talk, rendered in batch.
  168. <a href="https://github.com/user-attachments/assets/066d349e-aad6-4d03-b76b-25ad8ccdf8eb">
  169. <img alt="Watch conference-splash-screen" src="examples/_previews/conference-splash-screen.jpg" width="640" />
  170. </a>
  171. #### [low-poly-art](examples/low-poly-art)
  172. A renderer stress test: animal art with a lot of polygons.
  173. <a href="https://github.com/user-attachments/assets/71f0b506-e37b-4e56-8064-b9bbc57cdfad">
  174. <img alt="Watch low-poly-art" src="examples/_previews/low-poly-art.jpg" width="640" />
  175. </a>
  176. #### [pixel-memory](examples/pixel-memory)
  177. My dog's memorial video generator (totally randomized).
  178. <a href="https://github.com/user-attachments/assets/fdddfc5e-72f2-4e5f-8ebe-892b9025ee1f">
  179. <img alt="Watch pixel-memory" src="examples/_previews/pixel-memory.jpg" width="640" />
  180. </a>
  181. ## Without an agent
  182. ```sh
  183. cargo install --locked cargo-fframes
  184. cargo fframes new my-video
  185. cd my-video && cargo run --release -- preview
  186. ```
  187. From this repository, preview any example with `just preview <example>`:
  188. ```sh
  189. just preview hello-world
  190. just preview teej-podcast --software-decode
  191. ```
  192. The preview timeline sits below landscape and square videos and to the left of portrait videos.
  193. Drag the filmstrip to scrub, or click a scene marker to pause on its first frame. Use `[` and `]`
  194. to jump between scenes and `,` and `.` to step one frame. Press `Space` to play or pause, or `T`
  195. to hide the timeline and expand the video.
  196. On macOS the studio tries VideoToolbox for supported source videos and falls back to software
  197. for unsupported formats. `preview --software-decode` uses the CPU for decoding while keeping
  198. the selected drawing backend. Playback and filmstrip workers release idle source decoders.
  199. The GPU preview draws each scene through Skia directly into the window drawable or swapchain.
  200. The default buffer holds up to four prepared scene trees, and only the frame under the pointer
  201. is prepared while you drag the timeline. Decoders reuse the pixel buffers of frames that no
  202. scene tree holds any more. The CPU backend draws directly into the window buffer.
  203. `cargo fframes new` takes `--template single-scene|multi-scene`, `--format landscape|portrait|square|uhd`, `--fps`,
  204. `--title` and `--backend`. On macOS and Linux (arm64, x86_64) the first build downloads prebuilt Skia and ffmpeg
  205. libraries and takes under a minute on a fast machine; other targets and feature combinations
  206. compile them from source (up to ~20 minutes). Later builds take seconds. `--backend cpu` skips Skia (no preview window, slower renders). To track `main`, install with
  207. `--git https://github.com/dmtrKovalenko/fframes`.
  208. ## Requirements
  209. [Rust](https://www.rust-lang.org/learn/get-started) and, for working on the editor, [NodeJS](https://nodejs.org/en/download/).
  210. fframes links ffmpeg's libav libraries statically. A prebuilt build is downloaded for macOS and Linux (arm64 and x86_64) and
  211. compiled from source for other targets or `FFMPEG_FORCE_BUILD=1`; either way the system encoders they link against have to be installed.
  212. The examples enable `fframes/build-portable` on native non-Windows targets. CI builds the
  213. whole workspace, combining the examples' x264, x265, VPX and Opus features; no published
  214. FFmpeg archive currently matches that combination, so it falls back to a source build.
  215. Without `build-portable`, that build uses `-march=native -mtune=native`. Caching it and
  216. restoring it on a runner with a different CPU can cause `SIGILL` (illegal instruction).
  217. The feature omits those flags for source builds while keeping matching prebuilt downloads
  218. enabled, and also applies to FFmpeg used by the compile-time media macro.
  219. Within this workspace, use the same setting for native builds that will be cached or run on
  220. other machines:
  221. ```toml
  222. [target.'cfg(not(any(target_arch = "wasm32", windows)))'.dependencies]
  223. fframes = { workspace = true, features = ["build-portable"] }
  224. ```
  225. `build-portable` also enables FFmpeg's source-build support, so the examples exclude Windows
  226. (which links a shared FFmpeg installation) and browser targets. Setting `FFMPEG_MARCH` or
  227. `FFMPEG_MTUNE`, even to an empty string, bypasses prebuilt downloads; prefer the feature when
  228. you want portable source fallbacks and prebuilt downloads.
  229. <details>
  230. <summary><b>macOS</b></summary>
  231. ```sh
  232. brew install pkg-config ffmpeg x264 x265 opus nasm ninja
  233. ```
  234. </details>
  235. <details>
  236. <summary><b>Linux</b></summary>
  237. for debian based distros:
  238. ```sh
  239. sudo apt-get install -y yasm nasm ffmpeg libx264-dev libx265-dev libopus-dev libclang-dev clang ninja-build libvpx-dev libasound2-dev
  240. ```
  241. for arch based distros:
  242. ```sh
  243. sudo pacman -S ninja yasm nasm ffmpeg x264 x265 opus clang
  244. ```
  245. for nix users:
  246. ```sh
  247. nix-shell
  248. ```
  249. </details>
  250. <details>
  251. <summary><b>Windows</b></summary>
  252. On Windows ffmpeg is not compiled from source. Instead fframes links a prebuilt **FFmpeg 9.0** shared build
  253. (for example `ffmpeg-n9.0-latest-win64-gpl-shared-9.0.zip` from [BtbN/FFmpeg-Builds](https://github.com/BtbN/FFmpeg-Builds/releases/tag/latest))
  254. and needs LLVM for bindgen:
  255. ```powershell
  256. winget install LLVM.LLVM
  257. # unzip the ffmpeg build somewhere, then point the build to it:
  258. $env:FFMPEG_DIR = "C:\ffmpeg-n9.0-latest-win64-gpl-shared-9.0"
  259. $env:LIBCLANG_PATH = "C:\Program Files\LLVM\bin"
  260. # the ffmpeg DLLs must be reachable when building (proc macros load them) and running
  261. $env:PATH = "$env:FFMPEG_DIR\bin;$env:PATH"
  262. ```
  263. `vcpkg install ffmpeg` works as well instead of `FFMPEG_DIR`. Codecs come from the prebuilt build, so leave the
  264. codec features (`h264`, `h265`, ...) off: they request a from-source ffmpeg build which is not supported on Windows.
  265. </details>
  266. <details>
  267. <summary><b>Codecs</b></summary>
  268. Cargo features of the `fframes` crate choose which codecs and hardware acceleration libraries are linked:
  269. ```toml
  270. [dependencies]
  271. # this will enable and try to link libx264 during the build
  272. fframes = { version = "1", features = ["h264", "libav-agree-gpl"] }
  273. ```
  274. All the build and linking of codecs and other system libs are leveraging the ffmpeg build system, so for
  275. troubleshooting please refer the [ffmpeg compilation guide](https://trac.ffmpeg.org/wiki/CompilationGuide).
  276. </details>
  277. <details>
  278. <summary><b>Troubleshooting</b></summary>
  279. - **Build fails in `ffmpeg-sys-fframes`:** a system library from the list above is missing (`nasm`, `pkg-config`, the codec packages).
  280. - **Build fails in the Skia bindings with a bindgen or libclang error** (only when Skia is compiled from source, e.g. with
  281. both `metal` and `vulkan` enabled): point `LIBCLANG_PATH` at a working libclang,
  282. on macOS Xcode's: `export LIBCLANG_PATH=$(xcode-select -p)/Toolchains/XcodeDefault.xctoolchain/usr/lib`.
  283. - **Text renders in the wrong font:** `inspect` reports `No match for ... font-family`; put the font file in the
  284. project's `media/` folder and use its exact family name.
  285. </details>
  286. ## Working on fframes
  287. Agents working on fframes itself should start from [AGENTS.md](AGENTS.md). For humans, install the
  288. [just](https://github.com/casey/just) command runner and init the repo:
  289. ```bash
  290. npm install --global pnpm # the package manager for the nodejs based editor
  291. cargo install --locked just cargo-watch wasm-bindgen-cli wasm-pack
  292. just init-repo
  293. just watch-editor # in a separate terminal, to work on the editor
  294. ```
  295. ## License
  296. fframes is released under the [MIT License](./LICENSE.txt).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.