Go to file
j d3a4c0a140 add dependencies to install 2023-11-18 16:30:10 +01:00
bin default to python3 2021-06-25 11:30:56 +01:00
oxtimelines Image.ANTIALIAS->Image.LANCZOS 2023-08-25 00:18:57 +02:00
.editorconfig use .editorconfig 2019-04-29 14:06:43 +02:00
.gitignore switch to git 2016-02-18 19:54:24 +05:30
README.md use markdown 2018-04-03 13:43:15 +05:30
setup.py add dependencies to install 2023-11-18 16:30:10 +01:00

README.md

oxtimelines - create timeline from video

This program takes one or more video files as input and outputs timeline images. If a cuts path is given, it also outputs a json file containing cuts. If in and out points are given, only that part of the video(s) will be rendered.

The timeline modes can be any combination of 'antialias' (average color), 'slitscan' (center pixel), 'keyframes' (one or more frames per cut), 'audio' (waveform), 'cuts' (antialias with cut detection overlay, for debugging) and 'data' (each frame resized to 8x8 px).

One or two timeline heights can be specified, larger height first. The timeline widths will be 1 px per frame for the first one, and 1 px per second for the second (smaller) one. If the wide option is set, large 'keyframeswide' tiles will be rendered. They can be used at a later point to render small 'keyframes' tiles without having to decode the video again.

Usage

usage: oxtimelines [options] video1 [video2]

Options:
  -h, --help            show this help message and exit
  -o TILES, --output=TILES
                        path for combined timeline tiles
  -c CUTS, --cuts=CUTS  path for combined cuts json file
  -p POINTS, --points=POINTS
                        inpoint,outpoint (optional)
  -m MODES, --modes=MODES
                        timeline mode(s) (antialias, slitscan, keyframes,
                        audio, cuts, data)
  -s SIZES, --sizes=SIZES
                        timeline size(s) (64 or 64,16)
  -w, --wide            keep wide frames tiles
  -l, --log             log performance

Install

pip3 install oxtimelines

Python API

import oxtimelines

timeline = oxtimelines.Timelines(videos, output, cuts_json, in_out, modes, sizes, wide, log)
timeline.render()

Latest Code

git clone https://code.0x2620.org/0x2620/oxtimelines

Dependencies

  • python-imaging
  • python-ox
  • ffmpeg