This program goes through your movie collection (folders or files within a directory) and gathers extra information about each movie using a third party API.

It generates a nice looking webpage which includes a sortable table containing each movie's title, cover image, etc. It also creates coverflow style view of your movie collection ordered by IMDB Rating.

...This is still very much a work in progress.

There are two motivations which drove the initial development of this project. Firstly I had access to too many movies which were of very varying quality. I needed a way of quickly sorting them in some kind of meaningful way to avoid watching the terrible ones first. I decided that sorting them by their IMDB rating would be the most efficient way to achieve this. Secondly I thought it would be a fun, bite-sized project to make open-source and allow others to contribute to.

Initially I wrote the whole script in a few hours in one relatively simple and yet long file. After I got it working I thought it would be nice to improve it, move to an OOP paradigm and share it with others. It still requires a lot of improvement and would be perfect for someone starting out their "open-source career" to get involved with.

• 0.7
  • Local Caching
  • Various Improvements
• 0.6
  • Erroneous Title Correction
  • CoverFlow View
  • Added Some Unit Tests
• 0.5 Stable Release
• 0.4 Beta

• python 2.7+
• jinja2 (sudo pip install jinja2)

You can install the package by running this command:

sudo python setup.py install

Once you have installed the package you can run the program using:

movieinfo

Alternatively you can just run the program using python directly if you don't want to install the package:

python ./src/main.py

See the usage examples below to understand how to run the program correctly.

If you haven't installed the package replace "movieinfo" with "python ./src/main.py"

movieinfo -h (help)
movieinfo -v (version)

movieinfo -d ./tests/testMovieDirectory     -html -limit 500    > example-output.html
movieinfo -d ./tests/testMovieDirectory     -l 900              > example-output.txt

movieinfo -dir /Volumes/My_Book/Movies      -html               > example-output.html
movieinfo -dir /Volumes/KIM/TV Shows        -html -limit 500    > example-output.html

The most important part is the directory where your movies are stored. They can be files or folders within that directory.

"> example-output.html" will save all of the output of the program to a file named "example-output.html" in the current directory. You can then open this file to view the generated content.

You can also generate some example HTML output by running the following script:

./generate_example_html.sh

To run the tests (these aren't finished) run this script:

./run_tests.sh

• Make HTML Pretty
• Cleanup the code
• Finish writing the unit tests
• Cache Lookups Locally (maybe using a pickle?)
• Write the Wiki
• Recommend Movies (Machine Learning)
• Integrate some other APIs?
• And more...

I would love it if you would contribute to this small project! Please read the contributing guidelines and get started.

Get in touch: kimbratzel.com