[DOCS] --apply post-processing features

[rednoah]

Apply Post-Processing Features via Rename

Post-processing features can be enabled for newly renamed files via Renaming Settings ➔ Post Process.





Apply Post-Processing Features via Filter

Post-processing features can be applied to an existing set of files via Attributes ➔ Apply assuming that xattr metadata is readily available.




Apply Post-Processing Features via the --apply option from Terminal

--apply can be added to -rename, -find and -mediainfo commands to enable common post-processing tasks for newly renamed files or previously renamed files.

e.g.

Code: Select all

--apply artwork nfo url metadata

Fetch artwork
Fetch artwork for movie / series / season folders:

Code: Select all

--apply artwork

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



Fetch cover images
Fetch folder.jpg files for movie / series folders:

Code: Select all

--apply cover

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

Code: Select all

--apply nfo

Export URL files
Generate *.url files for movie / series folders:

Code: Select all

--apply url

Export .xattr folders
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.



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

Code: Select all

--apply import

NOTE: FileBot 5.0.3 (r9744) and above will use your chosen action (move, copy, etc) to import companion files. Previous versions always copy companion files.



Transcode subtitle files
Transcode existing plain text subtitle files to SRT format / UTF-8 encoding:

Code: Select all

--apply srt

Fetch subtitle files
Fetch missing subtitle files in the preferred language:

Code: Select all

--apply subtitles

Set Finder tags
Set Finder tags on macOS:

Code: Select all

--apply finder

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

Code: Select all

--apply date

Set permissions
Set POSIX permissions to all-readable / user-writable (i.e. rw-r--r--) on Linux:

Code: Select all

--apply chmod

Set time stamp
Set Last-Modified to the current date and time:

Code: Select all

--apply touch

Reveal files
Reveal newly moved / copied files in Windows Explorer / Finder / File Manager:

Code: Select all

--apply reveal

Prune empty folders
Delete left-behind empty folders:

Code: Select all

--apply prune

Delete clutter files
Delete left-behind clutter files and folders:

Code: Select all

--apply clean

Write media tags
Write mkv and mp4 tags via the mkvpropedit (i.e. mkvtoolnix package) or AtomicParsley (i.e. atomicparsley package) command-line tools:

Code: Select all

--apply tags

If mkvpropedit or AtomicParsley are not in the $PATH then you may need to configure the absolute path to the executable:

Code: Select all

filebot -script fn:properties --def net.filebot.postprocess.mkvpropedit="C:/Tools/mkvpropedit.exe" --def net.filebot.postprocess.AtomicParsley="C:/Tools/AtomicParsley.exe"

Embedded MP4 or MKV tags are rare an uncommon. There is no established standard for tagging video files. MP4 tagging usually (but not necessarily) refers to iTunes-style metadata. MKV tagging (1, 2) is generally useless because there is not established standard.



Refresh file services
Refresh file services and media library:

Code: Select all

--apply refresh

** only supported on Synology NAS and QNAP NAS platforms



Custom Groovy Action
Run custom Groovy code on newly processed files:

Code: Select all

--apply '{ from, to, metadata -> println "$from | $to | $metadata" }'

Code: Select all

--apply /path/to/apply.groovy