ytdl-sub 2025.11.9__py3-none-any.whl → 2025.11.18__py3-none-any.whl

ytdl_sub/__init__.py

@@ -1 +1 @@
-__pypi_version__ = "2025.11.09";__local_version__ = "2025.11.09+a74c79d"
+__pypi_version__ = "2025.11.18";__local_version__ = "2025.11.18+63753c5"

ytdl_sub/config/preset_options.py

@@ -107,6 +107,7 @@ class OutputOptions(OptionsDictValidator):
         "keep_max_files",
         "download_archive_standardized_date",
         "keep_files_date_eval",
+        "preserve_mtime",
     }
 
     @classmethod
@@ -170,6 +171,10 @@ class OutputOptions(OptionsDictValidator):
             default=f"{{{v.upload_date_standardized.variable_name}}}",
         )
 
+        self._preserve_mtime = self._validate_key_if_present(
+            key="preserve_mtime", validator=BoolValidator, default=False
+        )
+
         if (
             self._keep_files_before or self._keep_files_after or self._keep_max_files
         ) and not self.maintain_download_archive:
@@ -309,6 +314,17 @@ class OutputOptions(OptionsDictValidator):
         """
         return self._keep_max_files
 
+    @property
+    def preserve_mtime(self) -> bool:
+        """
+        :expected type: Optional[Boolean]
+        :description:
+          Preserve the video's original upload time as the file modification time.
+          When True, sets the file's mtime to match the video's upload_date from
+          yt-dlp metadata. Defaults to False.
+        """
+        return self._preserve_mtime.value
+
     def added_variables(self, unresolved_variables: Set[str]) -> Dict[PluginOperation, Set[str]]:
         return {
             # PluginOperation.MODIFY_ENTRY_METADATA: {

ytdl_sub/subscriptions/subscription_download.py

@@ -73,6 +73,7 @@ class SubscriptionDownload(BaseSubscription, ABC):
             file_metadata=entry_metadata,
             output_file_name=output_file_name,
             entry=entry,
+            preserve_mtime=self.output_options.preserve_mtime,
         )
 
         # Always pretend to include the thumbnail in a dry-run
@@ -87,6 +88,7 @@ class SubscriptionDownload(BaseSubscription, ABC):
                 output_file_name=output_thumbnail_name,
                 entry=entry,
                 copy_file=True,
+                preserve_mtime=self.output_options.preserve_mtime,
             )
         elif not entry.is_thumbnail_downloaded():
             logger.warning(
@@ -106,6 +108,7 @@ class SubscriptionDownload(BaseSubscription, ABC):
                 file_name=entry.get_download_info_json_name(),
                 output_file_name=output_info_json_name,
                 entry=entry,
+                preserve_mtime=self.output_options.preserve_mtime,
             )
 
     def _delete_working_directory(self, is_error: bool = False) -> None:

ytdl_sub/utils/file_handler.py

@@ -430,6 +430,25 @@ class FileHandler:
         if os.path.isfile(file_path):
             os.remove(file_path)
 
+    @classmethod
+    def set_mtime(cls, file_path: Union[str, Path], mtime: float):
+        """
+        Set the modification time of a file
+
+        Parameters
+        ----------
+        file_path
+            Path to the file to modify
+        mtime
+            Modification time as a Unix timestamp
+        """
+        try:
+            # Set both access time and modification time
+            os.utime(file_path, (mtime, mtime))
+        except OSError:
+            # If file operation fails, silently continue
+            pass
+
     def move_file_to_output_directory(
         self,
         file_name: str,

ytdl_sub/ytdl_additions/enhanced_download_archive.py

@@ -1,6 +1,7 @@
 import copy
 import json
 import os.path
+import time
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
@@ -642,6 +643,7 @@ class EnhancedDownloadArchive:
         output_file_name: Optional[str] = None,
         entry: Optional[Entry] = None,
         copy_file: bool = False,
+        preserve_mtime: bool = False,
     ):
         """
         Saves a file from the working directory to the output directory and record it in the
@@ -660,6 +662,8 @@ class EnhancedDownloadArchive:
             Optional. Entry that this file belongs to
         copy_file
             Optional. If True, copy the file. Move otherwise
