From ffe33db808fd39211c262720b4c024d81be2f06e Mon Sep 17 00:00:00 2001 From: Chaz Larson Date: Tue, 3 Dec 2024 19:29:49 -0600 Subject: [PATCH] "Undo changes" page (#2341) --- .github/.wordlist.txt | 1 + CHANGELOG | 1 + docs/kometa/guides/revert.md | 55 ++++++++++++++++++++++++++++++++++++ mkdocs.yml | 3 +- 4 files changed, 59 insertions(+), 1 deletion(-) create mode 100644 docs/kometa/guides/revert.md diff --git a/.github/.wordlist.txt b/.github/.wordlist.txt index b7634eb9..c5152431 100644 --- a/.github/.wordlist.txt +++ b/.github/.wordlist.txt @@ -17,6 +17,7 @@ API apikey APIs apiVersion +appdata AppleTV ArrAPI Arrowverse diff --git a/CHANGELOG b/CHANGELOG index bc42d6d5..43997d6c 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -12,6 +12,7 @@ Add `show_unfiltered` setting to display items which make it through a filter Added "getting started" page Added page to describe all the YAML files Updated Synology page for DSM 7.2 and added a disclaimer about what it covers +Added "undoing changes" page # Defaults Fixed incorrect content rating mappings in various Default files diff --git a/docs/kometa/guides/revert.md b/docs/kometa/guides/revert.md new file mode 100644 index 00000000..0b3b9fbe --- /dev/null +++ b/docs/kometa/guides/revert.md @@ -0,0 +1,55 @@ +--- +search: + boost: 2 +hide: + - tags +tags: + - undo + - revert + - backup +--- +# Reverting what Kometa has done + +There is no global "undo everything Kometa ever did" *after the fact* since no history is kept. + +The only "totally undo everything Kometa has ever done to this Plex server" process is to restore your Plex appdata from the backup you took prior to using Kometa. + +## Collections + +You can delete the collections that Kometa has created either by telling Kometa to do so or manually in the UI. + +If Kometa has deleted collections that you created outside of Kometa [something you would have explicitly told it to do], they cannot be restored. + +## Playlists + +You can delete the playlists that Kometa created manually in the UI. + +## Overlays + +You can tell Kometa to remove overlays, which will restore the clean posters that the overlays were applied to. + +## Metadata + +If you have not created a metadata backup in advance, there is probably no way to restore things that Kometa has changed. + +Kometa can make a [metadata backup](../../config/operations.md#metadata-backup) for you. This backup is a YAML file that contains things like ratings, titles, summaries, etc. You can use this backup to revert changes that Kometa has made. + +Chazlarson has created a [metadata backup script](https://github.com/chazlarson/Media-Scripts/blob/main/Kometa/README.md#metadata-extractorpy) that backs up more metadata than Kometa does, including artwork. This script can be used to create a backup that can be used to revert changes that Kometa has made. + +Both of these backups are only useful if you have created them before you need them. + +The remarks that follow apply in the absence of a metadata backup. + +### Posters and Backgrounds + +If you have used Kometa to set artwork based on URLs or local files, there is no way to restore what was there before Kometa changed it. No history of what was there before is kept. + +### Mass updates + +If you have made mass updates to things like genres, ratings, and the like, what was there before is gone for good *unless* what was there is the default Plex value. You can generally use Kometa to reset those values and let Plex fill them back in. + +This is not always the case, however. If you had assigned user ratings to everything prior to using Kometa and then you told Kometa to update the user rating with some other rating [say TMDB or the like], all your user ratings are lost with no backup. + +### Other Metadata + +If you have used Kometa to change titles, summaries, years, artwork, etc. with a metadata file [all things you would have explicitly told it to do] there is no way to restore what was there before Kometa changed it. diff --git a/mkdocs.yml b/mkdocs.yml index 8a7b2b3a..99070471 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -149,13 +149,14 @@ nav: - Frequently Asked Questions: kometa/faqs.md - Explanation Guides: &guides - Overview: kometa/guides/overview.md - - Switching from PMM to Kometa: kometa/guides/rebrand.md - Plex Ratings Explained: kometa/guides/ratings.md - Kometa Sorting Guide: kometa/guides/order.md - Scheduling Kometa Runs Guide: kometa/guides/scheduling.md - Image Asset Directory Guide: kometa/guides/assets.md - Formula 1 Metadata Guide: kometa/guides/formula.md - MediUX Assets Guide: kometa/guides/mediux.md + - Reverting Kometa Changes: kometa/guides/revert.md + - Switching from PMM to Kometa: kometa/guides/rebrand.md - Companion Scripts: &scripts - Overview: kometa/scripts/overview.md - ImageMaid: kometa/scripts/imagemaid.md