feat(gui): add a button to pause the download in progress

Author: YisusChrist

spankbang_dl/gui/commands.py

@@ -209,6 +209,7 @@ def download_video_and_display_progress(
     gui.progress_bar["value"] = 0
     gui.progress_percent.set("0%")
     # Reset flags
+    gui.pause_download = False
     gui.cancel_download = False
     gui.downloading = True
     # Ensure initial draw
@@ -228,10 +229,16 @@ def update_progress() -> None:
                 # Reset progress bar, label and flags
                 gui.progress_bar["value"] = 0
                 gui.progress_percent.set("0%")
+                gui.pause_download = False  # reset pause flag
                 gui.cancel_download = False  # reset cancel flag
                 gui.downloading = False
                 logger.info("Download cancelled by user.")
                 return
+            elif gui.pause_download:
+                logger.info("Download paused by user.")
+                while gui.pause_download:
+                    time.sleep(0.1)  # Wait until unpaused
+                logger.info("Download resumed by user.")
 
             if not chunk:
                 continue
@@ -310,6 +317,24 @@ def cancel_download(gui: VideoDownloaderUI) -> None:
     gui.log_message(gui.translations["cancelled_message"])
 
 
+def pause_resume_download(gui: VideoDownloaderUI) -> None:
+    """Sets the pause flag to True."""
+    logger.debug("Pause download button clicked")
+    if not gui.downloading:
+        gui.log_message(gui.translations["no_download_message"])
+        logger.warning("No download in progress to pause/resume.")
+        return
+
+    if gui.pause_download:
+        gui.pause_download = False
+        gui.log_message(gui.translations["resumed_message"])
+        logger.info("Download resumed by user.")
+    else:
+        gui.pause_download = True
+        gui.log_message(gui.translations["paused_message"])
+        logger.info("Download paused by user.")
+
+
 def change_language(gui: VideoDownloaderUI, lang_code: str) -> None:
     if gui.current_language == lang_code:
         logger.debug("Language change requested but already set to %s", lang_code)

spankbang_dl/gui/main.py

@@ -28,6 +28,7 @@ class VideoDownloaderUI:
     window_width: int = 1200
 
     cancel_download = False
+    pause_download = False
     downloading = False
 
     def __init__(self, selected_language: str = "en") -> None:
@@ -134,6 +135,15 @@ def __init__(self, selected_language: str = "en") -> None:
         self.start_btn.grid(row=0, column=2, padx=2)
         logger.debug("Download button created")
 
+        self.pause_btn = ttk.Button(
+            self.progress_frame,
+            text="⏸",
+            width=3,
+            command=lambda: commands.pause_resume_download(self),
+        )
+        self.pause_btn.grid(row=0, column=3, padx=2)
+        logger.debug("Pause button created")
+
         self.stop_btn = ttk.Button(
             self.progress_frame,
             text="⏹",

spankbang_dl/strings/strings_en.json

@@ -27,6 +27,8 @@
   "already_downloading_message": "A download is already in progress. Please wait for it to finish or cancel it before starting a new one",
   "no_download_message": "There is no download in progress",
   "cancelled_message": "Download cancelled by user",
+  "paused_message": "Download paused by user",
+  "resumed_message": "Download resumed by user",
   "about_message": "Author: {}\nVersion: {}\nUpdated: {}",
   "help_message": "1. Enter Spankbang video URL\n2. Click Download\n3. Wait for the download to complete",
   "download_video_message": "Downloading video: {}",

spankbang_dl/strings/strings_es.json

@@ -27,6 +27,8 @@
   "already_downloading_message": "Ya hay una descarga en progreso. Por favor, espera a que termine o cancélala antes de iniciar una nueva",
   "no_download_message": "No hay ninguna descarga en progreso",
   "cancelled_message": "Descarga cancelada por el usuario",
+  "paused_message": "Descarga pausada por el usuario",
+  "resumed_message": "Descarga reanudada por el usuario",
   "about_message": "Autor: {}\nVersión: {}\nActualizado: {}",
   "help_message": "1. Introduce la URL del video de Spankbang\n2. Haz clic en Descargar\n3. Espera a que se complete la descarga",
   "download_video_message": "Descargando video: {}",

spankbang_dl/strings/strings_zh.json

@@ -27,6 +27,8 @@
   "already_downloading_message": "已有下载正在进行中，请等待其完成或取消后再开始新的下载",
   "no_download_message": "没有正在进行的下载",
   "cancelled_message": "用户取消了下载",
+  "paused_message": "下载已暂停",
+  "resumed_message": "下载已恢复",
   "about_message": "作者：{}\n版本: {}\n更新时间: {}",
   "help_message": "1. 输入Spankbang视频地址\n2. 点击下载\n3. 等待下载完成",
   "download_video_message": "正在下载视频：{}",