Skip to main content

A utility for organizing a media folder

Project description


Build Status Codecov

pypi version # of downloads



cinefolders is a command-line utility for organizing organizing media folders into a structure formatted for Plex, Emby, a flash drive, etc.. You can also automate this to automatically add videos to your media folder, keeping it organized.

It tries to reversibly rename files as best it can to follow guidelines set by MediaBrowser for movies and television. As well as provide a link to TheMovieDB for more info.

If you want to get more info like the trailers, posters, reviews, etc.. Just see the sister project to this one: cinefiles. Videos/

Changes this unorganized mess:

  /Down Periscope.mp4
  /Down Periscope_UHD_.mp4
  /Grand Budapest Hotel (2014).mkv
  /Mulan (1998)/  
  /Avatar - 2x02 -.mkv
    /Horror Movies/

... into this:

    /Down Periscope (1996)
      /Down Periscope (1996).mp4
      /Down Periscope (1996) - Ultra HD.mp4
    /Grand Budapest Hotel (2014)
      /Grand Budapest Hotel (2014).mkv
    /Mulan (1998)
      /Mulan (1998).mp4
    /The Shining (1980)  
      /The Shining (1980) - 1080p Director's Cut.mp4
  /TV Shows
    /Avatar the Last Airbender 
      /Season 2
        /Avatar the Last Airbender S02E02 The Cave of Two Lovers.mkv

Note: You'll need a TMDb API Key (I can't just let all of you use mine!) Its easy to get here: api Plus once you register you can contribute to TMDb! Don't worry, just run cinefolders and it'll prompt you for it.

usage: cinefolders [-h] [-l] [-v] [-x X] [--dry-run] [--copy]
                   [--destination DESTINATION] [--version] [--debug]


positional arguments:
  directory             Location of folder holding the videos

optional arguments:
  -h, --help            show this help message and exit
  -l                    List new file structure
  -v                    Verbosely list actions
  -x X                  Export all changes as a bash script
  --dry-run             Don't change anything
  --copy                copy instead of just moving files
  --destination DESTINATION
                        specify an alternate destination
  --version             show program's version number and exit
  --debug               debug option (only for developers)

Project details

Download files

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

Source Distribution

cinefolders-0.1.0.tar.gz (17.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page