Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/knio/scenerename

script to guess and batch rename media files using tvdb
https://github.com/knio/scenerename

Last synced: 7 days ago
JSON representation

script to guess and batch rename media files using tvdb

Awesome Lists containing this project

README

        

`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
============
* Tom Flanagan -
* Jake Wharton -

Git repository located at
[github.com/Knio/scenerename](http://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.