Skip to main content

Given a directory of poorly formatted movie files, `movie-file-fixer` will create a beautifully formatted library of films folders, complete with posters, subtitles, and IMDb metadata.

Project description

Current Version on PyPI PyPI Format PyPI Status Supported Python Versions Build Coverage License Code style: black GitHub Last Commit


Given a directory of poorly formatted movie files, movie-file-fixer will create a beautifully formatted directory of films folders, complete with posters, subtitles, and IMDb metadata.


Given a directory string,

  1. folderize() - Prepare the directory space.

    • Place all single files (except contents.json and errors.json) into folders using the file name. - [Folderizer]

    • Pull all subtitle files out of subs folders if they exist.

  2. cleanup() - Folder cleanup.

    • Remove non-movie files, based on a list of "bad" extensions (i.e., .nfo, .txt, etc.) - [FileRemover]
  3. format() - Format folders, movie files, and relevant metafiles based on IMDb movie titles.

    • Rename the movie file and folder (i.e., <movie_title> [<year_of_release>]) - [Formatter]

    • Create a contents.json file to store the metadata, including poster URLs.

    • Create an errors.json file to contain any files or folders that had issues being formatted.

  4. get_posters() - Download the movie poster and name the file poster.<extension> (where <extension> is the original extension of the poster file) - [PosterFinder]

  5. get_subtitles() - Download the subtitles using SubDb ( and an md5 hash of the movie file and name the file <movie_title> [<year_of_release>].srt - [SubtitleFinder]

Project details

Release history Release notifications

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for movie-file-fixer, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size movie_file_fixer-0.3.0-py2.py3-none-any.whl (38.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size movie-file-fixer-0.3.0.tar.gz (32.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page