A script to rename and copy downloaded files to a target in Emby-happy way
Project description
torcp
对下载的影视文件,通过 硬链
或 软链
在另一个文件夹中改名和重组目录、以便 Emby/Plex 这样的应用程序便于刮削识别。本脚本:
- 对你的影视文件夹中的文件进行分类,主要处理 TV/Movie, 解析影视文件夹中的
影视名称
,年份
,季
,集
,以及制作组
- 依照 Emby-happy 的风格进行重组目录与改名,在目标目录中生成硬链或软链.
- 支持搜索TMDb,以获得准确的、选定语言的影视名字,然后以此名字进行更名和组织目录,对于查出了TMDb的媒体,支持按语言分类
1 应用说明
2 Last Update
- 2022.9.5
--imdbid
在-s
模式下指定媒体的 IMDb id - 2022.9.4
--after-copy-script
执行外部脚本时,会传入3个参数:生成的媒体路径,原媒体文件(夹)名,tmdbid - 2022.8.18 如果资源文件夹命名里面带
[imdbid=xxx]
或[tmdbid=xxx]
,则直接使用这样的id去TMDb中搜索资源信息 - 2022.7.21
--after-copy-script
在完成硬链后,执行一外部脚本,以便实现Plex刮削 - 2022.6.20
-e, --keep-ext
, 可使用参数all
- 2022.4.3:
--make-log
在目标目录中建立一个log文件,以便追溯原文件名 - 2022.3.23:
--symbolink
support symbol link - 2022.3.13:
--lang
dispatch to different folders base on TMDb language - 2022.2.26:
--tmdb-api-key
Support TMDb search
3 准备
本程序需要在
python3
运行环境,以命令行方式运行
- 安装torcp
pip3 install torcp
3.1 群晖中使用python3 和 pip3
- DSM 6.x 默认没有安装Python 3,需要要在套件中心中搜索安装
Python 3
- 群晖安装pip
python3 -m ensurepip
4 使用方法:
- 完整的命令参数,可以通过这样查看:
torcp -h
- 或使用源码安装的话,打
python tp.py -h
usage: tp.py [-h] -d HD_PATH [-e KEEP_EXT] [-l LANG] [--tmdb-api-key TMDB_API_KEY] [--tmdb-lang TMDB_LANG]
[--tv-folder-name TV_FOLDER_NAME] [--movie-folder-name MOVIE_FOLDER_NAME] [--tv] [--movie] [--dryrun] [--single]
[--extract-bdmv] [--full-bdmv] [--origin-name] [--sleep SLEEP] [--move-run] [--make-log] [--symbolink] [--cache]
[--emby-bracket] [--plex-bracket] [--after-copy-script AFTER_COPY_SCRIPT] [--imdbid IMDBID]
MEDIA_DIR
torcp: a script hardlink media files and directories in Emby-happy naming and structs.
positional arguments:
MEDIA_DIR The directory contains TVs and Movies to be copied.
options:
-h, --help show this help message and exit
-d HD_PATH, --hd_path HD_PATH
the dest path to create Hard Link.
-e KEEP_EXT, --keep-ext KEEP_EXT
keep files with these extention('srt,ass').
-l LANG, --lang LANG seperate move by language('cn,en').
--tmdb-api-key TMDB_API_KEY
Search API for the tmdb id, and gen dirname as Name (year)\{tmdbid=xxx\}
--tmdb-lang TMDB_LANG
specify the TMDb language
--tv-folder-name TV_FOLDER_NAME
specify the name of TV directory, default TV.
--movie-folder-name MOVIE_FOLDER_NAME
specify the name of Movie directory, default Movie.
--tv specify the src directory is TV.
--movie specify the src directory is Movie.
--dryrun print message instead of real copy.
--single, -s parse and copy one single folder.
--extract-bdmv extract largest file in BDMV dir.
--full-bdmv copy full BDMV dir and iso files.
--origin-name keep origin file name.
--sleep SLEEP sleep x seconds after operation.
--move-run WARN: REAL MOVE...with NO REGRET.
--make-log Make a log file.
--symbolink symbolink instead of hard link
--cache cache searched dir entries
--emby-bracket ex: Alone (2020) [tmdbid=509635]
--plex-bracket ex: Alone (2020) {tmdb-509635}
--after-copy-script AFTER_COPY_SCRIPT
call this script with destination folder path after link/move
--imdbid IMDBID specify the TMDb id, -s single mode only
4.1 使用源码调用的方式
- 如果你仍然习惯源码调用的方式,安装代码,仍然使用:
git clone https://github.com/ccf-2012/torcp.git
- 这里添加了一个小的入口程序
tp.py
,你可以这样调用:
python tp.py -h
- 后面例子中的
torcp
都可以替换成python tp.py
这样的调用方式。 - 这样的方式,全程操作是以同一用户同一env,可能会减少出错机会。
5 例子
- 将一个目录中所有影视文件和目录,硬链到另一个目录,其间会按目录名/文件名猜测分类,并挑出
.mkv
和.mp4
:
torcp /home/ccf2012/Downloads/ -d /home/ccf2012/emby/
- 电影和剧集的处理,是不一样的,如果你确认一个目录是电影或剧集,可以使用
--movie
和--tv
指定:
torcp /home/ccf2012/Downloads/RSSMovie/ -d /home/ccf2012/emby/ --movie
- 如果想单独处理单个目录,可使用
-s
指定,例如:
torcp /home/ccf2012/Downloads/权力的游戏.第1-8季.Game.Of.Thrones.S01-S08.1080p.Blu-Ray.AC3.x265.10bit-Yumi -d /home/ccf2012/emby/ -s --tv
6 --tmdb-api-key
TMDb 查询
- 通过The Movie Database (TMDb) API 查询,得到确切的tmdbid, 确保生成的文件夹可被刮削
- 可选
--tmdb-lang
参数,默认是zh-CN
- 查询不到的文件,将会被
链
或移
到目标目录下TMDbNotFound
目录中
torcp /home/test/ -d /home/test/result3/ --tmdb-api-key='your TMDb api key'
- 组合
--move-run
的例子
torcp /home/test/ -d /home/test/result2/ --tmdb-api-key='your TMDb api key' --plex-bracket --move-run --dryrun
6.1 --lang
按语言分类
- 如果查出了TMDb id,那么可以将媒体按语言分类
--lang
后面以逗号分隔写所需要分出来的语言,其它的归到others
- 如果写
--lang all
则所有语言都被分类 - 在TMDb 中,中文语言会是
zh
和cn
torcp /home/test/ -d /home/test/result3/ --tmdb-api-key='your TMDb api key' --lang zh,cn,en
7 --move-run
直接改名和移动
- 不作硬链,直接进行move和改名操作,用于对已经放在gd中的文件进行整理
-d
指定要搬移的目标位置,请自己把握不跨区- 加了一个
--sleep
参数,可以每次操作搬移一个文件后暂停SLEEP
秒,此参数仅在--move-run
时有效 - 由于这样的操作不可逆,请一定先作
--dry-run
确认后才执行
7.1 例子
torcp /home/test/ -d /home/test/result5/ --move-run --dryrun
8 --extract-bdmv
和 --full-bdmv
,BDMV的处理
- 特别说一下对BDMV的处理:
- 如果什么参数都不加,在碰到含有
BDMV
目录和.iso
文件时,将会跳过。
torcp /volume1/video/emby/test -d /volume1/video/emby/testdir
--extract-bdmv
参数,可能最适合 Emby 或 Kodi 的用家,它将会从BDMV
目录中挑出最大的几个.m2ts
文件硬链出来,对于 movie/tv 都行。见下面的例子
with
iso
files copy to sepereate dir
torcp /volume1/video/emby/test -d /volume1/video/emby/testdir --extract-bdmv
--full-bdmv
参数。使用这个参数会将整个 BDMV 文件夹和.iso
文件都硬链出来,对于使用碟机播放的用家,就会有用。
torcp /volume1/video/emby/test -d /volume1/video/emby/testdir --full-bdmv
8.1 --extract-bdmv
的例子
- 命令:
torcp /share/CACHEDEV1_DATA/Video/QB/TV -d /share/CACHEDEV1_DATA/Video/emby/ --extract-bdmv
- 原目录:
[/share/CACHEDEV1_DATA/Video/QB/TV/Civilisations.S01.COMPLETE.BLURAY-VEXHD] # tree . -h -A -P *.m2ts
.
├── [4.0K] CIVILISATIONS_D1
│ └── [4.0K] BDMV
│ ├── [4.0K] BACKUP
│ │ ├── [4.0K] CLIPINF
│ │ └── [4.0K] PLAYLIST
│ ├── [4.0K] CLIPINF
│ ├── [4.0K] META
│ │ └── [4.0K] DL
│ ├── [4.0K] PLAYLIST
│ └── [4.0K] STREAM
│ ├── [ 14G] 00002.m2ts
│ ├── [ 14G] 00003.m2ts
│ ├── [ 14G] 00004.m2ts
│ ├── [1.1M] 00005.m2ts
│ ├── [ 12M] 00006.m2ts
│ ├── [ 94M] 00007.m2ts
│ ├── [ 94M] 00008.m2ts
│ ├── [1.9M] 00009.m2ts
│ ├── [1.5M] 00010.m2ts
│ └── [126K] 00011.m2ts
├── [4.0K] CIVILISATIONS_D2
│ └── [4.0K] BDMV
│ ├── [4.0K] BACKUP
│ │ ├── [4.0K] CLIPINF
│ │ └── [4.0K] PLAYLIST
│ ├── [4.0K] CLIPINF
│ ├── [4.0K] META
│ │ └── [4.0K] DL
│ ├── [4.0K] PLAYLIST
│ └── [4.0K] STREAM
│ ├── [ 14G] 00002.m2ts
│ ├── [ 14G] 00003.m2ts
│ ├── [ 14G] 00004.m2ts
│ ├── [1.1M] 00005.m2ts
│ ├── [ 12M] 00006.m2ts
│ ├── [ 94M] 00007.m2ts
│ ├── [ 94M] 00008.m2ts
│ ├── [1.9M] 00009.m2ts
│ ├── [1.5M] 00010.m2ts
│ └── [126K] 00011.m2ts
└── [4.0K] CIVILISATIONS_D3
└── [4.0K] BDMV
├── [4.0K] BACKUP
│ ├── [4.0K] CLIPINF
│ └── [4.0K] PLAYLIST
├── [4.0K] CLIPINF
├── [4.0K] META
│ └── [4.0K] DL
├── [4.0K] PLAYLIST
└── [4.0K] STREAM
├── [ 14G] 00002.m2ts
├── [ 14G] 00003.m2ts
├── [ 14G] 00004.m2ts
├── [1.1M] 00005.m2ts
├── [ 12M] 00006.m2ts
├── [ 94M] 00007.m2ts
├── [ 94M] 00008.m2ts
├── [1.9M] 00009.m2ts
├── [1.5M] 00010.m2ts
└── [126K] 00011.m2ts
- 执行后:
[/share/CACHEDEV1_DATA/Video/emby/BDMV_TV/Civilisations] # tree . -h -A
.
├── [4.0K] CIVILISATIONS_D1
│ ├── [ 14G] CIVILISATIONS_D1\ -\ 00002.m2ts
│ ├── [ 14G] CIVILISATIONS_D1\ -\ 00003.m2ts
│ └── [ 14G] CIVILISATIONS_D1\ -\ 00004.m2ts
├── [4.0K] CIVILISATIONS_D2
│ ├── [ 14G] CIVILISATIONS_D2\ -\ 00002.m2ts
│ ├── [ 14G] CIVILISATIONS_D2\ -\ 00003.m2ts
│ └── [ 14G] CIVILISATIONS_D2\ -\ 00004.m2ts
└── [4.0K] CIVILISATIONS_D3
├── [ 14G] CIVILISATIONS_D3\ -\ 00002.m2ts
├── [ 14G] CIVILISATIONS_D3\ -\ 00003.m2ts
└── [ 14G] CIVILISATIONS_D3\ -\ 00004.m2ts
9 DeleteEmptyFolders.py 清除空目录
- 在作了上面
--move-run
操作后,原目录将会剩留大量 空的,或仅包含.jpg
,.nfo
这类小文件的目录 - 除了默认的
.mkv
,.mp4
,.ts
,.iso
之外,使用与torcp.py
相同的--keep-ext
来表示那些已经 不再包含这些扩展名文件 的目录,将被删除 - 使用
--dryrun
先看下将会发生什么
9.1 例子
torcp-clean /home/test/ -e srt,ass --dryrun
Acknowledgement
- @leishi1313
- @Aruba @ozz
- @NishinoKana @Esc @Hangsijing @Inu
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
torcp-0.48.tar.gz
(48.4 kB
view hashes)