feat: Add title customization for download lists

Introduces the ability to specify a custom title for downloaded files in the list file by adding a special comment.

Enhances user experience by allowing a default title of "Episode" when using numbering without a custom name.

Also refines exception handling for aborting downloads, improving robustness.

Author: MPZ-00

README.md

@@ -87,6 +87,15 @@ Run:
 voe-dl -l links.txt
 ```
 
+### Setting Title in List File
+You can specify a custom title for all files by adding a special comment at the start of your list file:
+```
+#: My Series Title
+https://voe.sx/xxxxxxx
+https://voe.sx/yyyyyyy
+```
+This title will be used when combined with `--numbering` instead of the `--name` argument.
+
 ### Custom File Naming
 Set a custom name for downloaded files:
 ```bash
@@ -99,6 +108,12 @@ voe-dl -l links.txt --name "ShowName" --numbering
 ```
 This creates files like: `ShowName_S01E01.mp4`, `ShowName_S01E02.mp4`, etc.
 
+If you use `--numbering` without `--name`, it defaults to "Episode":
+```bash
+voe-dl -l links.txt --numbering
+```
+Creates: `Episode_S01E01.mp4`, `Episode_S01E02.mp4`, etc.
+
 ### Parallel Downloads
 Set the number of parallel workers (default is 4):
 ```bash

dl.py

@@ -28,6 +28,10 @@
 # Global stop event for handling Ctrl+C across all threads
 _global_stop_event = threading.Event()
 
+class DownloadAbortedException(Exception):
+    """Raised when a download is aborted by user (Ctrl+C)"""
+    pass
+
 def signal_handler(signum, frame):
     """Handle Ctrl+C signal"""
     print("\n[!] Ctrl+C detected - Aborting all downloads...")
@@ -232,6 +236,10 @@ def list_dl(doc, args):
             if not line or line.startswith('#'):
                 continue
             lines.append(line)
+    
+    # If --numbering is used without --name, use "Episode" as default
+    if args.numbering and not title:
+        title = "Episode"
 
     print(f"Downloading {len(lines)} files in parallel with {args.workers} threads...")
     print("[*] Press Ctrl+C to abort all downloads")
@@ -249,7 +257,7 @@ def list_dl(doc, args):
 
             episode = extract_episode_tag(link, i) if args.numbering else None
             filename = generate_custom_filename(title, episode) if title and episode else None
-            thread_args = copy.deepcopy(args)
+            thread_args = copy.copy(args)
             thread_args.name = filename if filename else args.name
             future = executor.submit(download, link, thread_args, _global_stop_event)
             futures.append(future)
@@ -811,7 +819,7 @@ def shift_characters(s: str, offset: int) -> str:
                     # Progress hook to check for abort
                     def progress_hook(d):
                         if stop_event and stop_event.is_set():
-                            raise Exception("Download aborted by user")
+                            raise DownloadAbortedException("Download aborted by user")
 
                     ydl_opts = {
                         'outtmpl': name,
@@ -823,6 +831,9 @@ def progress_hook(d):
                     with YoutubeDL(ydl_opts) as ydl:
                         try:
                             ydl.download([link])
+                        except DownloadAbortedException:
+                            # Re-raise abort exception to be handled by caller
+                            raise
                         except Exception as e:
                             # Check if it was aborted
                             if stop_event and stop_event.is_set():
@@ -860,7 +871,7 @@ def progress_hook(d):
                     # Progress hook to check for abort
                     def progress_hook(d):
                         if stop_event and stop_event.is_set():
-                            raise Exception("Download aborted by user")
+                            raise DownloadAbortedException("Download aborted by user")
 
                     ydl_opts = {
                         'outtmpl': name,
@@ -872,6 +883,9 @@ def progress_hook(d):
                     with YoutubeDL(ydl_opts) as ydl:
                         try:
                             ydl.download([link])
+                        except DownloadAbortedException:
+                            # Re-raise abort exception to be handled by caller
+                            raise
                         except Exception as e:
                             # Check if it was aborted
                             if stop_event and stop_event.is_set():