A set of python scripts to rename movies and tv shows.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
simon 81c6eeb977
fix multi_parser episode extractor
3 months ago
assets adding banner and icon assets 1 year ago
src fix multi_parser episode extractor 3 months ago
.gitignore ignore .vscode folder 1 year ago
LICENSE.md initial commit, media_organizer 1 year ago
README.md rename task to csv export 6 months ago
config.sample.json switch to yt_dlp 8 months ago
interface.py rename task to csv export 6 months ago
requirements.txt switch to yt_dlp 8 months ago

README.md

banner.jpg

media_organizer

A set of python scripts to rename movies and tv shows.

This project is used and tested under Linux and is ideal to be used from something like a Raspberry Pi or a Linux based NAS. If you want to help me to get it to work under Windows, please contribute.

Run

Clone the repo, setup config file (see below) and run interface.py. Use your arrowkeys no navigate up and down the menu.

  • q quit the interface
  • r refresh the pending items by rescanning the filesystem.

Movies

Detect movie names by querying themoviedb.org API and renaming the file based on a selection of possible matches. Follow the config file instructions bellow to get your API key.

All data is courtesy of The Movie Database, please contribute to this excellent database.

Movies will get renamed to this nameing style, a more flexible solution is in pending:
{movie-name} {Year}/{movie-name} {Year}.{ext}

TV shows

Detect tv show filenames by querying the publicly available tvmaze.com API to identify the show name and the episode name based on a selection of possible matches.

Episodes are named in this style, a more flexible solution is in pending:
{show-name}/Season {nr}/show-name - S{nr}E{nr} - {episode-name}.{ext}

Trailer download

Downloading trailers from links provided from emby and move them into the movie folder.
Trailers are named in this style, a more flexible solution is in pending:
{movie-name} {Year}_{youtube-id}_trailer.mkv

Fix Movie Names

Sometimes Emby get's it wrong. Sometimes this script can get it wrong too. The Fix Movie Names function goes through the movie library looking for filenames that don't match with the movie name as identified in emby.

CSV export

Export the library to csv files. Calles the Emby API to get a list of movies and episodes and exports this to a convenient set ov CSV files.

setup

Needs Python >= 3.6 to run.

install requirements

These are the none standard Python libraries in use in this project:

  • requests
    • Install on Arch: sudo pacman -S python-requests
    • Install with pip: pip install requests
  • trash-cli
    • Install on Arch: sudo pacman -S trash-cli
    • Install with pip: pip install trash-cli
  • yt-dlp
    • Install on Arch: sudo pacman -S yt-dlp
    • Install with pip: pip install yt-dlp
  • curses
    • Is already installed on most linux based systems.
    • On Windows: pip install windows-curses

Or use pip to install all the requirements:
pip install -r requirements.txt

config json file:

Duplicate the config.sample.json file to a file named config.json and set the following variables:

media

  • tv_downpath: Folder path where the tv episodes get downloaded to.
  • movie_downpath: Folder path where the movie files get downloaded to.
  • sortpath: Empty folder the media_organizer can use as a temporary sort path.
  • moviepath: Root folder where the organized movie files will go.
  • tvpath: Root folder where the organized tv episodes will go.
  • ext: A list of valid media file extensions to easily filter out none media related files.
  • log_path: Path to a folder to output all renaming done to keep track and check for any errors and safe csv files.
  • movie_db_api: Register and get your themoviedb.com API Key (v3 auth) acces from here.
  • min_file_size: Minimal filesize to be considered a relevant media file in bytes.

Emby integration

optional: remove the 'emby' key from config.json to disable the emby integration.

  • emby_url: url where your emby instance is reachable
  • emby_user_id: user id of your emby user
  • emby_api_key: api key for your user on emby

ydl_opts Trailer download:

optional: remove the 'ydl_opts' key from config.json to disable the trailer download functionality.
Arguments under the [ydl_opts] section will get passed in to yt-dlp for trailers. Check out the documentation for details.

Known limitations:

Most likely media_organizer will fail if there are any files like Outtakes, Extras, Feauturettes, etc in the folder. For these cases, moove/delete them first before running media_organizer.