Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including mediatidy with all npm packages installed. Try it out:

var mediatidy = require("mediatidy")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

mediatidy v0.5.0

A simple CLI tool to keep your media nice and tidy!

mediatidy

For anyone with a large media collection (movies and tv shows) who craves file organization, mediatidy is a project that helps you keep your content... tidy.

This project is early in dev and a WIP. Please file issues!

About

Point mediatidy at your movie or TV show directory and it will do the following (any file deletion requires your approval):

  • Delete all non-video type files.
  • Delete all corrupt/incomplete video files.
  • Delete all sample files.
  • Process files to find dupes; keep the highest quality of the dupes and delete the rest.
  • Delete directories that are empty
  • Delete directories that match keywords saved by user

Coming soon:

  • Delete files under a specified size.
  • Media files view.
  • Ability to rename files.

File Naming Assumptions

For dupe detection to work best your files should be properly named. mediatidy works best with the following conventions:

Movies should have title followed by year:

  • Movie Title (1974).mkv
  • Movie Title - 1974.mkv
  • Movie Title 1974.mkv

TV shows should be have show name, followed by formatted season/episode, then episode name:

  • Show Name - S02E03 - Ep Name.mkv
  • Show Name - S02E03e01 - Ep Name.mkv
  • Show Name - 02x03 - Ep Name.mkv
  • Show Name - 2014.03.07 - Ep Name.mkv

Without proper file naming conventions duplicate matching can be unreliable. You do want to be tidy right?

Setup

Dependencies

NodeJS and ffmpeg are required to run mediatidy. Find the installers and install the latest versions; if using Mac OSX consider installing homebrew and easily install what you need with the following:

$ brew install node
$ brew install ffmpeg

Install

Be sure all dependencies are install before installing mediatidy.

$ sudo npm install -g mediatidy

Uninstall

$ sudo npm uninstall -g mediatidy
$ rm -rf ~/.mediatidy

Usage

See mediatidy help for a full list of commands.

$ mediatidy --help

Basics

Add media folder to mediatidy you would like to process with:

$ mediatidy add-paths

Let's tidy up those media files!

$ mediatidy clean
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free