[DOCS] --apply post-processing features

[rednoah]

Option 1: Apply Post-Processing Features via Rename

NOT YET IMPLEMENTED




Option 2: Apply Post-Processing Features via Filter

Post-Processing features such as Fetch Artwork / Export NFO files / Export URL files / etc can be applied to an existing set of files via Filter ➔ Attributes ➔ Apply assuming that xattr metadata is readily available.




Option 3: Apply Post-Processing Features via the --apply option from Terminal

--apply can be added to -rename and -mediainfo calls to enable common post-processing tasks for newly renamed files.

e.g.

Code: Select all

--apply artwork nfo url metadata

ARTWORK
Fetch series / movie artwork for newly added files:

Code: Select all

--apply artwork

COVER
Fetch folder.jpg files for newly added series / movie folders:

Code: Select all

--apply cover

NFO
Generate *.nfo files for series / movie folders:

Code: Select all

--apply nfo

URL
Generate *.url files for movie folders:

Code: Select all

--apply url

SUBTITLES
Fetch subtitles in the preferred language:

Code: Select all

--apply subtitles

METADATA
Generate hidden .xattr folders with xattr metadata in plain file format:

Code: Select all

--apply metadata

The FileBot Xattr Metadata Scanners & Plug-ins for Plex uses .xattr folders to avoid cross-platform and cross-device limitations of native filesystem xattr. (e.g. network shares, FAT filesystem, etc)


DATE
Set the Last-Modified and Creation-Date timestamp to the episode airdate / movie release date:

Code: Select all

--apply date

TAG
Write mkv and mp4 tags via the mkvpropedit (i.e. mkvtoolnix package) and mp4tags (i.e. mp4v2 package) command-line tools:

Code: Select all

--apply tag

IMPORT
Copy companion files (e.g. trailers, subtitles, artwork, etc) along from the original folder to the new location:

Code: Select all

--apply import

PRUNE
Delete left-behind empty folders:

Code: Select all

--apply prune

CLEAN
Delete left-behind clutter files and folders:

Code: Select all

--apply clean

REFRESH (for Synology NAS and QNAP NAS platforms)
Refresh file services and media library:

Code: Select all

--apply refresh

The --apply artwork nfo url post-processing features assume a {plex} compatible folder structure.

[kim]

Will this replace scripts ?
any future plans to ?

where is this in the Docs ?
https://www.filebot.net/docs/api/

what does this use to fetch stuff ?

[rednoah]

Will this replace scripts ?
any future plans to ?

Not at all. It's just a variety of frequently requested features that more or less fall under the same umbrella. The future plan is to add selected post-processing features to the GUI and allow users to apply some of them as part of the rename process.

where is this in the Docs ?
https://www.filebot.net/docs/api/

A public API is not planned. It doesn't do anything that isn't already implemented in the htpc.groovy script or otherwise commonly handled via -exec calls.

The --apply import metadata date url and --apply qnap syno options might be of some benefit to amc script users, though existing users probably already have custom solutions.

what does this use to fetch stuff ?

It's doing more or less the same as the artwork.* scripts, using TheMovieDB / TheTVDB / FanartTV as the source of image files.