Bring Your Own AI to the Movies
It lets filmmakers systematically dissect narrative shot-by-shot using their own AI, without ever uploading a frame to a server.

What it does
Lapian Notes ingests a local video file, extracts one frame per second, and builds a browsable timeline with subtitles. You export a ZIP of frames and prompts to any AI you like, then import the returned JSON to generate a swimlane plot timeline, narrative structure tree, and audience emotion curve. Everything stays in the browser—video data never leaves your machine.
The interesting bit
The tool deliberately avoids API integrations. Instead, it orchestrates a manual “bring your own AI” loop: package the frames, let the model reason externally, then re-import the structured analysis. This sidesteps API keys and cloud bills, though it also means you are at the mercy of your chosen model’s attention span. The README candidly warns that free-tier AIs often “cheat” by sampling only a handful of frames from a 6,000-plus sequence.
Key highlights
- Fully local operation: frames live in
IndexedDB, notes inlocalStorage; no server upload - Swimlane timelines adapt to each film’s specific plot threads, with cross-referenced segments
- Tight player integration: click any timeline point to jump playback, or play a segment until its end
- Automatic subtitle fetching from pseudo-shooter for Chinese titles or OpenSubtitles for foreign titles
- Exports notes as Markdown, script text, or a shareable long image of the full swimlane
Caveats
- Auto-transcoding and auto-subtitle search require the dev server; static builds downgrade both to manual steps
- Browser security rules mean a page refresh forces you to re-select the video file to rebuild the frame index
- Free AI tiers may return sparse, lazy analyses unless explicitly prodded to process every frame
Verdict
Film students, screenwriters, and video essayists who want granular, AI-assisted narrative analysis without cloud dependencies should try this. If you need turnkey automation or cloud-synced collaboration, look elsewhere.
Frequently asked
- What is bkingfilm/lapian-notes?
- It lets filmmakers systematically dissect narrative shot-by-shot using their own AI, without ever uploading a frame to a server.
- Is lapian-notes open source?
- Yes — bkingfilm/lapian-notes is open source, released under the MIT license.
- What language is lapian-notes written in?
- bkingfilm/lapian-notes is primarily written in TypeScript.
- How popular is lapian-notes?
- bkingfilm/lapian-notes has 515 stars on GitHub.
- Where can I find lapian-notes?
- bkingfilm/lapian-notes is on GitHub at https://github.com/bkingfilm/lapian-notes.