wtf is cinematic-choreography?

Cinematic Choreography is a visual tool built with Three.js and React that lets you design camera movements in the style used by directors like Spielberg or Michael Bay, but without needing an actual film crew or camera. Instead of real people, the tool uses simple capsule shapes as stand ins for the subjects being filmed, and you use those placeholders to plan out a full cinematic camera path around them. The tool offers two main ways of looking at your scene. Camera mode shows you what the final rendered shot will actually look like, with each subject's name tag stuck to its surface and always facing the camera. Overview mode instead shows the whole space from above, including a black line marking the path the camera is about to travel along and a small model representing the camera itself. The two modes can switch back and forth automatically after each full pass, and in overview mode the camera can automatically circle the scene on its own. The camera motion itself follows a three part timeline built with the GSAP animation library, moving in close for a starting pose, having the subject rise, sweeping around them in an arc, and then pulling back to reveal the whole group. You can also add background music, which stays synced to the timeline no matter where you drag the playback position. Once a full pass is set up the way you want, you can export it as a recorded video in either 4K or 1080p resolution, camera view included, with the music baked in. To run it locally you install dependencies with bun or npm and start the development server. Although the project started from a Google AI Studio template and still carries some leftover dependencies from that, the tool itself runs entirely in the browser and does not need any API key to work. Deployment is set up for Cloudflare Pages, and there is also a sample command for converting the exported video into a standard mp4 file afterward.