Frames2Osb

Converts frames (or video) to osu!storyboard. It is also the storyboard generator for this thing.

Requirements

• Python 3.8
• Ffmpeg
• Pillow
• numpy
• typed-argument-parser

To install, simply do the following command:

poetry install

Generating

$ frames2osb

CLI Usage

usage: frames2osb [--video VIDEO] [-h] {pixels,quadtree} ...

positional arguments:
  {pixels,quadtree}
    pixels           Generate storyboard using pixel by pixel.
    quadtree         Generate storybord using quadtree.

optional arguments:
  --video VIDEO      (Optional[str], default=None)
  -h, --help         show this help message and exit

Pixels

usage: frames2osb pixels [--jobs JOBS] [--splits SPLITS] [--fps FPS] [--precision PRECISION] [--offset OFFSET] [--only_generate] [--use_rgb]
                         [-h]
                         size outfile

Generate storyboard using pixels method.

positional arguments:
  size                  Size of each square in storyboard.
  outfile               Output .osb filename.

optional arguments:
  --jobs JOBS           (int, default=2) Number of threads to spawn.
  --splits SPLITS       (int, default=16) Number of splits to generate.
  --fps FPS             (int, default=30) Set storyboard's FPS.
  --precision PRECISION
                        (int, default=1) Transparency precision level.
  --offset OFFSET       (int, default=1) Set storyboard's offset.
  --only_generate       (bool, default=False) Only generate storyboard.
  --use_rgb             (bool, default=False) Use RGB instead of alpha value.
  -h, --help            show this help message and exit

Quadtree

usage: frames2osb quadtree [--jobs JOBS] [--splits SPLITS] [--fps FPS] [--precision PRECISION] [--offset OFFSET] [--only_generate]
                           [--use_rgb] [-h]
                           {1..8} outfile

positional arguments:
  {1..8}                Numbers of depth in QuadTree function.
  outfile               Output .osb filename.

optional arguments:
  --jobs JOBS           (int, default=2) Number of threads to spawn.
  --splits SPLITS       (int, default=16) Number of splits to generate.
  --fps FPS             (int, default=30) Set storyboard's FPS.
  --precision PRECISION
                        (int, default=1) Transparency precision level.
  --offset OFFSET       (int, default=1) Set storyboard's offset.
  --only_generate       (bool, default=False) Only generate storyboard.
  --use_rgb             (bool, default=False) Use RGB instead of alpha value.
  -h, --help            show this help message and exit