[DOCS] Revert files via the internal History

[rednoah]

FileBot maintains a persistent history of previous move / copy / link / etc operations so you can revert them later any time.

Revert files via the GUI

Click Open History ➔ Select Groups or Items ➔ Revert Selection to revert selected files:

Revert files via the CLI

Revert the most recent group of files:

Shell: Select all

filebot -revert

Revert the given set of files and folders:

Shell: Select all

filebot -revert /path/to/files

Revert a selection of files:

Shell: Select all

filebot -revert --mode interactive

Print the internal history:

Shell: Select all

filebot -script fn:history

Clear the internal history:

Shell: Select all

filebot -clear-history

Revert files to their original names using xattr metadata instead of the internal history:

Shell: Select all

filebot -rename -r /path/to/files --db xattr --format "{original}"

Example Usage

Process files:

Console Output: Select all

$ filebot -rename *.mp4 --db TheMovieDB -non-strict --action HARDLINK --log INFO
[HARDLINK] from [Avatar.mp4] to [Avatar (2009).mp4]

View xattr metadata:

Console Output: Select all

$ filebot -mediainfo *.mp4 --db xattr --format "{f.name} | {original} | {type} | {id}"
Avatar (2009).mp4 | Avatar | Movie | 19995
Avatar.mp4 | Avatar | Movie | 19995

Revert files:

Console Output: Select all

$ filebot -revert
Revert [Avatar (2009).mp4] to [Avatar.mp4]

Confirm that the newly created hardlink has been deleted, and that xattr metadata has been removed:

Console Output: Select all

$ filebot -mediainfo *.mp4 --db xattr --format "{f.name} | {original} | {type} | {id}"
Avatar.mp4 |  |  |