+        preserve_mtime
+            Optional. If True and entry has upload_date, set file mtime to upload date
         """
         if output_file_name is None:
             output_file_name = file_name
@@ -674,6 +678,22 @@ class EnhancedDownloadArchive:
             copy_file=copy_file,
         )
 
+        # Set mtime if preserve_mtime is enabled and we have an entry with upload_date
+        if preserve_mtime and entry and not self._file_handler.dry_run:
+            upload_date = entry.get(v.ytdl_sub_keep_files_date_eval, str)
+            if upload_date:
+                try:
+                    # Convert YYYY-mm-dd to timestamp
+                    upload_datetime = datetime.strptime(upload_date, "%Y-%m-%d")
+                    upload_timestamp = time.mktime(upload_datetime.timetuple())
+
+                    # Set mtime on the output file
+                    output_file_path = Path(self._file_handler.output_directory) / output_file_name
+                    FileHandler.set_mtime(output_file_path, upload_timestamp)
+                except (ValueError, OSError):
+                    # If date parsing or file operation fails, silently continue
+                    pass
+
         # Determine if it's the entry file by seeing if the file_name to move matches the entry
         # download file name
         is_entry_file = entry and entry.get_download_file_name() == file_name

{ytdl_sub-2025.11.9.dist-info → ytdl_sub-2025.11.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ytdl-sub
-Version: 2025.11.9
+Version: 2025.11.18
 Summary: Automate downloading metadata generation with YoutubeDL
 Author: Jesse Bannon
 License:                     GNU GENERAL PUBLIC LICENSE
@@ -689,7 +689,7 @@ Classifier: Programming Language :: Python :: 3.11
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: yt-dlp[default]==2025.10.22
+Requires-Dist: yt-dlp[default]==2025.11.12
 Requires-Dist: colorama~=0.4
 Requires-Dist: mergedeep~=1.3
 Requires-Dist: mediafile~=0.12

{ytdl_sub-2025.11.9.dist-info → ytdl_sub-2025.11.18.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ytdl_sub/__init__.py,sha256=h08aGMLqMxi_5sfLIGAtrh-Ccb360S0JDA2kcIR5j9o,73
+ytdl_sub/__init__.py,sha256=HSa2j0j6xbqM0rcdsgrBPin_Y-dT44vCiR2vfwu33ts,73
 ytdl_sub/main.py,sha256=4Rf9wXxSKW7IPnWqG5YtTZ814PjP1n9WtoFDivaainE,1004
 ytdl_sub/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/cli/entrypoint.py,sha256=XXjUH4HiOP_BB2ZA_bNcyt5-o6YLAdZmj0EP3xtOtD8,9496
@@ -14,7 +14,7 @@ ytdl_sub/config/config_validator.py,sha256=NWPoCb6qjOom-YQamjho4UAIMSC43LRIT28W0
 ytdl_sub/config/defaults.py,sha256=NTwzlKDkks1LDGNjFMxh91fw5E6T6d_zGsCwODNYJxo,1152
 ytdl_sub/config/overrides.py,sha256=WjfKnT8z5dth4uqMC53KrVzitGAPbKGaNN_25C35dUM,8704
 ytdl_sub/config/preset.py,sha256=cp_oCyR78pHqYIakUNvNnwuFfFUq1YzitvIav5QW3Jw,8517
-ytdl_sub/config/preset_options.py,sha256=NkkM2m0XCKyYYfe8Vh393AHH9pkvLbkYOmgRNt7G3X8,12958
+ytdl_sub/config/preset_options.py,sha256=RgwnpIQqe_17YiaqaI-qlQ12RnkVGTdawXR_e6gYhuQ,13523
 ytdl_sub/config/plugin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/config/plugin/plugin.py,sha256=ugUyDnjLKcBy7lOpTbVKaGSuUMvzyyQx3DIcbv3eTkQ,4721
 ytdl_sub/config/plugin/plugin_mapping.py,sha256=xx9K2EReIU7zdPlogjvIkowy8J2R4TEhMNJyR7_1aE0,7846
@@ -123,7 +123,7 @@ ytdl_sub/script/utils/type_checking.py,sha256=9EKWE1mWPOlmXWiWTZw-bCRV0FlYk22tNK
 ytdl_sub/subscriptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ytdl_sub/subscriptions/base_subscription.py,sha256=-zq4WgpsOq493fEHal8XmC6mLQiA3tvaeuFRyRW_7Es,6803
 ytdl_sub/subscriptions/subscription.py,sha256=wfzOYVkzmsSH1KYbAMRi6Nhrb2pRaXdhILle7H0hcas,5127
-ytdl_sub/subscriptions/subscription_download.py,sha256=3izO1FENzUTOKALfoSA3C75ro7qOvU9RMhaNpjMVowg,17993
+ytdl_sub/subscriptions/subscription_download.py,sha256=-eLbClw88tleLdUgP7TtPtnqroE3Zzdx2XLQrgapMDc,18190
 ytdl_sub/subscriptions/subscription_validators.py,sha256=tSN8YPLkIYXQbmWQ3M6U7xHpNjPn8rtNR9wSLIE2kzM,13606
 ytdl_sub/subscriptions/subscription_ytdl_options.py,sha256=tD_HhV3Z90YeRj27zrv8W_iQfzqKvWWLnIkJW7Wy9L4,7562
 ytdl_sub/thread/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -133,7 +133,7 @@ ytdl_sub/utils/chapters.py,sha256=zLNndxmVdNg3LKV7HeNEImC3rWlpsoBPkZ1-TFQBD0Q,87
 ytdl_sub/utils/datetime.py,sha256=M9OTwGDlPWlu4E637P34Tc_23c-MtEUTiiU9eVI5pKQ,1100
 ytdl_sub/utils/exceptions.py,sha256=mu6F5eneFo-oEIcmjEJV4aCK2pc7vKucBtmMz91HN68,1219
 ytdl_sub/utils/ffmpeg.py,sha256=1av8AEvVraIXROk9Q__UWVFNLvXGKJZnFTufnLnPfR8,6513
-ytdl_sub/utils/file_handler.py,sha256=PauqYEk5SeRRj0d9Q0Ojp-Mq9r-BkazKeAXBERHVKs0,16730
+ytdl_sub/utils/file_handler.py,sha256=chP9i2Cf14vV9FHTIN2YqmAJF_yxV1jDZzDeVsJ8PWE,17259
 ytdl_sub/utils/file_lock.py,sha256=VlDl8QjBEUAHDBHsfp7Q0tR1Me0fFYELqzMtlyZ0MO4,2790
 ytdl_sub/utils/file_path.py,sha256=7RWc4fGj7HH6srzGJ5ph1l5euJfWpIX-2cyC-03YXEs,2539
 ytdl_sub/utils/logger.py,sha256=g_23ddk1WpQ3-_MOHz-Rlz7xCydK66BbtqkualX1zAQ,8593
@@ -157,10 +157,10 @@ ytdl_sub/validators/string_formatter_validators.py,sha256=D7wuYFuHlbOYMCkKoy9ILL
 ytdl_sub/validators/string_select_validator.py,sha256=KFXNKWX2J80WGt08m5gVYphPMHYxhHlgfcoXAQMq6zw,1086
 ytdl_sub/validators/validators.py,sha256=X9AkECdngEXcME_C25njHaOjtqbfEJMED2eG9Qy3UPs,9352
 ytdl_sub/ytdl_additions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ytdl_sub/ytdl_additions/enhanced_download_archive.py,sha256=3skvdZb42TfYmdfm3AebzuT3mr154NmkduaCXx-HlzE,23844
-ytdl_sub-2025.11.9.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-ytdl_sub-2025.11.9.dist-info/METADATA,sha256=-QuFvwf-N2Z94JXEp0pU51Lbf4JlPmVYwsMNeK6mQoI,51420
-ytdl_sub-2025.11.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ytdl_sub-2025.11.9.dist-info/entry_points.txt,sha256=K3T5235NlAI-WLmHCg5tzLZHqc33OLN5IY5fOGc9t10,48
-ytdl_sub-2025.11.9.dist-info/top_level.txt,sha256=6z-JWazl6jXspC2DNyxOnGnEqYyGzVbgcBDoXfbkUhI,9
-ytdl_sub-2025.11.9.dist-info/RECORD,,
+ytdl_sub/ytdl_additions/enhanced_download_archive.py,sha256=Lsc0wjHdx9d8dYJCskZYAUGDAQ_QzQ-_xbQlyrBSzfk,24884
+ytdl_sub-2025.11.18.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+ytdl_sub-2025.11.18.dist-info/METADATA,sha256=-7ZJ-IKg_JuI-D8QCm7Sgkh41qUhg1wleTqaLR1PMYc,51421
+ytdl_sub-2025.11.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ytdl_sub-2025.11.18.dist-info/entry_points.txt,sha256=K3T5235NlAI-WLmHCg5tzLZHqc33OLN5IY5fOGc9t10,48
+ytdl_sub-2025.11.18.dist-info/top_level.txt,sha256=6z-JWazl6jXspC2DNyxOnGnEqYyGzVbgcBDoXfbkUhI,9
+ytdl_sub-2025.11.18.dist-info/RECORD,,