Jellyfin-DvrEpisodeRenamer

This application can be used to automatically rename a Jellyfin recorded TV file¹ using the metadata stored in a .nfo file which is saved alongside the video file by Jellyfin's DVR functionality.

NOTE: The format will be '[Show Name] - S[Season No]E[Episode No].[extension]' e.g. 'The Big Bang Theory - S01E10.mp4'.

There are two modes of processing:

• Single Video file
• Whole directory Scan (including sub-directories)

This is determined by the path supplied to the application when executed.

By default the application looks for .ts files, however .mp4 & .m4v files can be specified.

The associated meta data files (episode info and thumbnail) will also be renamed unless the delete option has been used, in which case they will be deleted.

Manual Usage

usage: Jellyfin-DvrEpisodeRenamer.py [-h] [-d | -r] [-e {.ts,.mp4,.m4v}] path

Auto Rename Jellyfin TV Show Recordings (DVR)

positional arguments:
  path                  Path to File or Directory to Process

options:
  -h, --help            show this help message and exit
  -d, --delete          Delete the episiode info file and thumbnail after processing
  -r, --rename          Rename the episiode info file and thumbnail after processing (default)
  -e {.ts,.mp4,.m4v}, --extension {.ts,.mp4,.m4v}
                        Video File Extension (default: .ts)

Single File Example

In this example, we are processing a single .ts file and deleting the episode info and thumbnail files upon successful completion:

python3 Jellyfin-DvrEpisodeRenamer.py ".../TV Shows/The Big Bang Theory/The Big Bang Theory 2024_02_27_17_00_00.ts" -d

Directory Scan Example

In this example, we are processing all .mp4 files in the specified directory (including sub-directories) and renaming the episode info and thumbnail files upon successful completion:

python3 Jellyfin-DvrEpisodeRenamer.py ".../TV Shows" -e .mp4 -r

Automation

Jellyfin

Jellyfin can be configured to call the application once a recording has finished:

Dashboard > Live TV > Digital Recorder > Recording Post Processing

Docker-Post-Recording

I am a big fan of the docker-post-recording project and us it to automatically remove commercials and transcode my recordings to a .mp4 file. It is possible to configure the tool to execute the Jellyfin-DvrEpisodeRenamer script automatically once the transcoding has finished:

Copy the Jellyfin-DvrEpisodeRenamer.py file to the hooks directory in the docker container's config folder:

/config/hooks/

Whilst in the hooks folder, create a file called 'post_conversion.sh', and populate with the following:

#!/bin/sh
#
# Rename the file and handle the Meta Data post conversion
#
# The first parameter is the conversion status.  A value of 0 indicates that
# the video has been converted successfully.  Else, conversion failed.
#
# The second parameter is the full path to the converted video (the output).
#

CONVERSION_STATUS=$1
CONVERTED_FILE="$2"

if [ "$CONVERSION_STATUS" -eq 0 ]; then
    python3 /config/hooks/Jellyfin-DvrEpisodeRenamer.py "$CONVERTED_FILE" -e .mp4 -d
fi

In this example the .mp4 file will be renamed, and the episode info and thumbnail image will be deleted (because of the '-d' option)

Show Name Substitution

A 'substitutions.json' file can be created to instruct the script to substitute one show name for another when processing:

e.g.

[
    {
        "original": "Rick and Morty [adult swim]",
        "replacement": "Rick and Morty"
    }
]

Footnotes

1. Please Note: this has only been tested with UK Recordings. ↩