med

mediatidy

Command line interface to cleanup your media library

Showing:

Popularity

Downloads/wk

0

GitHub Stars

20

Maintenance

Last Commit

6yrs ago

Contributors

1

Package

Dependencies

12

License

Type Definitions

Tree-Shakeable

No?

Categories

Readme

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial