Never Pummel Muskoxen

    TypeScript icon, indicating that this package has built-in type declarations

    1.0.0 • Public • Published


    CLI tool for generating a color composition of a movies colors, inspired by The tool generates a linear arrangement of color stripes, each strip representing the average of several frames within the movie, ordered by timestamp. The result visualizes the tone and ambience of the movie, as well as its progress.

    This image is the result for the last Harry Potter movie. Some segments are easily mappable to specific segments of the movie, such as the orange segment in the middle which was generated from the fire in the room of requirements, or the bright whitish area at the end generated from the segment when Harry met dead Dumbledore at Kings Cross.

    More examples are available below.


    There exist several similar projects already. This project is written as a NPM package, which means you can just run it in your command line with only NodeJS and FFMPEG installed. Additionally, it works on arbitrarily many movies, so you can start a batch of several movies at once and have images generated from all of them. Finally, this project splits the process of computing the colors from an video file, and generating the resulting image, into distinct commands. You can extract the colors from a movie once into a JSON file (which is the long part), and then generate multiple image formats from them with a different command. You can specify the exact dimensions of the image and whether it should be generated horizontally or vertically.


    Install NodeJS and FFMPEG globally. Then, invoke npx movie-color-strip.

    Usage: npx movie-color-strip [options] [command]
    -V, --version             output the version number
    -h, --help                display help for command
    parse-movie [options]
    generate-image [options]
    help [command]            display help for command

    First, call npx movie-color-strip parse-movie to generate color files from movies. This might take a significant amount of time (~30 minutes per movie). This will be computed for every movie detected by the glob supplied via --movies (defaults to ./movies/**/*.mkv).

    Usage: npx movie-color-strip parse-movie [options]
    -t, --tmp-dir <directory>    Temporary directory for storing image files (default: "./tmp")
    -o, --out <filename>         Output filename, must be .json (default: "./{moviename}.colors.json")
    -n, --name <name>            Movie name, will be encoded into json file (default: "{moviename}")
    -m, --movies <glob>          Glob for finding movies (default: "./movies/**/*.mkv")
    -f, --every-frames <frames>  How often to grab a frame from the movie, i.e. every n frames. (default: "120")
    -h, --help                   display help for command

    Then, call npx movie-color-strip generate-image to create image files from the resulting color files.

    Usage: npx movie-color-strip generate-image [options]
    -f, --files <glob>        JSON Color files glob (default: "./**/*.colors.json")
    -w, --width <size>        Output image width (default: "800")
    -h, --height <size>       Output image height (default: "300")
    -x, --orientation <size>  Output orientation, either "horizontal" or "vertical" (default: "horizontal")
    -o, --output <name>       Output name, must be .png (default: "./{name}.png")
    --help                    display help for command


    Harry Potter and the Philosophers Stone

    Harry Potter and the Chamber of Secrets

    Harry Potter and the Prisoner of Azkaban

    Harry Potter and the Goblet of Fire

    Harry Potter and the Order of the Phoenix

    Harry Potter and the Half Blood Prince

    Harry Potter and the Deathly Hollows 1

    Harry Potter and the Deathly Hollows 2




    npm i movie-color-strip

    DownloadsWeekly Downloads






    Unpacked Size

    58.2 kB

    Total Files


    Last publish


    • lukasbach