Skip to content

Commit

Permalink
[3] update README
Browse files Browse the repository at this point in the history
  • Loading branch information
meisnate12 committed Feb 19, 2023
1 parent faea75d commit 6bb4797
Show file tree
Hide file tree
Showing 4 changed files with 20 additions and 8 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
*.db
MANIFEST

# PyInstaller
Expand Down
25 changes: 18 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ As well as being able to clean the PhotoTranscoder Directory and running the Ple

Special Thanks to [bullmoose20](https://github.com/bullmoose20) for the original [Plex Bloat Fix](https://github.com/bullmoose20/Plex-Stuff#plex-bloat-fix) (PBF) Script this is based on.

![](dispaly.png)
![](cleanup.png)

This image shows which photos would be removed. Red is removed, Green is kept because it is the actively selected poster. The other two come standard from Plex when the posters are retrieved so the script will not touch those either:

Expand Down Expand Up @@ -110,6 +110,23 @@ A `Dockerfile` is included within the GitHub repository for those who require it

## Usage

When running Plex Image Cleanup, make sure that you are not running any tools which may touch posters, backgrounds or title card images - namely [Plex Meta Manager](https://github.com/meisnate12/Plex-Meta-Manager) or [TitleCardMaker](https://github.com/CollinHeist/TitleCardMaker).

It is recommended to schedule Plex Image Cleanup after the above tools or Plex's Scheduled Tasks.

An example schedule would be:
00:00-02:00 - TitleCardMaker
02:00-05:00 - Plex Scheduled Tasks
05:00-07:00 - Plex Meta Manager
07:00-09:00 - Plex Image Cleanup

### Tips

* Ensure you have proper permissions to delete/rename or the script will fail
* For performance purposes, it's recommended to run locally so that accessing the files is not done over a network share

## Global Options

Plex Image Cleanup has multiple Global Options to change how it runs these are set in 3 different ways listed in priority order:

1. Setting the Environment Variable.
Expand Down Expand Up @@ -137,12 +154,6 @@ OPTIMIZE_DB=False
TRACE=False
```
### Notes / Tips
* Make sure that you are NOT actively updating posters or title cards with PMM or TCM while running this script. Schedule this after the last run happens. So TCM, Plex Scheduled Tasks, PMM, THEN schedule or run Plex Image Cleanup. Example: TCM @ 00:00, PLEX @ 02:00-05:00, and PMM @ 05:00
* Ensure you have proper permissions to delete/rename or the script will fail
* For performance purposes, it's recommended to run locally so that accessing the files is not done over a network share
### Base Options
#### Plex Path
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.9.8-develop2
0.9.8-develop3
File renamed without changes

0 comments on commit 6bb4797

Please sign in to comment.