VGrade Project

A Simple High Quality Video Grading System

[ Home ]       [ Example Videos ]       [ Usage ]       [ Installation ]       [ Download ]       [ Presentations ]       [ Contact ]

Installation

Prerequisites

You need a decent Linux installation with an up-to-date set of standard tools.

For running VGrade you need in particular:

For the hand-grading we recommend geeqie and gimp.

For handling LUTs you need opencolorio-tools.

Download

Download the scripts from the download page and install them to a directory in your path. Put the library vgradeutils in a directory of your choice.

Configuration

Adapt vgrade

We recommend to edit the line 


	source /usr/share/vgrade/lib/vgradeutils || exit 17
in the file vgrade to contain the path to your vgradeutils file.

LUTs

You must create your own HaldC-LUTs. If you have LUTs in other formats, you may use commands like 


	ociobakelut --format flame --lut MyLut.cube MyLut.3dl

	ffmpeg -f lavfi -i haldclutsrc=8 \
		-vf lut3d=MyLut.3dl:interp=trilinear \
		-frames:v 1 -f image2 -pix_fmt rgb24 MyLut.png
to e.g. generate MyLut.png. You may define aliases for your LUTs (i.e. HaldC-LUTS). Simply put lines like 

	MYLUT=/path/to/MyLut.png
in your $HOME/.vgrade.luts.conf or - for system-wide definitions - in /etc/vgrade/luts.conf. After that you may use the term MYLUT in the LUT command of your video script.

Geeqie Integration

If you want to use hand-grading, you need to integrate foto_Video into your Geeqie menue. For other image viewers this may work similarly, in general you just need an image viewer that allows integration of self-written scripts.

For Geeqie edit the following files:

$HOME/.config/geeqie/applications/theMVideoGrad.desktop:


	[Desktop Entry]
	Version=1.0
	Type=Application
	Name=__theM VGrade Apply LUT gradually
	GenericName=__theM VGrade Apply LUT gradually
	Comment=theM VGrade Apply LUT gradually
	Exec=foto_Video gradient "%U"
	TryExec=xterm
	Icon=gimp
	Terminal=false
	Categories=Graphics;2DGraphics;RasterGraphics;GTK;
	StartupNotify=true
	MimeType=application/postscript;application/pdf;image/bmp;image/g3fax;image/gif;image/x-fits;image/pcx;image/x-portable-anymap;image/x-portable-bitmap;image/x-portable-graymap;image/x-portable-pixmap;image/x-psd;image/x-sgi;image/x-tga;image/x-xbitmap;image/x-xwindowdump;image/x-xcf;image/x-compressed-xcf;image/tiff;image/jpeg;image/x-psd;image/png;image/x-icon;image/x-xpixmap;image/svg+xml;image/x-wmf;

$HOME/.config/geeqie/applications/theMVideoLeft.desktop:


	[Desktop Entry]
	Version=1.0
	Type=Application
	Name=__theM VGrade Apply LUT (from right) to the left
	GenericName=__theM VGrade Apply LUT (from right) to the left
	Comment=theM VGrade Apply LUT (from right) to the left
	Exec=foto_Video left "%U"
	TryExec=xterm
	Icon=gimp
	Terminal=false
	Categories=Graphics;2DGraphics;RasterGraphics;GTK;
	StartupNotify=true
	MimeType=application/postscript;application/pdf;image/bmp;image/g3fax;image/gif;image/x-fits;image/pcx;image/x-portable-anymap;image/x-portable-bitmap;image/x-portable-graymap;image/x-portable-pixmap;image/x-psd;image/x-sgi;image/x-tga;image/x-xbitmap;image/x-xwindowdump;image/x-xcf;image/x-compressed-xcf;image/tiff;image/jpeg;image/x-psd;image/png;image/x-icon;image/x-xpixmap;image/svg+xml;image/x-wmf;

$HOME/.config/geeqie/applications/theMVideoRight.desktop:


	[Desktop Entry]
	Version=1.0
	Type=Application
	Name=__theM VGrade Apply LUT (from left) to the right
	GenericName=__theM VGrade Apply LUT (from left) to the right
	Comment=theM VGrade Apply LUT (from left) to the right
	Exec=foto_Video right "%U"
	TryExec=xterm
	Icon=gimp
	Terminal=false
	Categories=Graphics;2DGraphics;RasterGraphics;GTK;
	StartupNotify=true
	MimeType=application/postscript;application/pdf;image/bmp;image/g3fax;image/gif;image/x-fits;image/pcx;image/x-portable-anymap;image/x-portable-bitmap;image/x-portable-graymap;image/x-portable-pixmap;image/x-psd;image/x-sgi;image/x-tga;image/x-xbitmap;image/x-xwindowdump;image/x-xcf;image/x-compressed-xcf;image/tiff;image/jpeg;image/x-psd;image/png;image/x-icon;image/x-xpixmap;image/svg+xml;image/x-wmf;

$HOME/.config/geeqie/applications/theMVideoUniq.desktop:


	[Desktop Entry]
	Version=1.0
	Type=Application
	Name=__theM VGrade Apply LUT to ALL video
	GenericName=__theM VGrade Apply LUT to ALL video
	Comment=theM VGrade Apply LUT to ALL video
	Exec=foto_Video all "%U"
	TryExec=xterm
	Icon=gimp
	Terminal=false
	Categories=Graphics;2DGraphics;RasterGraphics;GTK;
	StartupNotify=true
	MimeType=application/postscript;application/pdf;image/bmp;image/g3fax;image/gif;image/x-fits;image/pcx;image/x-portable-anymap;image/x-portable-bitmap;image/x-portable-graymap;image/x-portable-pixmap;image/x-psd;image/x-sgi;image/x-tga;image/x-xbitmap;image/x-xwindowdump;image/x-xcf;image/x-compressed-xcf;image/tiff;image/jpeg;image/x-psd;image/png;image/x-icon;image/x-xpixmap;image/svg+xml;image/x-wmf;

Good luck and have fun. And if it works (or doesn't) don't hesitate to drop me an mail.