feat: add bulk completion date setting #802

Add user preference to control what date is used when marking seasons
or TV shows as completed. Options: Current Date (default), Release Date,
or No Date. Useful for adding historical media without affecting statistics.

Author: FuzzyGrim

src/app/models.py

@@ -1414,6 +1414,8 @@ def get_remaining_eps(self, season_metadata):
             latest_watched_ep_num = 0
 
         episodes_to_create = []
+
+        # Calculate current time once before the loop
         now = timezone.now().replace(second=0, microsecond=0)
 
         # Create Episode objects for the remaining episodes
@@ -1423,10 +1425,13 @@ def get_remaining_eps(self, season_metadata):
 
             item = self.get_episode_item(episode["episode_number"], season_metadata)
 
+            # Resolve end_date based on user preference
+            end_date = self.user.resolve_watch_date(now, episode.get("air_date"))
+
             episode_db = Episode(
                 related_season=self,
                 item=item,
-                end_date=now,
+                end_date=end_date,
             )
             episodes_to_create.append(episode_db)
 

src/static/css/main.css

@@ -795,6 +795,9 @@
   .flex-1 {
     flex: 1;
   }
+  .flex-shrink-0 {
+    flex-shrink: 0;
+  }
   .shrink-0 {
     flex-shrink: 0;
   }
@@ -2279,6 +2282,16 @@
       --tw-ring-color: var(--color-indigo-200);
     }
   }
+  .focus\:ring-indigo-300 {
+    &:focus {
+      --tw-ring-color: var(--color-indigo-300);
+    }
+  }
+  .focus\:ring-indigo-400 {
+    &:focus {
+      --tw-ring-color: var(--color-indigo-400);
+    }
+  }
   .focus\:ring-indigo-500 {
     &:focus {
       --tw-ring-color: var(--color-indigo-500);

src/templates/users/ui_preferences.html

@@ -40,6 +40,28 @@ <h2 class="text-xl font-semibold">UI Preferences</h2>
         </div>
       </div>
 
+      {# Quick Watch Date #}
+      <div class="mb-5">
+        <div class="flex items-center justify-between p-3 bg-[#39404b] rounded-md">
+          <div class="flex-1">
+            <div class="flex items-center text-gray-200 mb-1">
+              {% include "app/icons/clock.svg" with classes="w-5 h-5 mr-2" %}
+              <span class="text-sm font-medium">Bulk Completion Date</span>
+            </div>
+            <p class="text-xs text-gray-400 ml-7">
+              When marking a TV show or season as completed, its episodes will be marked as completed with this date.
+            </p>
+          </div>
+          <select name="quick_watch_date"
+                  class="ml-4 p-2 bg-[#39404b] rounded-md text-white text-sm border border-gray-600 focus:outline-none focus:ring-2 focus:ring-indigo-400">
+            {% for choice in quick_watch_date_choices %}
+              <option value="{{ choice.0 }}"
+                      {% if user.quick_watch_date == choice.0 %}selected{% endif %}>{{ choice.1 }}</option>
+            {% endfor %}
+          </select>
+        </div>
+      </div>
+
       <div class="border-t border-gray-600 my-5"></div>
 
       {# Media Types Settings #}

src/users/migrations/0041_add_quick_watch_date.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.9 on 2026-01-17 16:11
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('app', '0052_alter_item_title'),
+        ('auth', '0012_alter_user_first_name_max_length'),
+        ('users', '0040_user_list_detail_status'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='user',
+            name='quick_watch_date',
+            field=models.CharField(choices=[('current_date', 'Current Date'), ('release_date', 'Release Date'), ('no_date', 'No Date')], default='current_date', help_text='Date to use when bulk-marking media as completed', max_length=20),
+        ),
+        migrations.AddConstraint(
+            model_name='user',
+            constraint=models.CheckConstraint(condition=models.Q(('quick_watch_date__in', ['current_date', 'release_date', 'no_date'])), name='quick_watch_date_valid'),
+        ),
+    ]

src/users/models.py

@@ -82,6 +82,14 @@ class ListDetailSortChoices(models.TextChoices):
     MEDIA_TYPE = "media_type", "Media Type"
 
 
+class QuickWatchDateChoices(models.TextChoices):
+    """Choices for quick watch date behavior when bulk-marking media as completed."""
+
+    CURRENT_DATE = "current_date", "Current Date"
+    RELEASE_DATE = "release_date", "Release Date"
+    NO_DATE = "no_date", "No Date"
+
+
 class User(AbstractUser):
     """Custom user model."""
 
@@ -249,6 +257,13 @@ class User(AbstractUser):
         help_text="Hide hover overlay on touch devices",
     )
 
+    # Tracking settings
+    quick_watch_date = models.CharField(
+        max_length=20,
+        default=QuickWatchDateChoices.CURRENT_DATE,
+        choices=QuickWatchDateChoices.choices,
+        help_text="Date to use when bulk-marking media as completed",
+    )
     # Calendar preferences
     calendar_layout = models.CharField(
         max_length=20,
@@ -418,6 +433,10 @@ class Meta:
                 name="book_status_valid",
                 condition=models.Q(book_status__in=MediaStatusChoices.values),
             ),
+            models.CheckConstraint(
+                name="quick_watch_date_valid",
+                condition=models.Q(quick_watch_date__in=QuickWatchDateChoices.values),
+            ),
         ]
 
     def update_preference(self, field_name, new_value):
@@ -459,6 +478,26 @@ def update_preference(self, field_name, new_value):
 
         return new_value
 
+    def resolve_watch_date(self, now, release_date):
+        """
+        Resolve the appropriate watch date based on user preference.
+
+        Args:
+            now: Pre-calculated current datetime
+            release_date: The release/air date for the specific media item
+
+        Returns:
+            datetime or None based on user preference
+        """
+        if self.quick_watch_date == QuickWatchDateChoices.NO_DATE:
+            return None
+
+        if self.quick_watch_date == QuickWatchDateChoices.RELEASE_DATE:
+            return release_date  # Will be None if not available in metadata
+
+        # CURRENT_DATE is the default
+        return now
+
     def get_enabled_media_types(self):
         """Return a list of enabled media type values based on user preferences."""
         enabled_types = []