Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Minimum Number Of Episodes vs Minimum Number Of Played Episodes #21

Closed
terrelsa13 opened this issue Jun 2, 2022 · 0 comments
Closed

Minimum Number Of Episodes vs Minimum Number Of Played Episodes #21

terrelsa13 opened this issue Jun 2, 2022 · 0 comments
Labels
documentation Improvements or additions to documentation

Comments

@terrelsa13
Copy link
Owner

terrelsa13 commented Jun 2, 2022 •
edited
Loading

minimum_number_episodes

Played == Watched
UnPlayed == Unwatched

How To Use

  • Setting minimum_number_episodes=0 will delete all episodes meeting the criteria for deletion
  • Setting minimum_number_episodes=# (between 1 and 730500) will still delete episodes meeting the criteria for deletion
    • Unless the number of remaining episodes is less than the minimum_number_episodes=#
    • When this happens one or more of the watched episodes are removed from the deletion list until the number of remaining episodes is equal to minimum_number_episodes=#
    • The season# and episode# are used to determine which episodes on the deletion list are removed first
      • Episodes are removed according to the lowest sequential season#
      • This means season#2/episode#5 will be removed before season#6/episode#1
  • This feature applies to all users and is not configurable per user
    • See minimum_number_episodes_behavior for ways to modify how minimum_number_episodes behaves
  • Played and Unplayed states are ignored
  • Favorited, whitetagged, or whitelisted episodes can be considered the same as unwatched episodes for the below examples

Fully Watched Series Example#1:

minimum_number_episodes=0 (disabled)

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Watched
      • Episode5 - Watched

-All episodes will be deleted.

Fully Watched Series Example#2:

minimum_number_episodes=1

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Watched
      • Episode5 - Watched

-Season2/Episode5 will not be deleted to meet minimum_number_episodes=1.
-All other episodes will be deleted.

Partially Watched Series Example#1:

minimum_number_episodes=0 (disabled)

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Unwatched
      • Episode5 - Unwatched

-Season2/Episode4-5 will not be deleted; because they are unwatched.
-All other episodes will be deleted.

Partially Watched Series Example#2:

minimum_number_episodes=2

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Watched
      • Episode5 - Unwatched

-Season2/Episode5 will not be deleted; because it is unwatched.
-Season2/Episode4 will not be deleted to meet minimum_number_episodes=2
-All other episodes will be deleted.

Partially Watched Series Example#3:

minimum_number_episodes=2

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Unwatched
      • Episode4 - Unwatched
      • Episode5 - Unwatched

-Season2/Episode3-5 will not be deleted; because they are unwatched.
-minimum_number_episodes=2 meet with unwatched episodes.
-All other episodes will be deleted.

Partially Watched Series Example#4:

minimum_number_episodes=6

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Unwatched
      • Episode14 - Watched
      • Episode15 -Unwatched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Unwatched
      • Episode5 - Watched

-Season1/Episode13, Season1/Epsiode15, and Season2/Episode4 will not be deleted; because they are unwatched.
-Season2/Episode2-3 and Season2/Episode5 will not be deleted to meet minimum_number_episodes=6
-All other episodes will be deleted.

minimum_number_played_episodes

Played == Watched
UnPlayed == Unwatched

How To Use

  • Setting minimum_number_played_episodes=0 will delete all episodes meeting the criteria for deletion
  • Setting minimum_number_played_episodes=# (between 1 and 730500) will still delete episodes meeting the criteria for deletion
    • Unless the number of remaining played episodes is less than or equal to the minimum_number_played_episodes=#
    • When this happens one or more of the watched episodes are removed from the deletion list until the number of remaining episodes is equal to minimum_number_episodes=#
    • The season# and episode# are used to determine which episodes on the deletion list are removed first
      • Episodes are removed according to the lowest sequential season#
      • This means season#2/episode#5 will be removed before season#6/episode#1
  • This feature applies to all users and is not configurable per user
    • See minimum_number_episodes_behavior for ways to modify how minimum_number_played_episodes behaves
  • Only applies to played episodes
  • Favorited, whitetagged, or whitelisted episodes can be considered the same as unwatched episodes for the below examples

Fully Watched Series Example#1:

minimum_number_played_episodes=0 (disabled)

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Watched
      • Episode5 - Watched

-All episodes will be deleted.

Fully Watched Series Example#2:

minimum_number_played_episodes=1

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Watched
      • Episode5 - Watched

-Season2/Episode5 will not be deleted to meet minimum_number_played_episodes=1.
-All other episodes will be deleted.

Partially Watched Series Example#1:

minimum_number_played_episodes=0 (disabled)

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Unwatched
      • Episode5 - Unwatched

-Season2/Episode4-5 will not be deleted; because they are unwatched.
-All other episodes will be deleted.

Partially Watched Series Example#2:

minimum_number_played_episodes=2

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Watched
      • Episode5 - Unwatched

-Season2/Episode5 will not be deleted; because it is unwatched.
-Season2/Episode3-4 will not be deleted to meet minimum_number_played_episodes=2
-All other episodes will be deleted.

Partially Watched Series Example#3:

minimum_number_played_episodes=2

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Watched
      • Episode14 - Watched
      • Episode15 - Watched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Unwatched
      • Episode4 - Unwatched
      • Episode5 - Unwatched

-Season2/Episode3-5 will not be deleted; because they are unwatched.
-Season2/Episode1-2 will not be deleted to meet minimum_number_played_episodes=2
-All other episodes will be deleted.

Partially Watched Series Example#4:

minimum_number_played_episodes=6

  • TVShow0
    • Season1
      • Episode11 - Watched
      • Episode12 - Watched
      • Episode13 - Unwatched
      • Episode14 - Watched
      • Episode15 -Unwatched
    • Season2
      • Episode1 - Watched
      • Episode2 - Watched
      • Episode3 - Watched
      • Episode4 - Unwatched
      • Episode5 - Watched

-Season1/Episode13, Season1/Epsiode15, and Season2/Episode4 will not be deleted; because they are unwatched.
-Season1/Episode12, Season1/Episode14, Season2/Episode1-3 and Season2/Episode5 will not be deleted to meet minimum_number_played_episodes=6
-Season1/Episode11 will be deleted.

  • minimum_number_episodes and minimum_number_played_episodes can be used together.
  • If minimum_number_episodes is greater than zero and less than minimum_number_played_episodes the script will internally set minimum_number_episodes equal to minimum_number_played_episodes.
    • It is not possible to have less played and unplayed episodes combined than just played episodes on their own
@terrelsa13 terrelsa13 mentioned this issue Jun 3, 2022
Closed
@terrelsa13 terrelsa13 changed the title Minimum Number Of Episodes Minimum Number Of Episodes vs Minimum Number Of Played Episodes Jul 22, 2022
@terrelsa13 terrelsa13 added the documentation Improvements or additions to documentation label Oct 9, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
documentation Improvements or additions to documentation
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@terrelsa13