Generates a fancy Web page from a folder with movies files.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Generates a fancy Web page from a folder with movies files.

All movies details are gathered from IMDb (cover, year, rating, plot, director, actors).


It requires jinja2 and imdbpy.

On Debian or Ubuntu, install these with

sudo apt-get install python-jinja2 python-imdbpy

On Windows, follow Czarek's tutorial.

(Help for Mac OS instructions is welcome)

Make sure you run a recent version of python-imdbpy (like > 4.8).


I have no idea what I'm doing with a python file

It is a lot more stupid that was you think ! You run it in order to generate a static .html file ! It has two files : a python file that scraps imdb and provides the input data to the other file, a template.

How do I run it on my web server ?

You run it in a command-line ! For example, in a crontab :

0 5,17 * * * /usr/bin/python /home/user/ --all /home/data/ > /var/www/index.html

You can then protect its access is protected by a basic .htaccess file.


python [options] FOLDER

  -h, --help            show this help message and exit
  -o OUTPUT, --output=OUTPUT
                        Output to file
  -a, --all             Include unknown movies
  -x EXCLUDE, --exclude=EXCLUDE
                        Exclude files or folders by name (comma-separated)
  -s MINSIZE, --minsize=MINSIZE
                        Exclude files smaller than this size (MB)
  -l LIMIT, --limit=LIMIT
                        Limit list of found filenames
                        Add a link to movie titles with this URL prefix
  -t TITLE, --title=TITLE
                        Specify page title


Add links for movies on local filesystem

python --url="file" /path/to/folder/

Add HTTP links for movies

python --url="http://server/example/" /path/to/folder/

Full example

python --all \
                         --title="Personal VOD" \
                         --exclude=".session" \
                         --url="http:/ \
                         /home/data/ > /var/www/index.html


  • Beer-ware License


Related Software

Before to start writing the first line of code, I had found these projects :

  • movie.js by Czarek Tomczak. Exactly what I needed, but Windows only.
  • Smewt a full-featured media manager in python. No static output.