whatisgithub

What is lapian-notes?

bkingfilm/lapian-notes — explained in plain English

Analysis updated 2026-05-18

405TypeScriptAudience · writerComplexity · 2/5License

In one sentence

A local tool that turns a movie into an editable study notebook by extracting screenshots and subtitles, sending them to any AI chat tool, and building a plot timeline from the AI's response.

Mindmap

mindmap
  root((lapian notes))
    What it does
      Extracts movie screenshots
      Packages data for any AI
      Builds plot timeline
    Tech stack
      TypeScript and React
      Node.js runtime
      Local browser storage
    Use cases
      Study film narrative structure
      Track subplots and emotion
      Jump to noted moments
      Export notes and script
    Audience
      Screenwriters
      Film students
    Notes
      Fully local no upload
      Bring your own AI
      MIT licensed

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Break down a movie's plot structure by sending frame screenshots to an AI chat tool

USE CASE 2

Build a multi-line timeline showing a film's main plot, subplots, and emotional beats

USE CASE 3

Jump straight to any noted moment in the film while writing analysis notes

USE CASE 4

Export finished film-study notes as Markdown or a shareable timeline image

What is it built with?

TypeScriptReactNode.js

How does it compare?

bkingfilm/lapian-notestheswerd/brainlessopenclaw/clawpatch
Stars405405412
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderate
Complexity2/52/53/5
Audiencewriterdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Lapian Notes is a tool for people who want to study how movies are put together, scene by scene. It turns a film file into an editable notebook by pulling a screenshot roughly once per second through the whole movie, reading any subtitles embedded in the file or searching for them online if none are found, and packaging the screenshots and subtitles into a ZIP file. Instead of relying on a built-in AI service, the tool asks the user to hand that ZIP file to whatever AI chat tool they already use, such as ChatGPT, along with a ready-made set of instructions that gets copied automatically. No API key or paid subscription to the tool itself is required. Once the AI responds with a JSON file describing the movie's structure, the user imports that file back into Lapian Notes, which then builds a multi-line timeline of the story's different plot threads, a tree showing how scenes group into main plot, subplots, emotional beats, and information beats, and a curve estimating how engaged an audience would be at each point in the film. From there, a user can click any timestamp in their notes, a script excerpt, or a subtitle line to jump the built-in video player straight to that moment, and play just that one segment before it automatically pauses. Every segment also has an editing panel for writing notes about its purpose, key beats, and creative intent by hand. Individual segments can be sent back to the AI on their own for a more detailed shot-by-shot breakdown. Finished notes can be exported as Markdown, as script text, or as a shareable long image of the full timeline. The README warns that free AI tiers sometimes cannot handle thousands of screenshots from a full movie and may only look at a few images before responding, producing a thin result, and suggests asking the AI to redo the analysis in full or switching to a different AI if that happens. Everything runs locally in the browser, with notes saved to local storage and screenshots cached locally, so no film or note data is uploaded anywhere. The current interface is Chinese-only, though an English README is provided. It requires no programming to run, just downloading and double-clicking a startup script, and is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how Lapian Notes turns a movie into an AI analysis package I can send to ChatGPT
Prompt 2
Walk me through importing an AI's JSON response back into this tool
Prompt 3
What should I do if the AI only analyzes a few screenshots instead of the whole movie
Prompt 4
Help me set up Lapian Notes for the first time without any coding experience

Frequently asked questions

What is lapian-notes?

A local tool that turns a movie into an editable study notebook by extracting screenshots and subtitles, sending them to any AI chat tool, and building a plot timeline from the AI's response.

What language is lapian-notes written in?

Mainly TypeScript. The stack also includes TypeScript, React, Node.js.

What license does lapian-notes use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Who is lapian-notes for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.