Skip to content

README.md

Latest commit

 

History

History
163 lines (114 loc) · 4.07 KB

README.md

File metadata and controls

163 lines (114 loc) · 4.07 KB

Video-Code

The initial goal of this project is to create videos from code.
I've always wanted to create millimetric videos and I will be able to, soon enough.

The second thought is that such thing can be used to automate the generation of video.
AI have a hard time with designs, they are better with code, they could potentially take advantage of this project to generate videos with a good quality and a logical flow.

Thirdly, I want the program to have a visual interface like any other video editing app but I want it to be automatically generated from the Python API.
With a code and a visual interface, anyone can make videos according to their liking.

Below is an example of the last feature added (code) and the result (video).

#!/usr/bin/env python3


from videocode.videocode import *

# Display the same image three times: left light sharpen, center original, right strong sharpen
img_soft_sharpen = image("../test.png").position(x=-4, y=0).scale(0.5).apply(sharpen(0.3), duration=2)

img_center = image("../test.png").position(x=0, y=0).scale(0.5)

img_strong_sharpen = image("../test.png").position(x=4, y=0).scale(0.5).apply(sharpen(1.0), duration=2)

Getting Started

To create a video with Video-Code, you need to write some simple code in Python.

The flow of the Video comes from the Inputs that you, first create, then modify with Transformations and finally add to the timeline.

To create an Input, use one the methods created according to what you need, it can be a video, an image or a text, etc...
To modify it, you need to use Transformations like moveTo or scale.
To add the frames of the Input to the timeline, use the <Input>.add() function.

Installation

To install the project, checkout the documentation.

Patch Notes

Inputs
  • image
  • video
  • webImage

  • circle
  • rectangle
  • square
  • line

  • text

  • group

Transformations
  • position
  • align
  • rotate
  • scale
  • args
  • hide
  • show

Shaders
  • grayscale
  • opacity
  • blur
  • gamma
  • grain
  • brightness
  • contrast
  • sharpen

Effect Templates
  • moveTo
  • moveBy

  • scaleTo
  • scaleBy

  • fadeIn
  • fadeOut

Patchs
  • feature: start and duration of transformation (08/04/25)
  • rework: inputs are kept on the video by default (08/04/25)
  • feature: wait -> freeze the screen for the duration (08/04/25)
  • transformation: setPosition (08/04/25)
  • rework: move -> moveTo (08/04/25)
  • input: group (08/04/25)
  • input: rectangle (24/03/25)
  • input: circle (24/03/25)
  • transformation: scale (20/03/25)
  • transformation: zoom (19/03/25)
  • rework: effects' duration (19/03/25)
  • transformation: grayscale (19/03/25)
  • feature: keep last frame of input on screen (06/03/25)
  • rework: one stack (06/03/25)
  • transformation: repeat (03/03/25)
  • input: text (03/03/25)
  • rework: position of the frames (02/03/25)
  • transformation: move (02/03/25)
  • feature: setters (update in real time the proportions of a shape) (20/09/25)
  • fix: different framerate between the window and the generated video
  • feature: image from url
  • rework: moveTo
  • rework: scale
  • feature: persistent transformations
  • input: line (01/01/2026)
  • transformation: align, args, hide, position, rotate, scale, show => basic transformation (01/01/2026)
  • template: moveTo, moveBy, scaleTo, scaleBy, fadeIn, fadeOut => effect overtime that are smooth (01/01/2026)
  • feature: flush => prevents effects to be applied at the same time (01/01/2026)
  • feature: frames are not kept in memory anymore, they are generated on the fly. (01/01/2026)