Star Wars DOT Gif

Quickstart

Setup

Copy the contents of config.cfg.example into config.cfg and make sure to change the relevant paths for VLC or ffmpeg and the Star Wars episodes. Any format that can be read by VLC or ffmpeg should be acceptable for the movies. Note, if you don't plan on running the twitter bot you only need to fill out the general section of the cfg file.

Install python requirements:

pip install -r requirements.txt

Verify you have either vlc or ffmpeg installed (we just need one of both):

$ whereis vlc
vlc: /usr/bin/vlc /usr/lib64/vlc /usr/share/vlc /usr/share/man/man1/vlc.1.gz
$ whereis ffmpeg
ffmpeg: /usr/bin/ffmpeg /usr/share/ffmpeg /usr/share/man/man1/ffmpeg.1.gz

Usage

To Run with search UI (sample run)

By default the gif is created as star_wars.gif

python star_wars_gif.py

To get a random gif

python makeGifs.py

Embedding in another python-script

If you want to use makeGifs elsewhere use:

from makeGifs import makeGif
# source should be a slug from config.cfg
# index is the index of the quote in the SRT
# for more options see makeGifs.py
makeGif(source, index)

Running the twitter bot

make sure you create API accounts for both twitter and imgur
update config.cfg to have the keys for both
run python twitter_bot.py

The bot will tweet once every hour.

Notes

if you know what a virtualenv is, we recommend you use one
for more options on creating gifs, please read the embbeded documentation

In detail

It is assumed you have virtualenv installed. If not, it is not very difficult to install or use and will keep your system-python free of fancy packages we are using here.

Requirements

python (tested with 2.7 and 3.6)
ffmpeg or vlc
video-files for movies/videos you want to extract from

Setup Procedure

Create a virtalenv and install python requirements:

cd starwars-dot-gif
virtualenv .env
source .env/bin/activate
(.env)$ pip install -r requirements.txt

Now copy the example config provided and edit with your favourite editor:

cp config.cfg.example config.cfg
vim config.cfg

You must set a path for vlc or ffmpeg, if both are set, ffmpeg will be preferred over vlc. Setting 'vlc' or 'ffmpeg' instead of a path is acceptable if those are executable as-is on your system.

The repository currently includes subtitles for Star Wars episode IV to VIII, you are free to add more video-files with corresponding subtitles (see config.cfg.example). It is recommended that you remove any entires which you do not want to use from the videos-list in the config.

To test the configuration you may run the script with the --help-option, which will give you an extensive explanation of options.

(.env)$ python makeGifs.py --help
usage: makeGifs.py [-h] [--movie [MOVIE [MOVIE ...]]] [--index [INDEX]]
...

Detailed Usage

You may use the script with your config.cfg either with an interactive commandline-tool or directly pass options on the commandline.

Commandline-tool

The commandline-tool has a GUI of sorts and allows you to search in the subtitles. This allows you to look for specific words or quotes you are looking for.

(.env)$ python star_wars_gif.py

This script will ignore any arguments passed to it.

Direct

The direct method can be called from the commandline or from another python script. These options are nearly equally powerful. Using the commandline you may pass any number of options (call with --help to see all of them).

The following command will create a gif with the quote "Aren't you a little short for a stormtrooper?".

(.env)$ python makeGif.py --movie hope --index 848

Now adding some options:

(.env)$ python makeGifs.py --movie hope --index 848 --padding 0 0.6 --subtitle "I have been expecting you"

This added 0.6 seconds (and a confused Luke) to the end of the gif and changed the rendered subtitle to "I have been expecting you". As previously mentioned there are many more options available.

When called from python usage follows a general pattern:

from makeGifs import makeGif
# source should be a slug from config.cfg
# index is the index of the SRT
# for more options see makeGif.py
makeGif('hope', 848, padding=[0, 0.6], custom_subtitle="I have been expecting you", filename="say_what.gif")

This example will reproduce the above shell example and save it as "say_what.gif". Feel free to try this example in ipython.

derdritte/starwars-dot-gif