Vogon combines a video creative, a data table(Feed) and a layout specification, generating a copy of the video creative combined with each line of the data table according to the layout specification.
The data can contain text, images and videos. The specification determines the timing, position and font definitions for each piece of text, video and image, referencing data fields through their names. Fixed text can also be used in the layout specification.
The generated videos are (optionally) uploaded to a Youtube channel, and a Google Ads Campaign specification file is generated to be imported in Google Ads for Video, creating keyword/audience/interest/geo-targeted campaigns for each of the videos.
This is not an official Google product.
This tutorial will help you get Vogon up and running on your own infrastructure.
It goes as follows:
We have main steps here:
Installation should cover following packages:
APIS should be:
We got two flavors here:
But have fun installing where ever you may seen fit :)
Depending on the distro, the set of commands to install all required dependencies shall look like this:
# install ffmpeg * imagemagik
sudo apt-get install ffmpeg;
sudo apt-get install imagemagick;
# install GIT
sudo apt-get install git;
# install python3 and pip3
sudo apt-get -y install python3-pip;
# install python libs
pip3 install --upgrade google-api-python-client;
pip3 install --upgrade oauth2client;
pip3 install --upgrade bottle;
pip3 install --upgrade retry;
pip3 install --upgrade http.client;
pip3 install --upgrade httplib2;
# Download Vogon code
cd {YOUR_VOGON_APP_DIR};
git clone https://github.com/google/vogon.gitDepending on the OS X version, the set of commands to install all required dependencies shall look like this:
# install home brew
xcode-select --install
sudo easy_install pip
sudo pip install --upgrade pip
ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"
# install ffmpeg * imagemagik
brew install ffmpeg;
brew install imagemagick;
# install GIT
brew install git;
# install python3 and pip3
brew install python
brew install python3
# install python libs
pip3 install --upgrade google-api-python-client;
pip3 install --upgrade oauth2client;
pip3 install --upgrade bottle;
pip3 install --upgrade retry;
pip3 install --upgrade http.client;
pip3 install --upgrade httplib2;
# Download Vogon code
cd {YOUR_VOGON_APP_DIR};
git clone https://github.com/google/vogon.gitVogon uses two main APIs to run smoothly:
This API is used to upload Videos generated by Vogon to Youtube, making it possible to run ads on them.
This API is used to read and update Vogon feed.
Your app credentials folder should look something like this
cd {YOUR_VOGON_APP_DIR};
python3 server.py --debugCheck User Manual PDF :)
In a nutshell: jpg, gif & png. Animated or not, with transparent background or not.
Yes! you have to set the animated gif overlay FADE-IN and FADE-OUT to zero "0" so that Vogon can understand that your gif might be animated.
Yes. Just add them as any other image.
Kinda... You can add the base video with a MUTED soundtrack(it has to have an audio track) and add other video overlays with the audio track you want for each variation.
Nope... Text overlays always stay on top of image or video overlays.
Docker ascii erros?
Remeber to set ENV LANG C.UTF-8 on your docker file ;)
Imagemagick erros(convert command pointing out erros on your logs)?
Try one of the following:
imagemagick file policy:cd /etc/ImageMagick-6 #might vary a little depending on ImageMagick version)
sudo nano policy.xml@*. Should be something like this:<policy domain="path" rights="none" pattern="@*" />sudo apt-get install libfreetype6;
sudo apt-get install imagemagick;sudo apt-get install libfreetype6cd <imagemagick/install/dir>
make uninstall && make distclean./configure run it like this: ./configure --with-prefix=/usr/local/bin