Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
script to guess and batch rename media files using tvdb
Python
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
vendor
.gitignore
.gitmodules
README.markdown
scenerename.py

README.markdown

scenerename

Python script to automatically rename scene filenames to a more user-friendly format.

Usage

Individual Files

Pass individual file names as arguments to rename specific files.

/mnt/media/.Downloads/Scrubs.S08.720p.HDTV.x264$ ~/scenerename.py e7-scrubs.s08e09.720p-x264.mkv Scrubs.S08E02.720p.HDTV.X264-DIMENSION.mkv
Fetching series data for "scrubs"...
--------------------------------------------------------------------------------------------------------------------------------------------
Original Name                                                          New Name
--------------------------------------------------------------------------------------------------------------------------------------------
e7-scrubs.s08e09.720p-x264.mkv                                         Scrubs 8x09 - My Absence.mkv
Scrubs.S08E02.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x02 - My Last Words.mkv

Run with "--confirm" to rename files

Directories

Run the script in a directory to have it parse all of the files.

/mnt/media/.Downloads/Scrubs.S08.720p.HDTV.x264$ ~/scenerename.py
Fetching series data for "scrubs"...
--------------------------------------------------------------------------------------------------------------------------------------------
Original Name                                                          New Name
--------------------------------------------------------------------------------------------------------------------------------------------
e7-scrubs.s08e09.720p-x264.mkv                                         Scrubs 8x09 - My Absence.mkv
scrubs.s08e16.720p.hdtv.x264-0tv.mkv                                   Scrubs 8x16 - My Cuz.mkv
scrubs.s08e11.720p.hdtv.x264-ctu.mkv                                   Scrubs 8x11 - My Nah Nah Nah.mkv
Scrubs.S08E07.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x07 - My New Role.mkv
Scrubs.S08E06.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x06 - My Cookie Pants.mkv
scrubs.s08e14.720p.hdtv.x264-ctu.mkv                                   Scrubs 8x14 - My Soul on Fire (1).mkv
scrubs.s08e15.720p.hdtv.x264-ctu.mkv                                   Scrubs 8x15 - My Soul on Fire (2).mkv
scrubs.s08e01.720p.hdtv.x264-ctu.mkv                                   Scrubs 8x01 - My Jerks.mkv
e7-scrubs.s08e10.720p-x264.mkv                                         Scrubs 8x10 - My Comedy Show.mkv
scrubs.812.proper.720p.hdtv.x264-sys.mkv                               Scrubs 8x12 - Their Story II.mkv
scrubs.s08e17.720p.hdtv.x264-ctu.mkv                                   Scrubs 8x17 - My Chief Concern.mkv
Scrubs.S08E18.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x18 - My Finale.mkv
Scrubs.S08E13.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x13 - My Full Moon.mkv
Scrubs.S08E02.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x02 - My Last Words.mkv
scrubs.s08e04.720p.hdtv.x264-ctu.mkv                                   Scrubs 8x04 - My Happy Place.mkv
Scrubs.S08E05.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x05 - My ABC's.mkv
Scrubs.S08E08.720p.HDTV.X264-DIMENSION.mkv                             Scrubs 8x08 - My Lawyer's in Love.mkv
scrubs.s08e03.720p.hdtv.x264-ctu.mkv                                   Scrubs 8x03 - My Saving Grace.mkv

Run with "--confirm" to rename files

Dictionary Output

The dictionary output (-d/--dict) shows you all of the data that scenerename was able to match.

/mnt/media/.Downloads/Scrubs.S08.720p.HDTV.x264$ ~/scenerename.py --dict Scrubs.S08E02.720p.HDTV.X264-DIMENSION.mkv
Fetching series data for "scrubs"...
Scrubs.S08E02.720p.HDTV.X264-DIMENSION.mkv --> Scrubs 8x02 - My Last Words.mkv
  episode: 02
  title: My Last Words
  season: 8
  vcodec: X264
  show: Scrubs
  source: HDTV
  ext: mkv
  group: DIMENSION
  resolution: 720p

Command Line Arguments

  • -s / --samples

    Test out the parsing on a variety of samples which were designed to challenge the script.

  • -d / --dict

    Displays a verbose dictionary of all the matched elements in the name.

  • -o / --output

    Specifies an alternate output format. Use the python string format notation coupled with the names from -d. (i.e. -o "%(show)s %(season)sx%(episode)2s - %(title)s.%(ext)s")

  • -n / --none

    Alternate string to use for unknown titles. (Default: "None")

  • -f1 / --filter-before

    Apply pre-parsing rules to difficult names to aid in proper parsing. (i.e. -f1 '[{group|name]}'='groupname')

  • -f2 / --filter-after

    Apply post-parsing replacements to difficult names to aid in proper parsing. Works exactly like -f1 except the replacement is done on the new filename.

  • --confirm

    Be default the script only display how it would rename the files but will not perform the action. Append this to perform the renaming.

Developed By

Git repository located at github.com/Knio/scenerename

License

Copyright 2009 Tom Flanagan, Jake Wharton

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Something went wrong with that request. Please try again.